Skip to main content
POST
/
v1
/
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 '{
    "external_id": "your_user_id_8821",
    "amount": 200,
    "source_chain": "SOL",
    "pricing_mode": "receive_x"
  }'

{
  "success": true,
  "message": "Customer funding initiated",
  "data": {
    "bridge_id": "bridge_01HX9KZMB3F7VNQ",
    "status": "initiated",
    "source": { "chain": "SOL", "amount": 201.80 },
    "destination": { "token": "EUR", "amount": 200.00 },
    "pricing_mode": "receive_x",
    "estimated_time": "2-10 minutes",
    "created_at": "2026-04-01T12:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.yativo.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authorization
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.
​
customer_id
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.
​
card_id
string
Card ID from card creation.
​
external_id
string
Your own reference (external_customer_id) set at onboarding.
​
email
string
Customer email address.
​
amount
number
required
Amount in USD. How this is interpreted depends on pricing_mode — see below.
​
source_chain
string
required
Master wallet to debit. SOL or XDC.
​
pricing_mode
string
Controls whether amount is what you send or what the customer receives.
  • send_x (default) — Your master wallet is debited exactly amount. Bridge and token-conversion fees are deducted from that, so the customer lands with slightly less. Use this when you want a predictable debit.
  • 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 send, then debits that larger figure. Use this when the customer is owed an exact payout.
Example — funding €200:
pricing_modeYou sendCustomer receives
send_x200 USD~197 EUR (fees deducted)
receive_x~204 USD (fees added)200 EUR exactly
​
destination_token
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 '{
    "external_id": "your_user_id_8821",
    "amount": 200,
    "source_chain": "SOL",
    "pricing_mode": "receive_x"
  }'

{
  "success": true,
  "message": "Customer funding initiated",
  "data": {
    "bridge_id": "bridge_01HX9KZMB3F7VNQ",
    "status": "initiated",
    "source": { "chain": "SOL", "amount": 201.80 },
    "destination": { "token": "EUR", "amount": 200.00 },
    "pricing_mode": "receive_x",
    "estimated_time": "2-10 minutes",
    "created_at": "2026-04-01T12:00:00.000Z"
  }
}