Skip to main content
PUT
/
cards
/
{cardId}
Update card status, metadata, or spending controls
curl --request PUT \
  --url https://api-dev.paygen.online/cards/{cardId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cancellationReason": "lost",
  "metadata": {},
  "status": "active",
  "spendingControls": {
    "channels": {
      "atm": true,
      "pos": true,
      "web": true,
      "mobile": true
    },
    "allowedCategories": [
      "<string>"
    ],
    "blockedCategories": [
      "<string>"
    ],
    "spendingLimits": [
      {
        "amount": 123,
        "interval": "<string>",
        "categories": [
          "<string>"
        ]
      }
    ]
  },
  "creditAccountId": "<string>"
}
'
{
  "statusCode": 123,
  "message": "<string>",
  "data": {
    "_id": "<string>",
    "debitAccountId": "<string>",
    "cardHolderId": "<string>",
    "type": "virtual",
    "brand": "Mastercard",
    "currency": "NGN",
    "metadata": {},
    "status": "<string>",
    "spendingControls": {
      "channels": {
        "atm": true,
        "pos": true,
        "web": true,
        "mobile": true
      },
      "allowedCategories": [
        "<string>"
      ],
      "blockedCategories": [
        "<string>"
      ],
      "spendingLimits": [
        {
          "amount": 123,
          "interval": "<string>",
          "categories": [
            "<string>"
          ]
        }
      ]
    },
    "enable2FA": true,
    "disposable": true
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

cardId
string
required

Body

application/json
cancellationReason
enum<string>
Available options:
lost,
stolen
metadata
object
status
enum<string>
Available options:
active,
inactive,
canceled
spendingControls
object
creditAccountId
string

Response

200 - application/json

Card updated successfully.

statusCode
integer
required
message
string
required
data
object