Skip to main content

​
Payout Status Notification

We will show the flow of payments for payout, regarding the status.
Payments (payout) in final statuses: PAID, CANCELED, REJECTED, INVALID_DATA can no longer be updated.

​
Payout PIX and TED

​
Possible payment (payout) status

STATUS_CODESTATUSEXPLANATION
7AwaitingThe first status: if you stay in this status for more than 1 minute, it means that no balance in your account to make the payment.
1ReceivedPayment received and stored in our database.
2ProcessingPayment sent for processing.
5InreviewPayment sent to our team for review.
8ProcessedPayments sent for processing and waiting confirmation from processor.
3PaidPayment made with success.
4RejectedPayment rejected by the bank (only TED).
6CanceledPayment canceled by Merchant (TED or PIX) or Payment rejected by the bank (Only PIX).
11Invalid_data_inputData provided invalid or insufficient (only available under client request).
You can check the reasons why our compliance team will reject a payment in our article Rejection reasons payout.

​
Status Details

Initial StatusThe first status when a payout is created. If the payment stays in this status for more than 1 minute, it means there is no balance in your account to make the payment.Action: Check your wallet balance using Get Balance.Next possible statuses: Received, Canceled
Payment AcceptedPayment received and stored in our database. The balance and compliance checks have been completed, and the payment is ready to be processed.Next possible statuses: Processing, In Review
Being ProcessedPayment sent for processing. The bank is processing the payment.Next possible statuses: Processed
Compliance ReviewPayment sent to our compliance team for review. This happens when additional verification is required.Action: Wait for compliance team review. This may take some time depending on the case.Next possible statuses: Processed, Rejected, Canceled
Sent to BankPayments sent for processing and waiting confirmation from processor. The bank has processed the payment and is confirming the transaction.Next possible statuses: Paid, Rejected
Final Status - SuccessPayment made with success. The bank has confirmed the payment and funds have been transferred to the recipient.This is the final success status:
  • Funds have been transferred
  • Webhook notification is sent
  • Transaction is complete
Action: No further action needed. Payment completed successfully.
Final Status - Bank RejectionPayment rejected by the bank (only TED). This happens when the bank refuses to process the payment due to internal rules or invalid account information.Common reasons:
  • Invalid bank account details
  • Account closed or blocked
  • Bank internal policies
Action: Review recipient information and create a new payment with corrected details.
Final Status - CanceledPayment canceled by Merchant (TED or PIX) or Payment rejected by the bank (Only PIX).Reasons:
  • Manual cancellation by merchant
  • PIX payment rejected by bank
  • Compliance rejection
Action: Check cancellation reason. If needed, create a new payment with corrected information.
Final Status - Invalid DataData provided invalid or insufficient (only available under client request).Action: Review all payment data and ensure all required fields are correctly filled. Create a new payment with valid data.

​
Webhook Notifications

Webhooks are sent only for final statuses: Paid, Rejected, Canceled

​
When to Expect Webhooks

  • PIX
  • TED
Fast NotificationsPIX webhooks are sent shortly after payment completion:
  • Paid: Within seconds to minutes after bank confirmation
  • Rejected: Immediately if rejected by bank
  • Canceled: Immediately after cancellation
{
  "id": 54321,
  "invoice": "PAYOUT-001",
  "status": {
    "id": 3,
    "name": "Paid"
  },
  "updated_at": "2024-06-13T10:05:00.000000Z"
}

​
Status Monitoring

1

Create Payment

Use Create Payment to initiate a payout.Initial status: Awaiting (7)
2

Payment Accepted

System validates balance and compliance.Status changes to: Received (1)
3

Processing

Payment is sent to the bank for processing.Status changes to: Processing (2) → Processed (8)
4

Receive Webhook

Webhook notification is sent with final status.Final status: Paid (3), Rejected (4), or Canceled (6)

​
Status Flow Diagram

​
PIX Payment Flow

Awaiting (7) → Received (1) → Processing (2) → Processed (8) → Paid (3) ✓
                                                              → Rejected/Canceled (6) ✗

​
TED Payment Flow

Awaiting (7) → Received (1) → Processing (2) → Processed (8) → Paid (3) ✓
                                                              → Rejected (4) ✗

​
With Compliance Review

Awaiting (7) → Received (1) → In Review (5) → Processing (2) → Processed (8) → Paid (3) ✓
                                                                              → Rejected/Canceled (6) ✗

Create Payment

Create PIX or TED payments

Get Payment

Check payment status

Callback Payment

Configure webhook notifications

Rejection Reasons

Understand rejection codes

About Payments

Learn about payment types

Get Balance

Check wallet balance

​
Additional Notes

For more information about webhook configuration and signature validation, check our article Webhook Signature.
Payments in Awaiting status for more than 1 minute indicate insufficient balance. Always check balance before creating payments.
Use the In Review status to inform users that their payment is under compliance review and may take additional time to process.