Receive stablecoin deposits with Yara wallets

Once a wallet has an active destination, it can receive deposits on that destination’s chain. Yara watches the chain, confirms incoming funds, credits your merchant USD balance, and notifies you.

Select a destination

Fetch the wallet and select the destination matching the network the sender will use. Give the sender the destination address and exact chain together.

{
  "status": "success",
  "message": "wallet retrieved",
  "error": "",
  "data": {
    "id": "7f7c6713-3fdc-43fb-a9e7-d3c364e7c763",
    "label": "Customer receipts",
    "status": "ACTIVE",
    "destinations": [
      {
        "id": "ea38c60e-7a0b-44f6-bdf0-8ec13a7e471a",
        "chain": "BASE",
        "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "status": "ACTIVE"
      }
    ]
  }
}

A destination is specific to its chain. Sending funds on a different network can result in lost funds. Always show the chain alongside the address.

Get notified on deposit

When a deposit is confirmed, Yara sends a deposit.confirmed webhook. You can also list deposits directly:

curl "https://api.yara.cash/v1/deposits?status=CONFIRMED&limit=50" \
  --header "x-yara-api-key: $YARA_API_KEY"

{
  "status": "success",
  "message": "deposits retrieved",
  "error": "",
  "data": {
    "items": [
      {
        "id": "741eec3c-5596-45b6-a88d-3627a236192f",
        "wallet_id": "7f7c6713-3fdc-43fb-a9e7-d3c364e7c763",
        "customer_id": "5ec10df5-acde-4e95-926c-2174279cf2fd",
        "asset": "USDC",
        "chain": "BASE",
        "amount": "100.000000",
        "amount_usd": "100.000000",
        "fee_usd": "0.000000",
        "net_amount_usd": "100.000000",
        "status": "CONFIRMED",
        "confirmations": 12,
        "tx_hash": "0x4f5d2d7a2c8a95c3"
      }
    ],
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1
  }
}

customer_id is present when the wallet belongs to a customer. It is omitted for a merchant-level wallet. To retrieve deposits and other transaction activity for one wallet, filter the transaction feed by wallet_id:

curl "https://api.yara.cash/v1/transactions?wallet_id=7f7c6713-3fdc-43fb-a9e7-d3c364e7c763" \
  --header "x-yara-api-key: $YARA_API_KEY"

Check your balance

Confirmed deposits roll up into your merchant USD balance.

curl https://api.yara.cash/v1/balance \
  --header "x-yara-api-key: $YARA_API_KEY"

{
  "status": "success",
  "message": "balance retrieved",
  "error": "",
  "data": {
    "available": "100.000000",
    "reserved": "0.000000",
    "pending_deposits": "25.000000",
    "currency": "USD"
  }
}

Wallets and customers do not have separate balances. pending_deposits are deposits Yara has seen but not yet confirmed, and they are not part of your spendable merchant available balance until they confirm.

Make a transfer

Pay out from your balance to a whitelisted recipient.

Wallets as a Service

Guides

API reference

Wallets

Balance

Deposits

Transfers

Transactions

Webhooks

Reference data

Status

Receive stablecoin deposits with Yara wallets

Select a destination

Get notified on deposit

Check your balance

Next

Make a transfer

​Select a destination

​Get notified on deposit

​Check your balance

​Next

Make a transfer

Select a destination

Get notified on deposit

Check your balance

Next