List or search PIX Out payment intents

Lists all outbound PIX payment intents for a given account. Optionally, search for a specific payment by paymentId, identifier, or endToEndId (only one at a time). Returns payment history including status, recipient info, and reconciliation data.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequiredformat: "uuid"
Account ID.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Query parameters

paymentIdstringOptional

Search by payment ID (returns single payment).

identifierstringOptional

Search by integrator-provided identifier (returns single payment).

endToEndIdstringOptional

Search by E2E ID from BACEN (returns single payment).

statusenumOptional

Filter by payment status (list mode only). Canonical PIX statuses; a refunded/returned payment is REVERSED (there is no SUCCESS/REFUNDED/CANCELLED).

Response

List of payments.
paymentslist of objectsOptional
totalintegerOptional
Total number of payments.

Errors

400
Bad Request Error
500
Internal Server Error