Skip to main content
POST
/
v1
/
yativo-card
/
onboard
curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/onboard' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com"}'

{
  "success": true,
  "message": "Card onboarding initiated. Check your email for verification code.",
  "data": {
    "yativo_card_id": "yativo_card_0xAbCd1234EfGh5678IjKl9012_1769031332068",
    "email_masked": "yo***@example.com",
    "next_step": "verify_otp",
    "otp_expires_in_seconds": 600
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
email
string
required
Your email address. Yativo sends a one-time verification code here. Must not already be in use by an active card session under your account.
curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/onboard' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"email": "you@example.com"}'

{
  "success": true,
  "message": "Card onboarding initiated. Check your email for verification code.",
  "data": {
    "yativo_card_id": "yativo_card_0xAbCd1234EfGh5678IjKl9012_1769031332068",
    "email_masked": "yo***@example.com",
    "next_step": "verify_otp",
    "otp_expires_in_seconds": 600
  }
}

​
Next Steps

After a 201 response, check your email for the OTP and continue:
  1. Verify OTP — POST /v1/yativo-card/{yativoCardId}/verify-otp
  2. Get KYC link — GET /v1/yativo-card/{yativoCardId}/kyc-link
  3. Poll KYC status — GET /v1/yativo-card/{yativoCardId}/kyc-status
  4. Deploy card wallet — POST /v1/yativo-card/{yativoCardId}/safe/deploy
  5. Create virtual card — POST /v1/yativo-card/{yativoCardId}/cards/virtual