Create Payment

curl -X POST 'https://crypto-api.yativo.com/api/v1/crypto-gateway/payments' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Invoice #1234",
    "description": "Pro Plan subscription — April 2026",
    "requested_amount": 49.99,
    "accepted_assets": ["USDC_SOL", "USDT_POL", "USDC_BASE"],
    "customer_email": "alice@example.com",
    "webhook_url": "https://yourapp.com/webhooks/payments",
    "external_reference": "order_abc123"
  }'

{
  "success": true,
  "data": {
    "payment_id": "pay_a1b2c3d4e5f6",
    "title": "Invoice #1234",
    "description": "Pro Plan subscription — April 2026",
    "requested_amount": 49.99,
    "status": "awaiting_payment",
    "checkout_url": "https://crypto-checkout.yativo.com/pay/pay_a1b2c3d4e5f6",
    "embed_url": "https://crypto-checkout.yativo.com/embed/pay_a1b2c3d4e5f6",
    "accepted_options": [
      { "asset_code": "USDC_SOL", "network": "solana",  "deposit_address": "7xKXtg..." },
      { "asset_code": "USDT_POL", "network": "polygon", "deposit_address": "0xAbCd..." },
      { "asset_code": "USDC_BASE", "network": "base",   "deposit_address": "0x1234..." }
    ],
    "customer_email": "alice@example.com",
    "external_reference": "order_abc123",
    "payment_window_expires_at": "2026-04-18T13:00:00Z",
    "monitoring_ends_at": "2026-04-18T13:20:00Z",
    "created_at": "2026-04-18T12:00:00Z"
  }
}

POST

crypto-gateway

payments

curl -X POST 'https://crypto-api.yativo.com/api/v1/crypto-gateway/payments' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Invoice #1234",
    "description": "Pro Plan subscription — April 2026",
    "requested_amount": 49.99,
    "accepted_assets": ["USDC_SOL", "USDT_POL", "USDC_BASE"],
    "customer_email": "alice@example.com",
    "webhook_url": "https://yourapp.com/webhooks/payments",
    "external_reference": "order_abc123"
  }'

{
  "success": true,
  "data": {
    "payment_id": "pay_a1b2c3d4e5f6",
    "title": "Invoice #1234",
    "description": "Pro Plan subscription — April 2026",
    "requested_amount": 49.99,
    "status": "awaiting_payment",
    "checkout_url": "https://crypto-checkout.yativo.com/pay/pay_a1b2c3d4e5f6",
    "embed_url": "https://crypto-checkout.yativo.com/embed/pay_a1b2c3d4e5f6",
    "accepted_options": [
      { "asset_code": "USDC_SOL", "network": "solana",  "deposit_address": "7xKXtg..." },
      { "asset_code": "USDT_POL", "network": "polygon", "deposit_address": "0xAbCd..." },
      { "asset_code": "USDC_BASE", "network": "base",   "deposit_address": "0x1234..." }
    ],
    "customer_email": "alice@example.com",
    "external_reference": "order_abc123",
    "payment_window_expires_at": "2026-04-18T13:00:00Z",
    "monitoring_ends_at": "2026-04-18T13:20:00Z",
    "created_at": "2026-04-18T12:00:00Z"
  }
}

string

required

Bearer token: Bearer YOUR_ACCESS_TOKEN

string

required

Title shown on the checkout page (e.g. "Invoice #1234" or "Pro Plan — Monthly").

number

required

Amount expected from the customer, in USD.

string[]

required

One or more asset codes to accept. Must be from the supported payment assets list. Example: ["USDC_SOL", "USDT_POL", "USDC_BASE"].

string

Optional description of the goods or service being purchased (max 1000 characters). Shown on the hosted checkout page and included in the customer receipt email.

string

Pre-fill the customer email on the checkout page.

string

URL to POST payment event notifications to. See Webhooks.

string

Logo URL displayed on the hosted checkout page.

string

Your internal order/reference ID attached to this payment for reconciliation.

curl -X POST 'https://crypto-api.yativo.com/api/v1/crypto-gateway/payments' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Invoice #1234",
    "description": "Pro Plan subscription — April 2026",
    "requested_amount": 49.99,
    "accepted_assets": ["USDC_SOL", "USDT_POL", "USDC_BASE"],
    "customer_email": "alice@example.com",
    "webhook_url": "https://yourapp.com/webhooks/payments",
    "external_reference": "order_abc123"
  }'

{
  "success": true,
  "data": {
    "payment_id": "pay_a1b2c3d4e5f6",
    "title": "Invoice #1234",
    "description": "Pro Plan subscription — April 2026",
    "requested_amount": 49.99,
    "status": "awaiting_payment",
    "checkout_url": "https://crypto-checkout.yativo.com/pay/pay_a1b2c3d4e5f6",
    "embed_url": "https://crypto-checkout.yativo.com/embed/pay_a1b2c3d4e5f6",
    "accepted_options": [
      { "asset_code": "USDC_SOL", "network": "solana",  "deposit_address": "7xKXtg..." },
      { "asset_code": "USDT_POL", "network": "polygon", "deposit_address": "0xAbCd..." },
      { "asset_code": "USDC_BASE", "network": "base",   "deposit_address": "0x1234..." }
    ],
    "customer_email": "alice@example.com",
    "external_reference": "order_abc123",
    "payment_window_expires_at": "2026-04-18T13:00:00Z",
    "monitoring_ends_at": "2026-04-18T13:20:00Z",
    "created_at": "2026-04-18T12:00:00Z"
  }
}

Set Program Card Limits List Payments

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

Create Payment