Skip to main content
POST
Process a Pix Transfer

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Headers

X-Account-Id
string

Account ID (UUID format)

X-Purpose
string

Transaction purpose (TRANSFER, INSTANT_PAYMENT_REFUND, WITHDRAWAL for a Pix Saque charge, CHANGE for a Pix Troco charge). Defaults to TRANSFER.

Body

application/octet-stream

The body is of type file.

Response

Created

accountId
string
required
Example:

"01989f9e-6508-79f8-9540-835be49fbd0d"

amount
string
required
Example:

"100.50"

createdAt
string
required
Example:

"2024-01-15T10:30:15Z"

endToEndId
string
required
Example:

"E1234567820240101000001234567890"

id
string
required
Example:

"550e8400-e29b-41d4-a716-446655440010"

initiationType
enum<string>
required
Available options:
MANUAL,
KEY,
QR_CODE
Example:

"KEY"

paymentType
enum<string>
required
Available options:
IMMEDIATE,
SCHEDULED
Example:

"IMMEDIATE"

purpose
enum<string>
required
Available options:
TRANSFER,
INSTANT_PAYMENT_REFUND,
CHANGE,
WITHDRAWAL
Example:

"TRANSFER"

status
enum<string>
required
Available options:
CREATED,
PENDING,
PROCESSING,
COMPLETED,
FAILED,
REVERSED
Example:

"COMPLETED"

type
enum<string>
required
Available options:
CASHIN,
CASHOUT
Example:

"CASHIN"

updatedAt
string
required
Example:

"2024-01-15T10:35:00Z"

urgency
enum<string>
required
Available options:
HIGH,
NORMAL
Example:

"HIGH"

aliasId
string
Example:

"01989f9e-6508-79f8-9540-835be49fbd0e"

deletedAt
string
description
string
Example:

"Pix Cashin Transfer"

destination
object
feeCharge
object
initiatedAt
string
Example:

"2024-01-15T10:30:00Z"

ledger
object
metadata
object
source
object
withdrawal
object