Sandbox

The sandbox environment allows you to test your integration with the Payouts API. It simulates API requests and transaction types, so you can validate your implementation before going live.

Sandbox base URL

Sandbox transactions are simulated and not actually processed.

Simulate payout statuses in sandbox

In Sandbox, you can control the payout result by passing a status code in the request body's description field.

• Input. Set the desired mock scenario using the description field in your payout request.
• Output. The mock server responds with the mapped status, status_code, and status_detail.

Example

• Successful payout. If you provide description: DELIVERED:PAID in the request, you'll subsequently receive a notification with status: PAID, status_code: 200, and status_detail: The payout was paid.
• Fail payout. If you provide description: DELIVERED:5011, you'll subsequently receive a notification with status: BAD_REQUEST, status_code: 5011, and status_detail: External ID already used.

{
  "external_id": "your_external_id",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "B2C",
  "country": "BR",
  "currency": "BRL",
  "purpose": "DIGITAL_GOODS",
  "amount": 129.19,
  "notification_url": "https://yoururl.com/notification",
  "beneficiary": {
    "first_name": "John",
    "last_name": "Doe",
    "document": {
      "id": "39446691001"
    },
    "instant_payment": {
      "id": "39446691001"
    }
  },
  "description": "DELIVERED:3001"
}

Sample description values to simulate card responses

Production

After successful testing, you can switch to the production environment.

Production base URL