Skip to main content
The Crypto Payment Gateway lets you accept cryptocurrency payments from anyone. Create a payment intent, share the hosted checkout link, and receive funds directly into your wallet. No frontend integration required — the hosted checkout page handles chain selection, wallet connection, and payment confirmation.

​
How It Works

1

Create a payment intent

Call POST /crypto-gateway/payments with the amount, currency, and optional metadata. You get back a payment ID and a hosted checkout URL.
2

Share the payment link

Redirect your customer to the hosted checkout page, or embed the payment link in an invoice, email, or QR code.
3

Customer pays

The customer selects a chain and token, confirms the transaction from their wallet, and the payment is verified on-chain.
4

You get notified

A webhook fires when the payment is confirmed. The funds land in your designated wallet.

​
Key Features

Hosted Checkout

A branded checkout page — no frontend code needed. Share a URL and get paid.

Multi-Chain

Accept payments in USDC, ETH, SOL, and other tokens across all supported chains.

Instant Settlement

Payments settle directly to your wallet. No holding periods, no intermediaries.

Webhook Notifications

Real-time webhook events when payments are confirmed, expired, or failed.

Payment Dashboard

View all payments, track conversions, and monitor revenue from the gateway overview.

Embeddable

Use the payment link in emails, invoices, QR codes, or redirect from your checkout flow.

​
Create a Payment Intent

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 '{
    "amount": 49.99,
    "currency": "USD",
    "description": "Pro Plan - Monthly",
    "metadata": {
      "order_id": "ord_123",
      "customer_email": "alice@example.com"
    }
  }'
Response
{
  "success": true,
  "data": {
    "payment_id": "pi_01abc123",
    "amount": 49.99,
    "currency": "USD",
    "status": "pending",
    "checkout_url": "https://crypto-api.yativo.com/api/v1/crypto-gateway/pay/pi_01abc123",
    "description": "Pro Plan - Monthly",
    "metadata": { "order_id": "ord_123" },
    "expires_at": "2026-04-01T12:00:00Z",
    "created_at": "2026-04-01T11:00:00Z"
  }
}
Share the checkout_url with your customer. The hosted page handles everything from there.

​
Hosted Checkout Flow

The hosted checkout page at checkout_url lets the payer:
  1. See the payment amount and description
  2. Select their preferred chain and token
  3. Connect their wallet or copy the payment address
  4. Confirm the transaction
  5. See a confirmation once the payment is verified on-chain
No integration code required on your side.

​
Check Payment Status

Poll the payment status or wait for a webhook: 
curl -X GET 'https://crypto-api.yativo.com/api/v1/crypto-gateway/pay/pi_01abc123/status'
Response
{
  "success": true,
  "data": {
    "payment_id": "pi_01abc123",
    "status": "paid",
    "amount": 49.99,
    "paid_amount": 50.00,
    "paid_asset": "USDC",
    "paid_chain": "base",
    "tx_hash": "0xdef456...",
    "confirmed_at": "2026-04-01T11:05:00Z"
  }
}

​
Payment Statuses

StatusDescription
pendingPayment intent created, awaiting customer action
paidPayment confirmed on-chain
expiredCustomer didn’t pay before the expiration time
failedTransaction was attempted but failed on-chain

​
List Payments

curl -X GET 'https://crypto-api.yativo.com/api/v1/crypto-gateway/payments' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Returns all payment intents with their current status, amounts, and metadata.

​
Gateway Overview

Get a summary of your payment gateway activity: 
curl -X GET 'https://crypto-api.yativo.com/api/v1/crypto-gateway/overview' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​
Webhook Events

Subscribe to gateway events via the Webhooks API:
EventTrigger
gateway.payment.paidPayment confirmed on-chain
gateway.payment.expiredPayment expired without completion
gateway.payment.failedOn-chain transaction failed

​
Next Steps

API Reference

Full endpoint reference for the payment gateway.

Sandbox

Test payment flows in the sandbox environment.

Webhooks

Set up webhook notifications for payment events.