Card Credentials

Retrieve sensitive card data: full card number, CVV, expiry date, and cardholder name.

Handle with care

Card credentials are highly sensitive PCI data. Never log, store unencrypted, or expose them in client-side code. Use this endpoint only in secure server-side environments.

---

Endpoint

GET /api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments/{instrument_id}/credentials

Path Parameters

Parameter	Type	Required	Description
org_id	string	Yes	Your organization ID
wallet_id	string	Yes	Wallet UUID
instrument_id	string	Yes	Card UUID

---

Request

curl "https://api.4pay.cc/api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments/{instrument_id}/credentials" \
  -H "Authorization: Bearer YOUR_API_KEY"

---

Response

200 OK

{
  "data": {
    "cardNumber": "4111111111111111",
    "cvv": "123",
    "expiryMonth": "12",
    "expiryYear": "2027",
    "cardHolder": "JOHN DOE"
  }
}

Response Fields

Field	Type	Description
cardNumber	string	Full 16-digit card number
cvv	string	3-digit security code
expiryMonth	string	Expiry month (2 digits)
expiryYear	string	Expiry year (4 digits)
cardHolder	string	Name printed on the card (uppercase)