Finalizing a quote
Overview
Finalizing a quote is the last step before making the payment. Once you finalize the quote, the payment is waiting to be received or deducted from your existing balance then processed for settlement. Only a quote with status initiated can be finalized.
Request
To finalize the quote, send a POST request to /api/v1/payouts/finalize with the quote ID and any final details. This step completes the transaction and triggers the transfer of funds. The request body for finalizing is simply just the quoteId, here's what it looks like:
Sample Request Payload
{
"quoteId": "QT_6156"
}The complete specification of the endpoint and its properties can be found in the API reference (opens in a new tab).
Response
The response will confirm that the quote has been finalized and provide the address for payment (if your source is onchain) or set the status to reflect that the balance is being evaluated and deducted to begin processing of the settlement. Here's a sample response:
Sample Response
{
"status": true,
"message": "OffRamp quote finalized successfully",
"data": {
"id": "6ae40f3c-0eb5-478e-8892-560ee427ee3c",
"fees": 0,
"chain": "trc20",
"amount": 200,
"status": "pending_address_deposit", // Waiting for a deposit of the EXACT amount in the provided wallet
"address": "TS8bXUyq2QdyYceKVxcvJpHQ6NX6qY2xaZ",
"quoteId": "QT_6156",
"btcAmount": 0.00211578,
"fromAsset": "usdt",
"reference": "off_QT_ref-10a4",
"satAmount": 211578,
"paymentETA": "3-5 minutes",
"exchangeRate": 1626.1,
"expiresInText": "This invoice expires in 15 minutes",
"paymentReason": "Funds for stuff",
"expiryTimeStamp": 1736937230,
"settlementAmount": 325220,
"beneficiaryDetails": {
"id": "e8455a92-65a6-4ad0-b902-ba51392de269",
"status": "success",
"country": "NG",
"currency": "NGN",
"createdAt": "2025-01-15T10:17:49.419Z",
"reference": "QT_6156_86cadb25a4ac",
"updatedAt": "2025-01-15T10:17:49.419Z",
"destination": {
"type": "BANK",
"bankCode": "000014",
"accountName": "JANE DOE",
"accountNumber": "1421795566"
}
},
"settlementCurrency": "ngn"
}
}Once payment has been made or the balance has been deducted from your existing wallet, the process for settlement starts. The paymentETA is meant to provide an estimate of the amount of time before the settlement occurs barring any issues