curl --location --request POST 'https://api.recital.finance/api/v1/transfer/finalize?otp=080802&transferReference=BAL-YA9S0J0UQKDVF4EXV2CK4RO5F2' \
--header 'Authorization: Bearer apiKey' \
--header 'Content-Type: application/json'
{
"message": "OTP confirmation failed: Transfer is not currently awaiting OTP",
"success": false
}
Transfer API(s)
Finalize Transfer
Confirm and complete a transfer using the OTP sent during the initiation phase.
POST
/
api
/
v1
/
transfer
/
finalize
curl --location --request POST 'https://api.recital.finance/api/v1/transfer/finalize?otp=080802&transferReference=BAL-YA9S0J0UQKDVF4EXV2CK4RO5F2' \
--header 'Authorization: Bearer apiKey' \
--header 'Content-Type: application/json'
{
"message": "OTP confirmation failed: Transfer is not currently awaiting OTP",
"success": false
}
Query Parameters
string
The OTP sent to the user’s registered email or phone to authorize the transfer.
string
The unique transfer reference returned from the initiation call.
curl --location --request POST 'https://api.recital.finance/api/v1/transfer/finalize?otp=080802&transferReference=BAL-YA9S0J0UQKDVF4EXV2CK4RO5F2' \
--header 'Authorization: Bearer apiKey' \
--header 'Content-Type: application/json'
Response
string
A descriptive message about the transfer finalization status.
boolean
Indicates whether the transfer was successfully confirmed.
{
"message": "OTP confirmation failed: Transfer is not currently awaiting OTP",
"success": false
}
Notes
- This endpoint must only be called after a successful transfer initiation with
shouldFinalize = true. - If
successisfalse, refer to themessagefield for the failure reason