Update Card PIN

Testing Env

https://partner-api-stage.p100.io

PATCH

/v1/card/pin

This endpoint allows you to update the PIN code for a specific virtual card belonging to a user. Use this endpoint when a user wants to change their card's PIN for security reasons or if they have forgotten their current PIN. The request requires the user's external ID, the card ID, and the new PIN code. A successful response confirms that the PIN has been updated and the card can be used with the new PIN immediately.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠401Access Denied

🟠400P403: Validation error

🟠400P434: Card not exist

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠400P459: User not verified

🟠400P461: User not extended

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://partner-api-stage.p100.io/v1/card/pin' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "externalUserId": "985f38c8-9a33-423b-86be-86a5997feaa9",
    "cardId": "9eefa38e-6db4-40de-bc1b-719cd9d2cf05",
    "pin": "1234"
}'

Response Example

200 - Success

{
    "message": "Card pin updated successfully"
}

Get Card Details

Block Card