> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Payment

> Create a new payment intent with a hosted checkout URL

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer YOUR_ACCESS_TOKEN`
</ParamField>

<ParamField body="title" type="string" required>
  Title shown on the checkout page (e.g. `"Invoice #1234"` or `"Pro Plan — Monthly"`).
</ParamField>

<ParamField body="requested_amount" type="number" required>
  Amount expected from the customer, in USD.
</ParamField>

<ParamField body="accepted_assets" type="string[]" required>
  One or more asset codes to accept. Must be from the [supported payment assets](/yativo-crypto/payment-gateway#supported-payment-assets) list.
  Example: `["USDC_SOL", "USDT_POL", "USDC_BASE"]`.
</ParamField>

<ParamField body="description" type="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.
</ParamField>

<ParamField body="customer_email" type="string">
  Pre-fill the customer email on the checkout page.
</ParamField>

<ParamField body="webhook_url" type="string">
  URL to POST payment event notifications to. See [Webhooks](/yativo-crypto/webhooks).
</ParamField>

<ParamField body="merchant_logo_url" type="string">
  Logo URL displayed on the hosted checkout page.
</ParamField>

<ParamField body="external_reference" type="string">
  Your internal order/reference ID attached to this payment for reconciliation.
</ParamField>

<RequestExample>
  ```bash theme={null}
  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"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>