post https://api.banxa.com/api/orders
Allows your customer to create a buy or sell crypto order with Banxa. Upon success, the response will contain a checkout URL which will be unique for the order. The customer will be redirected to this URL to complete the checkout process, which will expire after 1 minute if a redirect does not occur.
Building a Request for Buy Orders (On-Ramp)
Buy orders require the following mandatory fields:
account_reference
: the customer's unique IDsource
: a supported fiat currency e.g. USDtarget
: a supported cryptocurrency e.g. BTCwallet_address
: the address associated with the cryptocurrency being purchasedwallet_address_tag
: the tag/memo associated with the wallet address, if requiredreturn_url_on_success
: used to return the customer to your website once the order is completed
Building a Request for Sell Orders (Off-Ramp)
Sell orders require the following mandatory fields:
account_reference
: the customer's unique IDsource
: similar to a Buy order, this parameter is now a supported cryptocurrency instead of fiat currencytarget
: supported fiat currencyrefund_address
: the address associated with the cryptocurrency being sold in the event that a refund is necessaryrefund_address_tag
: the tag/memo associated with the wallet address, if requiredreturn_url_on_success
: used to return the customer to your website once the order is completed
Response
When an order is ready to be completed by the customer, you will receive the following:
Field | Description | Format |
---|---|---|
data.order.id | Unique ID for the the order | number |
data.order.account_id | Banxa generated account ID for the customer and linked to the customer reference provided by you | string |
data.order.account_reference | Unique customer reference provided by you | string |
data.order.order_type | Order type. Indicates whether the order is a sell or buy crypto order | string |
data.order.fiat_code | Fiat currency code | string |
data.order.fiat_amount | Fiat currency value | decimal |
data.order.coin_code | Cryptocurrency code | string |
data.order.coin_amount | Cryptocurrency value | decimal |
data.order.wallet_address | Cryptocurrency wallet address | string |
data.order.wallet_addres_tag | The tag/memo associated with the wallet address, if required | string |
data.order.blockchain | Blockchain network used for the cryptocurrency | array |
data.order.blockchain.code | Blockchain code | string |
data.order.blockchain.description | Blockchain name | string |
data.order.created_at | Timestamp of order creation in UTC | string |
data.order.checkout_url | URL that redirects customer to Banxa checkout | string |