Create NFT Order

post deprecated

https://api.banxa.com/api/orders/nft/buy

Allows your customer to create a Fiat to NFT 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.

Body Params

account_reference

string

required

Unique customer reference provided by you to identify the order in our system

payment_method_id

int32

Payment method ID associated with the order.

source

string

required

Source currency code. i.e. USD, CAD etc.

source_amount

string

Source amount

target

string

required

Target cryptocurrency code. The cryptocurrency the NFT is listed in.

target_amount

string

Target amount. This will be overridden if a source_amount is also passed.

wallet_address

string

required

Wallet address to receive NFT.

blockchain

string

required

Blockchain network code. If not provided, the default blockchain configured for the cryptocurrency will be used. Refer to the Get Crypto Currencies endpoint to retrieve a list of supported blockchain network codes.

return_url_on_success

string

required

Return URL when the customer has completed the checkout process.

return_url_on_cancelled

string

Return URL when the customer cancels the checkout process.

return_url_on_failure

string

Return URL when the customer fails to complete the checkout process.

iframe_domain

string

Used if you are embedding an iFrame. This must be the exact domain where the iFrame will be hosted. e.g. [yourCompany].com. Do not include https:// in front of the domain.

meta_data

object

Headers

string

Defaults to application/json

X-Request-Id

string

This is the correlation ID related to the request.

Responses

Language

Credentials

Header

Request

Response

Choose an example:

application/json

200200

422422