Initiate withdrawal
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/withdrawal?destinationIdentifier=e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18&destinationKind=BANK_ACCOUNT';const options = { method: 'POST', headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/payment/withdrawal?destinationIdentifier=e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18&destinationKind=BANK_ACCOUNT' \ --header 'Authorization: Bearer <token>' \ --header 'Wink-Version: 2.0'Initiates a full-balance withdrawal to the chosen payout destination on the given managing entity. The user must specify which destination (BankAccount or RevolutPayoutAccount) to send funds to. Processed via Revolut Business; the beneficiary will receive funds within 1-3 business days for bank rails or instantly for Revolut-to-Revolut. Initial status is PENDING; the withdrawal transitions to PROCESSING once Revolut confirms, and COMPLETED when the payout arrives.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Managing entity identifier (UUID)
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Query Parameters
Section titled “Query Parameters ”Identifier of the chosen BankAccount or RevolutPayoutAccount on the managing entity
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Which collection on the managing entity to look up the destination in
Example
BANK_ACCOUNTHeader Parameters
Section titled “Header Parameters ”Responses
Section titled “ Responses ”Withdrawal initiated successfully
TripPay beneficiary withdrawal (payout) to a bank account via Revolut.
object
Document UUID
Datetime this record was first created
Datetime this record was last updated
Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.
TripPay account identifier of the beneficiary requesting withdrawal
BankAccount identifier within the account
Full available balance before fees are deducted
Revolut flat transfer fee ($5 USD converted to withdrawal currency)
FX exchange fee rate (0.006 or 0.010). Null if withdrawal currency is USD.
Calculated FX exchange fee amount. Null if withdrawal currency is USD.
Net amount sent to Revolut (grossAmount − transferFee − fxFee)
ISO 4217 currency code of the withdrawal
Current status of the withdrawal lifecycle
Revolut transaction ID returned by the Revolut Business API
Human-readable reference shown on bank statements
When the withdrawal was requested
When the withdrawal was completed (null until COMPLETED state)
Example
nullInvalid destination or insufficient balance
object
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }}object
object
object
object
object
object
object
object
Unauthorized — missing or invalid JWT token
object
object
Forbidden — missing ACCOUNTING:WRITE permission
object
object
Managing entity or destination not found
TripPay beneficiary withdrawal (payout) to a bank account via Revolut.
object
Document UUID
Datetime this record was first created
Datetime this record was last updated
Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.
TripPay account identifier of the beneficiary requesting withdrawal
BankAccount identifier within the account
Full available balance before fees are deducted
Revolut flat transfer fee ($5 USD converted to withdrawal currency)
FX exchange fee rate (0.006 or 0.010). Null if withdrawal currency is USD.
Calculated FX exchange fee amount. Null if withdrawal currency is USD.
Net amount sent to Revolut (grossAmount − transferFee − fxFee)
ISO 4217 currency code of the withdrawal
Current status of the withdrawal lifecycle
Revolut transaction ID returned by the Revolut Business API
Human-readable reference shown on bank statements
When the withdrawal was requested
When the withdrawal was completed (null until COMPLETED state)
Example
nullInternal Server Error
object
Example generated
{}