Withdrawal

Withdrawal is a process of transferring money from your wallet to your customer.

  • 💳 Visa / MC
  • Crypto
Looking for something?

Feel free to contact us if you are looking for some other options.

Request

POST /api/v3/order/withdrawal/create
{
"merchantOrderId": "1697637323",
"amount": "100.54",
"currency": "usd",
"counterparty": {
"type": "cardNumber",
"number": "4111111111111111"
},
"webhookUrl": "https://example.com/webhook-url/1697637323"
}

Response

RESPONSE
{
"data": {
# An identifier of the order on our side
"id": "d68ed1c2-1cf9-40f5-b997-3b31d1495904",
# Provided identifier
"merchantOrderId": "1697637323",
# Type of order
"type": "payout",
"createdAt": "2023-10-18T13:55:25+00:00",
# Status of order
"status": "new"
},
"error": null
}

Errors list

CodeDescription
INVALID_DATAInvalid request data. Check json syntax
VALIDATIONValidation error. See error.validationErrors for details
METHOD_NOT_FOUNDEndpoint not found
INVALID_HTTP_METHODOnly POST method allowed
AUTHENTICATION_FAILEDCheck your api token
ORDER_ALREADY_EXISTSOrder with same merchantOrderId already exists
ORDER_NOT_FOUNDSpecified order was not found
REJECTED_DUE_TO_TECHNICAL_ISSUERejected due to technical issue
REQUEST_FROM_UNTRUSTED_SOURCERequest from untrusted source (ip not allowed)
PAYIN_DISABLEDPayment disabled. Contact us to enable
PAYOUT_DISABLEDWithdrawal disabled. Contact support to enable
WALLET_NOT_FOUNDWallet not found. Contact support to enable wallet
WALLET_INACTIVEWallet inactive. Contact support to enable wallet
ROUTING_NOT_CONFIGUREDRouting not configured. Please contact us for details
POINT_NOT_FOUNDThere is no way to process transaction. If issue is persistent please contact us for additional details
AMOUNT_GREATER_THAN_ALLOWEDOperation amount greater than allowed
AMOUNT_LESS_THAN_ALLOWEDOperation amount less than allowed
NOT_ENOUGH_BALANCEOperation amount greater than available balance
OPERATION_NOT_SUPPORTEDOperation not supported
REFERER_REQUEST_DOES_NOT_MATCH_ALLOWED_SOURCESReferer from request does not match user hosts. Please contact us if you have any questions.
UNKNOWNUnknown error

Order Status

Refer to the Status & Webhook section for generic guidance.

The new order status means that the order has not yet been processed.

This status is not final and will change.

RESPONSE
{
"data": {
"id": "e300df2c-5692-4efd-8c3b-b1f498709a01",
"merchantOrderId": "1697637323",
"type": "payout",
"createdAt": "2023-10-18T12:56:39+00:00",
# Status of order
"status": "new",
"merchantSourceWallet": null,
"merchantTargetWallet": null,
"transactions": [
{
"type": "payout",
"id": "de071bb1-60be-4c8c-9b3e-e5c2b5f19483",
# Status of transaction
"status": "new",
# Amount of money that will be withdrawn from merchant
"merchantWallet": {
"amount": "100.54",
"currency": "eur"
},
# Amount of money that will be received by customer
"paidOut": {
"amount": "100.54",
"currency": "eur"
},
"counterpartyInfo": null,
"paymentInfo": null,
"createdAt": "2023-10-18T12:56:39+00:00",
"completedAt": null,
"rejectReason": null
}
]
},
"error": null
}

Are there any inquiries still outstanding?

Our team of experts is available 24/7 to answer all your questions. Feel free to reach out to us at any time, and we will be happy to help you address any inquiries or issues. Your comfort and satisfaction are our priority.

Need help?

Contact support