Change card PIN

post

https://sandcaas.undostres.com.mx/debit/v1/change-pin

Changes the PIN of a specific card

The operation validates the associated customer and replaces the old PIN with a new one. This request requires authentication and is only available for cards in an active state.

Important considerations

new_pin must be exactly 4 digits.
card_id must be valid and belong to the authenticated customer.
The card must be in a valid state (active, not retired, not permanently blocked).
The card must not be blocked due to excessive PIN attempts.
Customer authentication is required.
All operations are atomic—if the PIN change fails, the old PIN remains valid.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

200Operation result. May return success or a business error.

400Bad Request - Validation errors or invalid parameters. Error code 5000 - Validation errors: Missing required card_id Missing required customer_id Missing required new_pin Invalid card_id format Invalid customer_id format Invalid new_pin format (must be 4 digits) Card is not in active state

401Unauthorized - Invalid or missing authentication tokens. Error code 8000 - Device not linked to token_refresh Error code 8001 - Device is linked to token_refresh Error code 8010 - OAuth token has expired

404Not Found - Card or customer not found. Error code 5000 - Card or customer not found

500Internal Server Error - Server errors or processing failures. Error code 6000 - Database error Error code 7000 - WAAS server error