Документация/Карты/Создать верификацию карты

Создать верификацию карты

POST/api/v1/card-verifications

Привязка карты без списания — для последующих подписок и выплат.

HMACIdempotency-Key requiredcreateCardVerification

Параметры тела

ПолеТипОписание
order_idreqstringYour own reference. Unique per API key.
currencyreqstring
cardreqobject
numberreqstring
expire_monthreqinteger
expire_yearreqinteger
cvvreqstring
descriptionstring
metadataobject

Пример

Запрос

POST /api/v1/card-verifications
Idempotency-Key: order-20260817-001

{
  "order_id": "order-20260817-001",
  "currency": "EUR",
  "card": {
    "number": "number",
    "expire_month": 1,
    "expire_year": 1,
    "cvv": "cvv"
  },
  "description": "Заказ №014"
}

Ответ 201

{
  "verification_id": "0198c5f2-7b3e-7a41-9c2d-3f8a1b6e4d02",
  "order_id": "order-20260817-001",
  "status": "pending",
  "final": false,
  "verify_attempts": 1,
  "created_at": "2026-08-17T12:45:22Z",
  "updated_at": "2026-08-17T12:45:22Z"
}

Собрать запрос

Собрать запрос
curl -X POST \
  https://api.calibripay.com/api/v1/card-verifications \
  -H "X-Access-Key: $CALIBRIPAY_ACCESS_KEY" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE" \
  -H "Idempotency-Key: order-20260817-001" \
  -d '{ "order_id": "order-20260817-001", "currency": "EUR", "card": { "number": "number", "expire_month": 1, "expire_year": 1, "cvv": "cvv" }, "description": "Заказ №014" }'

$TS, $NONCE и $SIGNATURE вычисляются на вашем backend по канонической строке. secret_key никогда не должен попадать в браузер, в командную строку из истории и в тикеты.

Связанные операции

GET/api/v1/card-verifications/{id}Статус верификации картыPOST/api/v1/card-verifications/{id}/verifyПодтвердить верификацию карты
← НазадПодтвердить выплатуДальше →Статус верификации карты
Была ли страница полезной?