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": 12349,
    "external_id": null,
    "transaction_type": "withdrawal",
    "rail": "pix",
    "status": "PEN",
    "gateway_details": null,
    "transaction_hash": null,
    "from_currency": "BRL",
    "to_currency": "BRL",
    "fiat_currency": "BRL",
    "fee_currency": "BRL",
    "fee": "0.00",
    "fee_fiat": "0.00",
    "rate": "1",
    "rate_usd": "5.20",
    "amount_from": "150.00",
    "amount_to": "150.00",
    "amount_fiat": "150.00",
    "amount_usd": "28.85",
    "origin": null,
    "destination": "23351302000100",
    "tax": null,
    "tax_currency": null,
    "created_at": "2026-04-13T12:00:00Z",
    "updated_at": "2026-04-13T12:00:00Z",
    "extra_data": {}
  }
}

{
  "error_code": "TXN_0450",
  "message": "Missing pix key. TXN_0450",
  "data": null,
  "timestamp": 1777674872826
}

{
  "error_code": "ERR_0009",
  "message": "Forbidden",
  "data": null
}

Transactions

Create A Pix Withdrawal

Initiates a BRL withdrawal via PIX for the authenticated user.

The gateway_data.pix_key field must be a valid PIX key (CPF, CNPJ, email, phone, or random key).

Whitelisted contacts only: The destination PIX key must be a previously whitelisted contact of the user. Use POST /contacts/ to create and whitelist a banking contact before calling this endpoint.

Own account exception: If the destination PIX key is registered as one of the authenticated user’s own PIX keys, whitelisting is not required.

Country restriction: Only available for accounts with country = BR.

Authorization

Requires a valid API key.

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": 12349,
    "external_id": null,
    "transaction_type": "withdrawal",
    "rail": "pix",
    "status": "PEN",
    "gateway_details": null,
    "transaction_hash": null,
    "from_currency": "BRL",
    "to_currency": "BRL",
    "fiat_currency": "BRL",
    "fee_currency": "BRL",
    "fee": "0.00",
    "fee_fiat": "0.00",
    "rate": "1",
    "rate_usd": "5.20",
    "amount_from": "150.00",
    "amount_to": "150.00",
    "amount_fiat": "150.00",
    "amount_usd": "28.85",
    "origin": null,
    "destination": "23351302000100",
    "tax": null,
    "tax_currency": null,
    "created_at": "2026-04-13T12:00:00Z",
    "updated_at": "2026-04-13T12:00:00Z",
    "extra_data": {}
  }
}

{
  "error_code": "TXN_0450",
  "message": "Missing pix key. TXN_0450",
  "data": null,
  "timestamp": 1777674872826
}

{
  "error_code": "ERR_0009",
  "message": "Forbidden",
  "data": 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.

Show child attributes

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 the transactions list, detail and creation endpoints (GET /transactions/, GET /transactions/{id}/, and the 201 responses of every /transactions/{rail}/{action}/ endpoint). All three surfaces share this exact shape.

Show child attributes

Get Available Rails List Transactions

⌘I

Introduction

Ripio Wallet

Ripio Trade

Create A Pix Withdrawal

Headers

Body

Response