Skip to main content
POST
/
v1
/
crypto-gateway
/
payments
curl -X POST '/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"
    }
  }'

{
  "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", "customer_email": "alice@example.com" },
    "expires_at": "2026-04-01T12:00:00Z",
    "created_at": "2026-04-01T11:00:00Z"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
amount
number
required
Payment amount in the specified currency.
​
currency
string
required
Currency code (e.g., USD, EUR).
​
description
string
Description shown on the checkout page.
​
metadata
object
Arbitrary key-value pairs attached to the payment for your reference (e.g., order_id, customer_email).
curl -X POST '/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"
    }
  }'

{
  "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", "customer_email": "alice@example.com" },
    "expires_at": "2026-04-01T12:00:00Z",
    "created_at": "2026-04-01T11:00:00Z"
  }
}