On-ramps - Stableyard

An on-ramp takes local currency from a payer and delivers stablecoin to the destination an account has chosen. Two routes exist, and they solve different problems.

Route	Use when
Fiat at checkout	A payer is completing one specific payment and has no crypto
On-ramp accounts	A customer funds repeatedly and wants bank details of their own

Fiat at checkout is enabled per app, through one provider, in that provider’s markets. View supported regions and currencies →

Offer fiat at checkout on a receive payment

Fiat at checkout is a payment method on a receive Payment. The payer selects it, completes the provider’s flow, and the stablecoin lands in the same escrow as any other method. The payment, the webhooks and the settlement do not change.

curl -X POST https://staging-api-v2.stableyard.fi/v2/payments \
  -u "$APP_ID:$APP_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "intent": "receive",
    "recipient": { "accountId": "acct_123" },
    "amountMode": "collect_exact",
    "paymentAmount": {
      "amount": "100.00",
      "assetType": "crypto",
      "assetCode": "USDC",
      "chainId": 42161
    }
  }'

The available methods depend on your entitlement and the payer’s market, so read them from the payment rather than assuming a fiat method exists. A fiat option carries its own quote deadline, and the effective window is whichever lapses first, the quote or the payment. See Conversion.

Next: Off-ramps

Pay out local currency to a bank or a local merchant.