Skip to main content
POST
/
api
/
v1
/
cards
/
verify
Link physical card to user
const url = 'https://api.gnosispay.com/api/v1/cards/verify';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"encryptedPan":"encrypted_pan_value","encryptedKey":"encrypted_key_value","iv":"iv_value"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
{
  "cardId": "clp3j1f9a0000a1cdh6ezx2qv"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
encryptedPan
string
required

Encrypted Primary Account Number

Example:

"encrypted_pan_value"

​
encryptedKey
string
required

Encrypted key used for decryption

Example:

"encrypted_key_value"

​
iv
string
required

Initialization vector for decryption

Example:

"iv_value"

Response

Successfully verified and associated the card

​
cardId
string
required

The unique identifier of the verified card

Example:

"clp3j1f9a0000a1cdh6ezx2qv"