Release 13.05.2026
Changelog
Crypto
Renamed cryptocurrency asset_code values:
- The following
asset_codevalues have been renamed to use blockchain-based suffixes instead of token standard suffixes. If you use theasset_codeformat incost.currency, update your integration to the new values:USDC_ERC20→USDC_ETHUSDT_TRC20→USDT_TRXUSDT_ERC20→USDT_ETHUSDT_BEP20→USDT_BSCUSDT_SPL→USDT_SOLMATIC_ERC20→MATIC_ETHUSDC_TRC20→USDC_TRX
- Affected endpoints and callbacks:
POST /order— Create OrderPOST /payouts— Create Payout RequestGET /order/{shopId}/{orderNumber}— Retrieve Order DetailsGET /payouts/{shopId}/{payoutNumber}— Retrieve Payout Status- Order Status Callback
- Payout Status Callback
- For the full list of supported cryptocurrencies and their formats, see the Cryptocurrency Reference Guide.
Orders
Automatic finalization from need_action on payment amount mismatch:
- Orders moved to
need_actionwith status code2-07-04due to a provider callback with a different payment amount can now be resolved automatically when a follow-up callback arrives with the correct amount. - Automatic resolution requires the Automatic finalization of orders in the "Need action" status setting to be enabled for the shop. Otherwise, the order remains in
need_actionand must be resolved manually. - For details, see Order Status Model — Need Action.
Orders, Payouts, and P2P
New statusCode and statusDescription fields in responses and callbacks:
- Each response and callback payload now includes two new optional fields at the top level of the
dataobject:statusCode— status code that provides additional context for the current order, payout, or P2P status.statusDescription— human-readable description corresponding tostatusCode.
- Affected endpoints and callbacks:
- Retrieve Order Details —
GET /api/v1/order/{shopId}/{orderNumber} - Retrieve Payout Status —
GET /api/v1/payouts/{shopId}/{payoutNumber} - Retrieve P2P Transaction Status —
GET /api/v1/p2p/{shopId}/{p2pNumber} - Order Status Callback
- Payout Status Callback
- P2P Status Callback
- Retrieve Order Details —
- For the full list of status codes and their meaning, see the Status Codes reference.