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

​
otp
string
The OTP sent to the user’s registered email or phone to authorize the transfer.
​
transferReference
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

​
message
string
A descriptive message about the transfer finalization status.
​
success
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 success is false, refer to the message field for the failure reason