Pine LabsDOCS

Reset Brand Wallet PIN

POST/payment-option/wallet/customer/{customer_id}/reset

Resets the PIN for a customer's brand wallet. Use this when the customer's wallet PIN is locked or forgotten. Returns the new PIN and remaining attempts.

Requires Bearer token. Get token →

Path Parameters

FieldDetails
customer_id
stringrequired

Unique customer identifier (e.g. cust-v1-...).

Header Parameters

FieldDetails
Request-Timestamp
stringdate-time

ISO 8601 UTC timestamp of the request. Used for idempotency and audit.

Request-ID
string

Use a global unique identifier [GUID] for the request.

Constraints
Minimum length: 1 characterMaximum length: 50 characters

Response

FieldDetails
pin
string

The new wallet PIN

pin_attempts_remaining
integer

Number of PIN entry attempts remaining

Status Codes

200PIN reset successfully.
400The request was malformed or missing required fields.
401Authentication failed — missing, expired, or invalid Bearer token.
500An unexpected error occurred on the server.
Run
Request
curl --request POST \
  --url https://pluraluat.v2.pinepg.in/payment-option/wallet/customer/cust-bw-001/reset \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z'
{
  "pin": "847291",
  "pin_attempts_remaining": 3
}