Create withdrawal
Create withdrawal
POST {{Environment_URL}}/vendors/v1/withdrawals
<Description of the endpoint>
Headers
Name
Value
Authorization
Bearer <token>
Body
Key
Description
Required
Data Type
Example
quotation
Quotation ID obtained from Get withdrawal quotation.
true
String
899f633ea4b2f042cc5e4ec00e08bb085f1534cb
Request Body
{
"quotation": "899f633ea4b2f042cc5e4ec00e08bb085f1534cb"
}Response
{
"metadata": null,
"id": "wth_01jz35nvp161sycgvtkh5t979m",
"status": "CREATED",
"account": {
"id": "acc_01jetwj76zsqgsfx3w1by770j0",
"name": "subvendor pizzas",
"logo": null
},
"quotation": {
"id": "899f633ea4b2f042cc5e4ec00e08bb085f1534cb",
"metadata": {
"type": "WITHDRAWAL",
"externalId": "vnd_01hvpncr4she13t6nd929wbk8a",
"lastIds.0.type": "VENDOR_FEE",
"lastIds.0.id": "btnx_01jyzcf2gpafx1b17fchqe8aqe",
"lastIds.0": {
"type": "VENDOR_FEE",
"id": "btnx_01jyzcf2gpafx1b17fchqe8aqe"
},
"lastIds": [
{
"type": "VENDOR_FEE",
"id": "btnx_01jyzcf2gpafx1b17fchqe8aqe"
}
]
},
"currency": {
"code": "EUR",
"name": "Euro",
"commercialExchangeRate": {
"value": 52743,
"divisor": 10000,
"currency": "BRL",
"precision": 4,
"updatedAt": "2023-06-16T14:20:13.000Z"
},
"countryFlagUrl": "https://exchanges/european-union.svg",
"levelingRate": {
"value": 52743,
"divisor": 10000,
"currency": "BRL",
"precision": 4
},
"offer": {
"value": 22,
"divisor": 100,
"currency": "EUR",
"precision": 2
},
"offerUSD": {
"value": 24,
"divisor": 100,
"currency": "USD",
"precision": 2
},
"price": {
"withoutSpread": {
"value": 52743,
"divisor": 10000,
"currency": "BRL",
"precision": 4
},
"withoutTax": {
"value": 52743,
"divisor": 10000,
"currency": "BRL",
"precision": 4
},
"withTax": {
"value": 52743,
"divisor": 10000,
"currency": "BRL",
"precision": 4
},
"withTaxesAndFees": {
"value": 292484,
"divisor": 10000,
"currency": "BRL",
"precision": 4
},
"withFutureTax": {
"value": 292484,
"divisor": 10000,
"currency": "BRL",
"precision": 4
}
},
"spreads": [],
"fees": [
{
"name": "FEE_FC",
"type": "absolute",
"value": 100,
"receiver": "PLATFORM_FEE",
"netValue": {
"value": 527,
"divisor": 100,
"currency": "BRL",
"precision": 2
}
}
]
},
"tax": {
"iof": {
"percentage": 0,
"total": {
"value": 0,
"divisor": 100,
"currency": "BRL",
"precision": 2
}
}
},
"futureTax": {
"ir": {
"percentage": 0,
"total": {
"value": 0,
"divisor": 100,
"currency": "BRL",
"precision": 2
}
}
},
"total": {
"withoutSpread": {
"value": 116,
"divisor": 100,
"currency": "BRL",
"precision": 2
},
"withoutTax": {
"value": 116,
"divisor": 100,
"currency": "BRL",
"precision": 2
},
"withTax": {
"value": 116,
"divisor": 100,
"currency": "BRL",
"precision": 2
},
"withTaxesAndFees": {
"value": 644,
"divisor": 100,
"currency": "BRL",
"precision": 2
},
"withFutureTax": {
"value": 644,
"divisor": 100,
"currency": "BRL",
"precision": 2
}
},
"createdAt": "2025-07-01T14:18:50.965Z"
},
"vendorId": "",
"accountId": "acc_01jetwj76zsqgsfx3w1by770j0",
"sourceAmount": 644,
"sourceCurrency": "BRL",
"targetAmount": 22,
"targetCurrency": "EUR",
"targetAmountUSD": 24,
"fsmEvents": {
"status": [
{
"transition": "create",
"to": "CREATED",
"timestamp": "2025-07-01T14:18:57.586Z"
}
]
},
"createdAt": "2025-07-01T14:18:57.584Z",
"updatedAt": "2025-07-01T14:18:57.584Z"
}