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"
}
}
Payment Gateway
Create Payment
Create a new payment intent with a hosted checkout URL
POST
/
v1
/
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_TOKENstring
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
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"
}
}