Skip to main content

​
Documents for Testing

The result of the payout payment is linked to the beneficiary’s document. Use the documents below to test different payment scenarios in the sandbox environment.

​
PIX Key Payment

For payments using PIX key, use one of the following CPF documents to ensure the payment is approved:
Document (CPF)StatusDescription
00741212439PaidPayment approved successfully
59730932395PaidPayment approved successfully
78592315492PaidPayment approved successfully

​
Example - PIX Key Payment

{
  "payment_method": "PIX",
  "currency": "BRL",
  "country": "BR",
  "amount": 50.00,
  "invoice": "unique-invoice-id",
  "beneficiary": {
    "name": "João Silva",
    "document": {
      "type": "CPF",
      "number": "00741212439"
    }
  },
  "pix": {
    "pix_key": "00741212439"
  }
}

​
Bank Account Payment

For payments using bank account details, use one of the following CPF documents to ensure the payment is approved:
Document (CPF)StatusDescription
00741212439PaidPayment approved successfully
59730932395PaidPayment approved successfully
78592315492PaidPayment approved successfully
78493353094PaidPayment approved successfully

​
Example - Bank Account Payment

{
  "payment_method": "PIX",
  "currency": "BRL",
  "country": "BR",
  "amount": 100.00,
  "invoice": "unique-invoice-id",
  "beneficiary": {
    "name": "Maria Santos",
    "document": {
      "type": "CPF",
      "number": "59730932395"
    }
  },
  "pix": {
    "ispb": "18236120",
    "bank_branch": "0496",
    "account": "51659",
    "account_digit": "7",
    "account_type": "CHECKING"
  }
}

​
Testing Flow

1

Choose payment method

Decide whether to test PIX key or bank account payment
2

Select test document

Choose one of the approved CPF documents from the tables above
3

Create payment

Use the Create Payment endpoint with the test document
4

Monitor status

Check the payment status using webhooks or the Get Payment endpoint
5

Verify completion

Confirm the payment reaches Paid status (status_id: 3)

​
Best Practices

Sandbox Environment: Always use test documents in the sandbox environment. These documents are specifically configured for testing purposes.
Unique Invoice: Always use a unique invoice ID for each payment to avoid duplicates and ensure proper tracking.

​
Common Test Scenarios

Document: 00741212439Payment Method: PIX KeyExpected Result: Payment approved and completed
{
  "payment_method": "PIX",
  "currency": "BRL",
  "country": "BR",
  "amount": 43.34,
  "invoice": "test-pix-key-001",
  "beneficiary": {
    "name": "João Silva",
    "document": {
      "type": "CPF",
      "number": "00741212439"
    }
  },
  "pix": {
    "pix_key": "00741212439"
  }
}
Document: 59730932395Payment Method: Bank Account DetailsExpected Result: Payment approved and completed
{
  "payment_method": "PIX",
  "currency": "BRL",
  "country": "BR",
  "amount": 150.00,
  "invoice": "test-bank-account-001",
  "beneficiary": {
    "name": "Maria Santos",
    "document": {
      "type": "CPF",
      "number": "59730932395"
    }
  },
  "pix": {
    "ispb": "18236120",
    "bank_branch": "0496",
    "account": "51659",
    "account_digit": "7",
    "account_type": "CHECKING"
  }
}

​
Payment Status Flow

After creating a payment with a test document, the payment will go through the following statuses:
1

Awaiting (7)

Initial status - Payment created and awaiting processing
2

Received (1)

Payment received and stored in the system
3

Processing (2)

Payment sent for processing
4

Processed (8)

Payment processed and waiting confirmation
5

Paid (3)

Payment completed successfully ✓

​
Important Notes

PIX Key Documents

3 approved documentsUse these CPF numbers as PIX keys for successful payments

Bank Account Documents

4 approved documentsUse these CPF numbers with any valid bank account details
Production Environment: Never use these test documents in production. They are only valid in the sandbox environment.

Create Payment

Create a new payout payment

Payment Status

Understanding payment status flow

Rejection Reasons

Common rejection reasons and solutions

About Payments

Learn about payout payments