Skip to main content
POST
Used before a transaction to verify the card and fetch the holder name and current balance.

Request

string
required
API key ID assigned to the POS integration
string
required
RFC3339 timestamp used in the HMAC signature
string
required
Hex-encoded HMAC-SHA256 of the request

Body Parameters

string
required
Card serial number
string
required
Cardholder 4-digit PIN

Response

boolean
Whether verification succeeded
string
Verification result message
boolean
Whether the card is active
string
Formatted available balance
string
Card holder display name

Examples


Use Cases

Pre-Auth

Check card before entering amount

Identity

Verify card holder name matches id

Errors

Authorizations

Authorization
string
header
required

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

Body

application/json

Card verification details

card_serial
string
required

Supports any alphanumeric: CARD0001, 48290173K, etc.

Example:

"CARD0001"

pin
string

Required for POS routes, optional for payment routes (HMAC provides security)

Example:

"1234"

Response

Card verified

The response is of type object.