Set Card PIN

curl -X PATCH https://api.swervpay.co/api/v1/cards/card_123/pin \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "pin": "1234"
  }'

{
  "message": "<string>"
}

{
  "message": "<string>",
  "values": {}
}

{
  "message": "<string>",
  "values": {}
}

{
  "message": "<string>",
  "values": {}
}

PATCH

cards

{id}

curl -X PATCH https://api.swervpay.co/api/v1/cards/card_123/pin \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "pin": "1234"
  }'

{
  "message": "<string>"
}

{
  "message": "<string>",
  "values": {}
}

{
  "message": "<string>",
  "values": {}
}

{
  "message": "<string>",
  "values": {}
}

Set or update the four-digit PIN for an active NGN Verve card. Call this endpoint after the card.created webhook confirms that issuance completed successfully.

curl -X PATCH https://api.swervpay.co/api/v1/cards/card_123/pin \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "pin": "1234"
  }'

The PIN must contain exactly four digits. Swerv does not return the PIN in API responses or card webhooks.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Body

application/json

string

Response

message

string

API Documentation

Authentication

Business

Bills

Cards

Checkout

Customers

Collections

FX

Identity

Invoices

Others

Payouts

Transactions

Wallets

Webhook

Authorizations

Path Parameters

Body

Response