v1

latestOpenAPI 3.1.02026-07-26590236.8 KB

Update Secure Settings

Use this API to update the security settings attached to a card. These include the mobile number and PIN of the card.

patch/card/{card_id}/secure_settings

Path parameters

card_idstring required

Request body

mobilestring

Kindly provide the full phone number complete with the country prefix e.g. +11234567890

pinstring

The PIN is an 8-digit code used for authentication purposes. It is recommended that the PIN should only numeric characters (0-9).

Response

200

messagestring

{"stackTrail":"paths:/card/{card_id}/secure_settings:patch:responses:200:content:application/json:schema:properties:meta","oasType":"schema","type":"unknown"}

statusstring

Example response

{
  "data": {
    "id": "7d4412218a4a11efb8d20edcd86e5ab3",
    "holder_id": "72b84d0399a311ee9e6f0edcd86e5ab3",
    "holder_type": "business",
    "balance": 1000,
    "currency": "USD",
    "brand": "visa",
    "label": "EU Live Test Card",
    "cardholder_name": "UMBRELLA CORPORATION",
    "number_masked": "474362******9870",
    "number": "941bbe442a6cc6909bf328717768d8f3",
    "exp_month": "10",
    "exp_year": "2027",
    "cvv": "c4a036f2db7f62da9303943cbf07e9da",
    "pin": "5512f498e2c3d98228f4527c9667f7cc",
    "billing_address": {
      "line1": "2631 Plantation Hollow CT",
      "city": "Missouri",
      "state": "TX",
      "country": "US",
      "postal_code": "77459"
    },
    "platform_managed": true,
    "status": "active",
    "created_at": "2024-10-14T16:36:40Z",
    "updated_at": "2024-10-16T01:05:05Z"
  },
  "message": "Card secure settings updated successfully",
  "status": "success"
}