Release 13.08.2025
These updates are planned for the next production release and are not yet available in the current public API version.
Order Request Update
Breaking Change
All order-creation endpoints will require a customer
object in the request payload starting from release 15.09.2025.
Note: While the customer
object will be marked as required in the API documentation starting from 13.08.2025, it will actually be optional until 15.09.2025. We recommend including it in your requests as early as possible to ensure a smooth transition.
Release Schedule:
- 13.08.2025: The
customer
object will be added as optional to all order-creation endpoints - 15.09.2025: The
customer
object will become required for all order-creation endpoints
The following endpoints will have customer
added to their request schemas:
- Create deposit (
POST /api/v1/order/deposit
) - Create payment (
POST /api/v1/order/payment
) - Send crypto (
POST /api/v1/order/send
) - Create withdrawal (
POST /api/v1/order/withdrawal
)
Transaction Details Response
- Get Transaction by ID (
GET /api/v1/orders/{orderId}/transactions/{transactionId}
) - Get order by ID (
GET /api/gateway/api/v1/orders/{orderId}
)
Key updates:
receiverAddress
is no longer required and can now benull
.- New property added:
senderAddress
.
Asset Identifier Coverage Expanded
Enhancement
The assetId
enum now recognises the following additional values wherever it appears:
TRX, USDT_TRC20, USDC_TRC20, ETH, USDT_ERC20, USDC_ERC20,
BNB, USDT_BEP20, USDC_BEP20, BUSD_BEP20
Affected endpoints:
- Create deposit (
POST /api/v1/order/deposit
) - Create payment (
POST /api/v1/order/payment
) - Send crypto (
POST /api/v1/order/send
) - Create refund (
POST /api/v1/order/refund
) - Create withdrawal (
POST /api/v1/order/withdrawal
)
Transaction ID Return
Enhancement
Successful creation of refunds and withdrawals now returns a transactionId:
- Create refund (
POST /api/v1/order/refund
) —201
response now includes requiredtransactionId
. - Create withdrawal (
POST /api/v1/order/withdrawal
) —201
response now includes requiredtransactionId
.