Skip to main content
POST
/
wallet
/
transactions
/
pix
/
withdrawal
curl --request POST \
  --url https://api.ripio.com/wallet/transactions/pix/withdrawal/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "amount": "150.00",
  "currency": "BRL",
  "gateway_data": {
    "pix_key": "23351302000100"
  }
}
'
{
  "error_code": null,
  "message": null,
  "data": {
    "id": "txn_abc456",
    "currency": "BRL",
    "alt_fee_currency": null,
    "date_created": "2026-04-13T12:00:00Z",
    "status": "PEN",
    "amount": "150.00",
    "fee_currency": "BRL",
    "fee": "0.00",
    "total": "150.00",
    "alt_fee": "0.00",
    "address_from": null,
    "address_to": null,
    "address_to_memo": null,
    "network": null,
    "network_fee": "0.00",
    "amount_network_fee": "0.00",
    "crypto_amount": null,
    "rate_currency": null,
    "description": null,
    "expiring_date": null,
    "barcode": null,
    "invoice_pdf": null,
    "redirect": null,
    "gateway": "pix",
    "txn_hash": null,
    "txn_type": "WITHDRAWAL",
    "txn_class": "fiat",
    "phone_refill": null,
    "currency_pair": null,
    "balance_transfer_hash": null,
    "investment_id": null,
    "txn_hash_url": null,
    "reference_code": null,
    "gateway_data": {},
    "is_swap": false,
    "reference_id": "ref_pix",
    "network_standard": null
  }
}

Headers

​
authorization
string
required

The API key as a string.

​
signature
string
required

See the Generating Signature section for more details.

​
timestamp
number
required

A timestamp in milliseconds. See the Timestamp Security section for more details.

​
timstamp-tolerance
number

An additional, non-required parameter, that you can send to specify the number of milliseconds after the timestamp for the request to be valid. See the Timestamp Security section for more details.

Body

application/json
​
amount
string
required

Withdrawal amount as a decimal string. Must be ≥ 0.01, with up to 2 decimal places.

Example:

"150.00"

​
currency
string
required

Currency to withdraw. Only BRL is accepted.

Example:

"BRL"

​
gateway_data
object
required

Gateway-specific data for the PIX withdrawal.

​
source
string

Optional field to indicate funds come from wallet or ripio trade (default is wallet)

Example:

"trade"

Response

PIX withdrawal transaction created successfully.

​
error_code
string
required
Example:

null

​
message
string
required
Example:

null

​
data
object
required

Transaction object returned by creation endpoints (withdrawal, send). Uses the v3 TransactionOutputSerializer format, which differs from the list/detail format (GatewayTransaction).