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
💳 Visa / MC
Crypto
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
| Code | Description |
|---|---|
INVALID_DATA | Invalid request data. Check json syntax |
VALIDATION | Validation error. See error.validationErrors for details |
METHOD_NOT_FOUND | Endpoint not found |
INVALID_HTTP_METHOD | Only POST method allowed |
AUTHENTICATION_FAILED | Check your api token |
ORDER_ALREADY_EXISTS | Order with same merchantOrderId already exists |
ORDER_NOT_FOUND | Specified order was not found |
REJECTED_DUE_TO_TECHNICAL_ISSUE | Rejected due to technical issue |
REQUEST_FROM_UNTRUSTED_SOURCE | Request from untrusted source (ip not allowed) |
PAYIN_DISABLED | Payment disabled. Contact us to enable |
PAYOUT_DISABLED | Withdrawal disabled. Contact support to enable |
WALLET_NOT_FOUND | Wallet not found. Contact support to enable wallet |
WALLET_INACTIVE | Wallet inactive. Contact support to enable wallet |
ROUTING_NOT_CONFIGURED | Routing not configured. Please contact us for details |
POINT_NOT_FOUND | There is no way to process transaction. If issue is persistent please contact us for additional details |
AMOUNT_GREATER_THAN_ALLOWED | Operation amount greater than allowed |
AMOUNT_LESS_THAN_ALLOWED | Operation amount less than allowed |
NOT_ENOUGH_BALANCE | Operation amount greater than available balance |
OPERATION_NOT_SUPPORTED | Operation not supported |
REFERER_REQUEST_DOES_NOT_MATCH_ALLOWED_SOURCES | Referer from request does not match user hosts. Please contact us if you have any questions. |
UNKNOWN | Unknown error |
Order Status
Refer to the Status & Webhook section for generic guidance.
New
Processing
Completed
Rejected
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}