Create Card PIN Update URL

Generates a URL that can be used to render a secure frame to update the PIN for a card account. The URL is single-use and time-limited.

POST /customers/{customerID}/card_accounts/{cardAccountID}/pin

Create Card PIN Update URL

cURL

curl --request POST \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/pin \
  --header 'Api-Key: <api-key>' \
  --header 'Idempotency-Key: <idempotency-key>'

200

Example

{ "url": "https://secure.example.com/update-pin?token=xyz789" }

Authorizations

Api-Key · string · header · required

Headers

Idempotency-Key · string · required

Path Parameters

customerID · string · required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Pattern: [a-z0-9]*

cardAccountID · string<uuid> · required

The ID of the card account

Response

200

application/json

URL to update the card PIN

Response containing a secure URL to update a card's PIN

url · string<uri> · required

Single-use, time-limited URL that can be used to securely update the card PIN in an iframe

Example:

"https://secure.example.com/update-pin?token=xyz789"