Finalize PIN Creation

This endpoint completes the wallet PIN setup by validating the OTP sent during the PIN authorization step and setting the user's wallet PIN.

The user_ref, new pin, and valid otp_code are required to successfully complete the PIN creation process.

POST {{base_url}}/api/v1/user/wallet/pin

Request Headers

NameTypeDescription
Authorization*StringBearer ${api_key} — your activated merchant API key.

Request Body

NameTypeDescription
user_refStringThe unique reference of the user.
pinStringThe wallet PIN the user wants to set.
otp_codeStringThe OTP sent to the user's registered email to authorize PIN creation.

Sample Request

{
  "user_ref": "UREFB71CBD5EE9BE4AEFB0A1587839EAD87D007QQ",
  "pin": "124106",
  "otp_code": "699631"
}

Response

200 OK

{
  "status": "success",
  "message": "Wallet PIN set successfully"
}

Did this page help you?