👨‍💻
Beta Ramps - Documentation
  • Introduction
  • Getting Started
    • Onboarding
    • Set up your account
    • Processing limits
    • API Integration
  • API guide
    • Crypto and Fiat coverage
    • Authentication
    • Rate Limits
    • Webhooks
    • Errors
  • Request Payments
    • Crypto Payments Overview
    • Requesting a Crypto Quote
    • Crypto Payment Orders
    • Merchant's Account Balance
  • Registering Subaccounts
    • Subaccounts Overview
    • Registering Subaccounts
    • Wallet Addresses
    • Bank Account Information
  • Exchange Crypto to Fiat
    • Exchange Overview
    • Requesting a Quote
    • Buy/Sell Orders
    • Crypto and Fiat Deposits
    • Crypto and Fiat Withdrawal
    • Subaccount Balance
  • Pay anything from Crypto Wallet
    • 🚧Pay from Wallet Overview
Powered by GitBook
On this page
  1. Exchange Crypto to Fiat

Crypto and Fiat Withdrawal

Request withdrawal from sub-account wallets and bank accounts.

Withdrawal to an external Wallet

POST https://live.betaapp.com/v1/order/withdrawal

Headers

Name
Type
Description

Authorization*

String

Bearer {access_token}

x-sub-account-id*

String

Sub Account ID

accept*

String

application/json

Request Body

Name
Type
Description

target_asset*

String

Crypto asset

network*

String

Crypto asset's network

target_destination*

String

Crypto wallet

target_amount*

String

Amount to be processed

target_destination_tag

String

Crypto wallet tag (If applicable)

instant_payment_type

String

Only for Fiat Withdrawal

Brazil: PIX

Mexico: SPEI

Request Example for Crypto Withdrawal:

curl -X 'POST' \
  'https://live.betaapp.com/v1/order/withdrawal' \
  -H 'accept: application/json' \
  -H 'X-sub-account-id: 22376b76...43083b' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g' \
  -H 'Content-Type: application/json' \
  -d '{
  "instant_payment_type": "",
  "network": "bitcoin",
  "target_amount": 1,
  "target_asset": "BTC",
  "target_destination": "014027...57", 
  "target_destination_tag": "" 
}'

For Fiat Withdrawals you only need to inform the instant_payment_type, asset, and target_amount fields. The withdrawal will be processed to the registered subaccount's bank account details.

Request Example for Fiat Withdrawal:

curl -X 'POST' \
  'https://live.betaapp.com/v1/order/withdrawal' \
  -H 'accept: application/json' \
  -H 'X-sub-account-id: 22376b76...43083b' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g' \
  -H 'Content-Type: application/json' \
  -d '{
  "instant_payment_type": "PIX",
  "network": "",
  "target_amount": 100,
  "target_asset": "BRL",
  "target_destination": "", 
  "target_destination_tag": "" 
}'

Response Example for both Fiat and Crypto:

{
  "amount": 1,
  "asset": {
    "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/BTC-69.png",
    "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/BTC-35.png",
    "name": "Bitcoin",
    "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/BTC-20.png",
    "type": "crypto"
  },
  "date_time": "2023-11-22T13:09:33.079445313Z",
  "deposit": false,
  "exp_time": 1200,
  "message": "Success",
  "network": "bitcoin"
}
PreviousCrypto and Fiat DepositsNextSubaccount Balance

Last updated 1 year ago