Possible Status

• done
• failed
• totally_refunded
• partially_refunded

Idempotency-Key

The Idempotency-Key is a required header for ensuring the idempotency of API requests. It allows clients to safely retry a request without accidentally performing the same operation multiple times. This is especially critical for operations like payment processing, payouts, or other actions that should not be executed more than once.

Key Points:

• Required: Every idempotent API request must include the Idempotency-Key header.
• Uniqueness: The key must be unique for each distinct operation. For example, a new key should be generated for every new payout request.
• Format: The key should be a unique string, typically a UUID (e.g., 123e4567-e89b-12d3-a456-426614174000). You can use the same value used in reference_code.
• Lifetime: The key's validity is tied to the server's caching mechanism. Use the same key for retries of the same operation within the expiration window, which is 1 hour.

Client request timeout

We recommend setting a generous timeout for your client requests, as the PIX network can experience latency during peak hours. A timeout of 30 seconds is a good starting point, but you may need to adjust it based on your specific needs.