Sign in

v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB
Card PIN

Reset Card PIN

Reset physical card pin code.

post/v1/issuing/cards/pin

Headers

x-on-behalf-ofstring

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

x-idempotency-keystring uuid

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

Request body

card_idstring uuid required

Unique identifier for card.

pinstring required

New PIN for the card, must be a 6-digit numeric value.

Example request

{
  "card_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395",
  "pin": "123456"
}

Response

Set card pin successfully.

request_status'SUCCESS' required

Request status.