Fund Customer Card

curl -X POST 'https://crypto-api.yativo.com/api/v1/card-issuer/fund-customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "fernando@truther.io",
    "amount": 10,
    "source_chain": "SOL",
    "pricing_mode": "receive_x"
  }'

curl -X POST 'https://crypto-api.yativo.com/api/v1/card-issuer/fund-customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "fernando@truther.io",
    "amount": 200,
    "source_chain": "SOL",
    "pricing_mode": "send_x"
  }'

{
  "success": true,
  "message": "Customer funded successfully",
  "data": {
    "transfer_id": "bridge_1778501099297_2ea87af00de1",
    "status": "completed",
    "source": {
      "chain": "SOL",
      "amount": 10
    },
    "destination": {
      "token": "USD"
    },
    "pricing_mode": "receive_x",
    "estimated_amount": "10.000000",
    "estimated_time": "immediate"
  }
}

{
  "success": true,
  "message": "Funding initiated for customer",
  "data": {
    "transfer_id": "bridge_1778501099297_2ea87af00de1",
    "status": "pending",
    "source": {
      "chain": "SOL",
      "amount": 10.00105711
    },
    "destination": {
      "token": "USD"
    },
    "pricing_mode": "receive_x",
    "estimated_amount": "9.998943",
    "estimated_time": "2–5 minutes"
  }
}

{
  "success": false,
  "error": "TOKEN_MISMATCH",
  "message": "This customer's card requires EUR. You requested USD. Please swap to EUR first.",
  "required_token": "EUR",
  "requested_token": "USD"
}

{
  "success": false,
  "error": "DAILY_LIMIT_EXCEEDED",
  "message": "Daily funding limit exceeded. Used: $48200.00, limit: $50000"
}

POST

card-issuer

fund-customer

curl -X POST 'https://crypto-api.yativo.com/api/v1/card-issuer/fund-customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "fernando@truther.io",
    "amount": 10,
    "source_chain": "SOL",
    "pricing_mode": "receive_x"
  }'

curl -X POST 'https://crypto-api.yativo.com/api/v1/card-issuer/fund-customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "fernando@truther.io",
    "amount": 200,
    "source_chain": "SOL",
    "pricing_mode": "send_x"
  }'

{
  "success": true,
  "message": "Customer funded successfully",
  "data": {
    "transfer_id": "bridge_1778501099297_2ea87af00de1",
    "status": "completed",
    "source": {
      "chain": "SOL",
      "amount": 10
    },
    "destination": {
      "token": "USD"
    },
    "pricing_mode": "receive_x",
    "estimated_amount": "10.000000",
    "estimated_time": "immediate"
  }
}

{
  "success": true,
  "message": "Funding initiated for customer",
  "data": {
    "transfer_id": "bridge_1778501099297_2ea87af00de1",
    "status": "pending",
    "source": {
      "chain": "SOL",
      "amount": 10.00105711
    },
    "destination": {
      "token": "USD"
    },
    "pricing_mode": "receive_x",
    "estimated_amount": "9.998943",
    "estimated_time": "2–5 minutes"
  }
}

{
  "success": false,
  "error": "TOKEN_MISMATCH",
  "message": "This customer's card requires EUR. You requested USD. Please swap to EUR first.",
  "required_token": "EUR",
  "requested_token": "USD"
}

{
  "success": false,
  "error": "DAILY_LIMIT_EXCEEDED",
  "message": "Daily funding limit exceeded. Used: $48200.00, limit: $50000"
}

string

required

Bearer token: Bearer YOUR_ACCESS_TOKEN

Supply exactly one customer identifier. The customer must have completed onboarding (KYC approved, wallet ready) before funding.

string

The customer_id from the List Customers or Look Up Customer response. You may supply any one identifier: customer_id, card_id, external_id, or email.

string

Card ID from card creation.

string

Your own reference (external_customer_id) set at onboarding.

string

Customer email address.

number

required

Amount in USD. How this is interpreted depends on pricing_mode — see below. Minimum 5.

string

required

Your master wallet chain to use as the funding source. SOL or XDC.

string

Controls whether amount is what you send or what the customer receives.

send_x (default) — Your master wallet is debited exactly amount. Any applicable fees are deducted before the customer’s card is credited.
receive_x — The customer’s card is credited exactly amount. The system works backwards through the fee schedule to calculate how much your master wallet must supply. Use this when the customer is owed an exact payout.

Example — funding $200:

`pricing_mode`	You send	Customer receives
`send_x`	$200	~$198 (after fees)
`receive_x`	~$202 (fees added)	$200 exactly

string

Optional target currency (USD, EUR, GBP). Defaults to the customer’s card currency. Must match — mismatches return an error with the correct required currency.

curl -X POST 'https://crypto-api.yativo.com/api/v1/card-issuer/fund-customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "fernando@truther.io",
    "amount": 10,
    "source_chain": "SOL",
    "pricing_mode": "receive_x"
  }'

curl -X POST 'https://crypto-api.yativo.com/api/v1/card-issuer/fund-customer' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "fernando@truther.io",
    "amount": 200,
    "source_chain": "SOL",
    "pricing_mode": "send_x"
  }'

{
  "success": true,
  "message": "Customer funded successfully",
  "data": {
    "transfer_id": "bridge_1778501099297_2ea87af00de1",
    "status": "completed",
    "source": {
      "chain": "SOL",
      "amount": 10
    },
    "destination": {
      "token": "USD"
    },
    "pricing_mode": "receive_x",
    "estimated_amount": "10.000000",
    "estimated_time": "immediate"
  }
}

{
  "success": true,
  "message": "Funding initiated for customer",
  "data": {
    "transfer_id": "bridge_1778501099297_2ea87af00de1",
    "status": "pending",
    "source": {
      "chain": "SOL",
      "amount": 10.00105711
    },
    "destination": {
      "token": "USD"
    },
    "pricing_mode": "receive_x",
    "estimated_amount": "9.998943",
    "estimated_time": "2–5 minutes"
  }
}

{
  "success": false,
  "error": "TOKEN_MISMATCH",
  "message": "This customer's card requires EUR. You requested USD. Please swap to EUR first.",
  "required_token": "EUR",
  "requested_token": "USD"
}

{
  "success": false,
  "error": "DAILY_LIMIT_EXCEEDED",
  "message": "Daily funding limit exceeded. Used: $48200.00, limit: $50000"
}

When estimated_time is "immediate" the transfer is already settled — no polling needed. When estimated_time is "2–5 minutes", save the transfer_id and poll Get Transfer Status until status is completed.

Swap Master Wallet Token List Transfers

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

Fund Customer Card