Skip to main content
POST
/
v1
/
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'

{
  "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"
  }
}
​
Authorization
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 Gnosis Pay 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'

{
  "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"
  }
}

​
Response fields

FieldTypeDescription
already_deployedbooleantrue when the Safe was already deployed before this call
safe_addressstringOn-chain Gnosis Safe address (present when already deployed)
token_symbolstringCard token symbol (e.g. USDCe, EURe, GBPe)
fiat_symbolstringFiat currency code (e.g. USD, EUR, GBP)
account_statusnumberGnosis Pay account status code. 0 = Ok, 7 = DelayQueueNotEmpty (both mean ready)
account_status_meaningstringHuman-readable status — "Ok" or "DelayQueueNotEmpty"
is_readybooleantrue when the Safe is fully deployed and ready for card creation
deployment_acceptedbooleantrue when a new deployment was initiated (202 response)
monitor_endpointstringPoll this GET endpoint to track deployment progress