Initialize Card Wallet

curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/yativo_card_0xAbCd1234EfGh5678IjKl9012_1769031332068/safe/deploy' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/safe/deploy' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

{
  "success": true,
  "message": "Safe deployment initiated. Deployment typically takes up to 1 minute.",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "deployment_accepted": true,
    "estimated_completion": "~1 minute",
    "next_step": "monitor_deployment",
    "monitor_endpoint": "/api/yativo-card/yativo_card_customer_8f9a...abc_1769031332068/safe/deploy"
  }
}

{
  "success": true,
  "message": "Safe is already deployed and ready",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "already_deployed": true,
    "safe_address": "0x7eA0940F469913c1167A2397eb5a3E9AE8DAC0dE",
    "token_symbol": "USDCe",
    "fiat_symbol": "USD",
    "account_status": 0,
    "account_status_meaning": "Ok",
    "is_ready": true,
    "monitor_endpoint": "/api/yativo-card/yativo_card_customer_8f9a...abc_1769031332068/safe/deploy"
  }
}

POST

yativo-card

{yativoCardId}

safe

deploy

curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/yativo_card_0xAbCd1234EfGh5678IjKl9012_1769031332068/safe/deploy' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/safe/deploy' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

{
  "success": true,
  "message": "Safe deployment initiated. Deployment typically takes up to 1 minute.",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "deployment_accepted": true,
    "estimated_completion": "~1 minute",
    "next_step": "monitor_deployment",
    "monitor_endpoint": "/api/yativo-card/yativo_card_customer_8f9a...abc_1769031332068/safe/deploy"
  }
}

{
  "success": true,
  "message": "Safe is already deployed and ready",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "already_deployed": true,
    "safe_address": "0x7eA0940F469913c1167A2397eb5a3E9AE8DAC0dE",
    "token_symbol": "USDCe",
    "fiat_symbol": "USD",
    "account_status": 0,
    "account_status_meaning": "Ok",
    "is_ready": true,
    "monitor_endpoint": "/api/yativo-card/yativo_card_customer_8f9a...abc_1769031332068/safe/deploy"
  }
}

string

required

Bearer token: Bearer YOUR_ACCESS_TOKEN

The card wallet must be initialized before you can fund it or create cards. This is a one-time setup step that activates the on-chain wallet infrastructure for the card account.For B2B Card Issuer customers use the customer-scoped path: /v1/yativo-card/customers/{yativoCardId}/safe/deploy. Call this explicitly after KYC approval before proceeding to card creation. Even when the platform deploys the Safe automatically in the background, card creation checks the local DB state — not the card network directly — so this call is needed to sync the record. It is idempotent: if already deployed you will receive "already_deployed": true.

curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/yativo_card_0xAbCd1234EfGh5678IjKl9012_1769031332068/safe/deploy' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/safe/deploy' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

{
  "success": true,
  "message": "Safe deployment initiated. Deployment typically takes up to 1 minute.",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "deployment_accepted": true,
    "estimated_completion": "~1 minute",
    "next_step": "monitor_deployment",
    "monitor_endpoint": "/api/yativo-card/yativo_card_customer_8f9a...abc_1769031332068/safe/deploy"
  }
}

{
  "success": true,
  "message": "Safe is already deployed and ready",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "already_deployed": true,
    "safe_address": "0x7eA0940F469913c1167A2397eb5a3E9AE8DAC0dE",
    "token_symbol": "USDCe",
    "fiat_symbol": "USD",
    "account_status": 0,
    "account_status_meaning": "Ok",
    "is_ready": true,
    "monitor_endpoint": "/api/yativo-card/yativo_card_customer_8f9a...abc_1769031332068/safe/deploy"
  }
}

Response fields

Field	Type	Description
`already_deployed`	boolean	`true` when the Safe was already deployed before this call
`safe_address`	string	On-chain Safe address (present when already deployed)
`token_symbol`	string	Card token symbol (e.g. `USDCe`, `EURe`, `GBPe`)
`fiat_symbol`	string	Fiat currency code (e.g. `USD`, `EUR`, `GBP`)
`account_status`	number	Card network account status code. `0` = Ok, `7` = DelayQueueNotEmpty (both mean ready)
`account_status_meaning`	string	Human-readable status — `"Ok"` or `"DelayQueueNotEmpty"`
`is_ready`	boolean	`true` when the Safe is fully deployed and ready for card creation
`deployment_accepted`	boolean	`true` when a new deployment was initiated (202 response)
`monitor_endpoint`	string	Poll this `GET` endpoint to track deployment progress

Accept Terms Get Card Account

Overview

Authentication

Accounts

Assets

Transactions

Swap

Yativo Card (Own Account)

Card Customer — Onboarding

Card Customer — Card Operations

Card Issuer Program

Payment Gateway

Agentic Wallets

Unified Transactions

Auto-Forwarding

Compliance Screener

Subscriptions

IBAN

Webhooks

WaaS Customers (Wallet Sub-accounts)

Analytics

API Keys

Initialize Card Wallet

Response fields

​Response fields

Response fields