Reset PIN

This endpoint allows the user to replace their existing wallet PIN with a new PIN.

The PIN reset is authorized using the OTP sent to the user's registered email address. The user_ref, new pin, and valid otp_code are required to complete the reset.

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

Request Headers

Name	Type	Description
`Authorization`*	String	`Bearer ${api_key}` — your activated merchant API key.

Request Body

Name	Type	Description
`user_ref`	String	The unique reference of the user.
`pin`	String	The new wallet PIN the user wants to set.
`otp_code`	String	The OTP sent to the user's registered email to authorize the PIN reset.

Sample Request

{
  "user_ref": "UREFB71CBD5EE9BE4AEFB0A1587839EAD87D007QQ",
  "pin": "060124",
  "otp_code": "883399"
}

Response

`200 OK`

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