Confirm a custodial sell transfer

Request

Sell orders only. For custodial sell integrations. After your platform sends the crypto to the Banxa deposit address for a sell order (walletAddress and walletAddressTag from GET /{partner}/v2/orders/{orderId}), call this endpoint with the transaction hash. Banxa accepts the hash for validation and responds with 202 Accepted; track the order through webhooks or order lookup. See Custodial vs. non-custodial.

Path

partnerstringrequired

This is the partner code provided to you during onboarding. e.g. metamask.

orderIdstringrequired

The Banxa order ID, or the externalOrderId you provided when creating the sell order.

Acceptstring

Default:"application/json"

x-api-keystring

This is the API Key that has been provided to you during onboarding.

Example:YOUR_API_KEY

Bodyapplication/json

transactionHashstringrequired

Hash of the on-chain transfer to the Banxa deposit address.

sourceAddressstringrequired

Address the crypto was sent from. Must match the walletAddress given when the sell order was created.

sourceAddressTagstring

Memo or tag of the source address, if applicable.

targetAddressstringrequired

The Banxa deposit address the crypto was sent to (walletAddress from GET /{partner}/v2/orders/{orderId}).

targetAddressTagstring

Memo or tag sent with the transfer (walletAddressTag from GET /{partner}/v2/orders/{orderId}), if applicable.

curl -i -X POST \
  'https://docs.banxa.com/_mock/products/hosted-checkout/openapi/{partner}/v2/orders/{orderId}/confirm' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "transactionHash": "0x5ea06c4724e8119704a1b57c918acf31742eb06cdf3f8678fdb17f41bbaf968e",
    "sourceAddress": "0xcbf80ee36fbf03307962576f338fc50b942e0591",
    "targetAddress": "0x03EA4c7ED1d8199510017D88f2783Ef43ab5a4fd"
  }'

Responses

Transaction hash accepted for validation.

Bodyapplication/json

messagestring

Example:"This transaction hash has been accepted for validation."

Response

{
  "message": "This transaction hash has been accepted for validation."
}