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