curl --request POST \
  --url https://api.ripio.com/wallet/transactions/bank/withdrawal/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "amount": "5000.00",
  "currency": "ARS",
  "gateway_data": {
    "bank_account": "some.bank.alias"
  }
}
'

{
  "error_code": null,
  "message": null,
  "data": {
    "id": 12345,
    "external_id": null,
    "transaction_type": "withdrawal",
    "rail": "bank",
    "status": "PEN",
    "gateway_details": null,
    "transaction_hash": null,
    "from_currency": "ARS",
    "to_currency": "ARS",
    "fiat_currency": "ARS",
    "fee_currency": "ARS",
    "fee": "0.00",
    "fee_fiat": "0.00",
    "rate": "1",
    "rate_usd": "1050.00",
    "amount_from": "5000.00",
    "amount_to": "5000.00",
    "amount_fiat": "5000.00",
    "amount_usd": "4.76",
    "origin": null,
    "destination": "some.bank.alias",
    "tax": null,
    "tax_currency": null,
    "created_at": "2026-04-13T12:00:00Z",
    "updated_at": "2026-04-13T12:00:00Z",
    "extra_data": {
      "bank_account": "some.bank.alias"
    }
  }
}

{
  "error_code": "TXN_0450",
  "message": "Missing bank account. TXN_0450",
  "data": null,
  "timestamp": 1777674872826
}

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

Transactions

Create A Cvu Bank Withdrawal

Initiates an ARS withdrawal to a registered CVU/CBU bank account for the authenticated user.

The gateway_data.bank_account field must be a valid CBU, CVU or alias.

Whitelisted contacts only: The destination bank account 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 CVU/CBU belongs to the authenticated user (i.e., it is registered as one of their own bank accounts), whitelisting is not required.

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

Authorization

Requires a valid API key.

POST

wallet

transactions

bank

withdrawal

curl --request POST \
  --url https://api.ripio.com/wallet/transactions/bank/withdrawal/ \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "amount": "5000.00",
  "currency": "ARS",
  "gateway_data": {
    "bank_account": "some.bank.alias"
  }
}
'

{
  "error_code": null,
  "message": null,
  "data": {
    "id": 12345,
    "external_id": null,
    "transaction_type": "withdrawal",
    "rail": "bank",
    "status": "PEN",
    "gateway_details": null,
    "transaction_hash": null,
    "from_currency": "ARS",
    "to_currency": "ARS",
    "fiat_currency": "ARS",
    "fee_currency": "ARS",
    "fee": "0.00",
    "fee_fiat": "0.00",
    "rate": "1",
    "rate_usd": "1050.00",
    "amount_from": "5000.00",
    "amount_to": "5000.00",
    "amount_fiat": "5000.00",
    "amount_usd": "4.76",
    "origin": null,
    "destination": "some.bank.alias",
    "tax": null,
    "tax_currency": null,
    "created_at": "2026-04-13T12:00:00Z",
    "updated_at": "2026-04-13T12:00:00Z",
    "extra_data": {
      "bank_account": "some.bank.alias"
    }
  }
}

{
  "error_code": "TXN_0450",
  "message": "Missing bank account. 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:

"5000.00"

currency

string

required

Currency to withdraw. Only ARS is accepted.

Example:

"ARS"

gateway_data

object

required

Gateway-specific data for the withdrawal.

Show child attributes

promise

string

Signed JWT from the swap service. When provided, a crypto-to-ARS swap is executed before the withdrawal. Omit for a direct ARS withdrawal.

source

string

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

Example:

"trade"

Response

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

Reprocess A Crypto Receive Transaction By Hash Send Balance To Another User Via Ripio_tag

⌘I

Introduction

Ripio Wallet

Ripio Trade

Create A Cvu Bank Withdrawal

Headers

Body

Response