Exchange Callbacks

Exchange Withdrawal

Fiat batch withdrawals are used here. Read more about that here.

Statuses

• ⏳Exchanged - your swap is filled and balances are exchanged
• 😡 Failed – can fire before exchanged status or after exchanged status (order not filled, withdraw is not successful and etc. In that case you should check you account in web application)

• ✅ Done – withdrawal was sent

Webhook request body:

Field	Type	Description
kind	"FiatExchangeWithdraw" | "CryptoExchangeWithdraw"
id	string*	Identifier
ticker	string*	"KZT"
amount	string*	amount in decimal format, look at the example
paidAmount	string*	This field can differ from amount field in specific bank cases so it should be used as source of true.
failedAmount	string*	withdraw amount that not sent on bank side
fee	string*	withdraw service fee, learn more here
meta	string	metadata you defined when withdrawal was created
localId	string	localId you defined when withdrawal was created, or it could be the id of an entity that caused this withdrawal if it happens due to auto-targeting
status	string*	"Done" | "Exchanged" | "Failed"
time	number*	timestamp when withdrawal was created in ms
exchangeFee	string*	exchange fee used
spendTicker	string*	ticker that was withdrawn from balance (exchanged)
spendAmount	string*	amount that was withdrawn from balance (exchanged)
price	string*	price value, example: 23000 for BTC -> USDT pair
pricePair	string*[2]	pair that used in exchange
exchanged	boolean	balances were swapped and exchanged succeeded
to	string*	card number
causedBy	string	If this field present, it's mean that this is auto withdrawal, caused by some deposit. Posible values: "fiat-invoice", "crypto-invoice", "crypto-replenishment"
internal	boolean	offchain withdraw to 0xpay address

Exchange

Statuses:

• 😡 Failed – can fire before exchanged status or after exchanged status (order not filled, exchange is not successful and etc. In that case you should check you account in web application)

• ✅ Done – success exchange

Webhook request body:

Field	Type	Description
id	string*	Identifier
localId	string	localId you defined when exchange was created, or it could be the id of an entity that caused this exchange if it happens due to auto-targeting
time	number*	timestamp when exchange was created in ms
meta	string	metadata you defined
status	string*	"Failed", "Done"
kind	"Exchange"
targetTicker	string*	Ticker you chose to receive.
targetAmount	string*	amount that was received to balance (exchanged)
spendTicker	string*	ticker that was withdrawn from balance (exchanged)
spendAmount	string*	amount that was exchange from balance (exchanged)
fee	string*	withdraw service fee, learn more here
price	string*	price value, example: 23000 for BTC -> USDT pair
pricePair	[string*, string*]	array of two tickers (targetTicker, spendTicker). Values you can find here (Ticker column) + Fiat ticker "UAH"
merchantId	string*	your own merchant identifier
failedReason	string	reason why exchange was failed
causedBy	string	If this field present, it's mean that this is auto exchange, caused by some deposit. Posible values: "fiat-invoice", "crypto-invoice", "crypto-replenishment"