Phone Verification

Request and verify a phone number for the customer’s card account

Phone verification is required before card creation. There are two endpoints:

1. POST /v1/yativo-card/customers/:yativoCardId/phone/request-verification — send OTP to phone
2. POST /v1/yativo-card/customers/:yativoCardId/phone/verify — verify the OTP

---

Request Phone Verification

Authorization · string · required

Bearer token: Bearer YOUR_ACCESS_TOKEN

yativoCardId · string · required

The customer’s yativo_card_id.

phoneNumber · string · required

Customer’s phone number in international format (e.g. [phone]).

Request OTP

curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/phone/request-verification' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"phoneNumber": "[phone]"}'

200 OTP sent

{
  "success": true,
  "message": "Verification code sent to your phone",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "phone_number": "+14155****",
    "otp_requested_at": "2026-04-01T12:20:00.000Z",
    "next_step": "Verify OTP using POST /phone/verify"
  }
}

---

Verify Phone Number

yativoCardId · string · required

The customer’s yativo_card_id.

code · string · required

The OTP code received via SMS.

Verify OTP

curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/phone/verify' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"code": "382910"}'

200 Verified

{
  "success": true,
  "message": "Phone number verified successfully",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "phone_number": "+14155****",
    "is_verified": true,
    "next_step": "Create virtual card using POST /cards/virtual"
  }
}