# Create Buy Checkout Create a checkout intent to execute an on-ramp (fiat to crypto) transaction. Pass the `onramp` value from a quote response to select which quote to use. ## Request ### Headers :::note Public Endpoint This endpoint does not require authentication headers. ::: ### Body Parameters :::tip Wallet Resolution If `walletAddress` is not provided but `sessionId` is, ZenPays automatically resolves the wallet from your merchant settings. See [Wallet Addresses](/docs/rest-api/endpoints/ramp/wallet-addresses) for details. ::: ## Response ### Success (200 OK) ```json { "success": true, "data": { "transactionId": "txn_abc123", "redirectUrl": "https://checkout.example.com/...", "status": "pending" }, "message": "Checkout intent created" } ``` ### Response Fields After receiving the response, redirect the user to `redirectUrl` to complete payment. ### Error Responses ## Examples ```bash curl -X POST https://api.zenpayz.com/payment/api/v1/on-ramp/checkout \ -H "Content-Type: application/json" \ -d '{ "onramp": "moonpay", "source": "usd", "destination": "btc_bitcoin", "amount": 100, "type": "buy", "paymentMethod": "creditcard", "walletAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" }' ``` ```javascript const response = await fetch('https://api.zenpayz.com/payment/api/v1/on-ramp/checkout', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ onramp: 'moonpay', source: 'usd', destination: 'btc_bitcoin', amount: 100, type: 'buy', paymentMethod: 'creditcard', walletAddress: 'bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh', }), }); const { data } = await response.json(); // Redirect user to complete payment window.location.href = data.redirectUrl; ``` ```python import requests response = requests.post( "https://api.zenpayz.com/payment/api/v1/on-ramp/checkout", json={ "onramp": "moonpay", "source": "usd", "destination": "btc_bitcoin", "amount": 100, "type": "buy", "paymentMethod": "creditcard", "walletAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", }, ) data = response.json()["data"] print(f"Transaction: {data['transactionId']}") print(f"Redirect to: {data['redirectUrl']}") ``` ## Full Integration Flow ``` 1. GET /on-ramp/supported-assets → Populate currency dropdowns 2. GET /on-ramp/payment-methods/usd → Get available payment options 3. GET /on-ramp/quotes?source=usd&destination=btc_bitcoin&amount=100 → Show pricing options to user 4. POST /on-ramp/checkout → Create checkout with selected quote 5. Redirect to redirectUrl → User completes payment 6. GET /on-ramp/transactions/{id} → Poll until completed or failed ``` --- ## Intent-Based Buy Checkout (Recommended) For merchants using ramp intents, use this endpoint to create a buy checkout tied to an existing intent. ### Endpoint ``` POST /payment/api/v1/on-ramp/buy/checkout ``` ### Body Parameters ### Sample Request ```json { "intentId": "ri_1710345678000_a1b2c3d4e5f6g7h8", "cryptoCurrency": "USDT", "chain": "tron", "fiatCurrency": "USD", "fiatAmount": 100, "cryptoAmount": 98.5, "rate": 1.0, "totalFee": 1.5 } ``` ### Response (200 OK) ```json { "success": true, "data": { "intentId": "ri_1710345678000_a1b2c3d4e5f6g7h8", "paymentIntentId": "pi_abc123def456", "checkoutUrl": "https://checkout.zenpayz.com/pay/pi_abc123def456", "fiatAmount": 100, "fiatCurrency": "USD", "cryptoAmount": 98.5, "cryptoCurrency": "USDT", "chain": "tron", "rate": 1.0, "expiresAt": "2026-03-15T10:00:00.000Z" }, "message": "Buy checkout created" } ``` ### Response Fields ## Next Steps - [Transaction Status](/docs/rest-api/endpoints/ramp/transaction-status) -- Poll transaction progress - [Buy Quotes](/docs/rest-api/endpoints/ramp/buy-quotes) -- Get quotes before checkout - [Wallet Addresses](/docs/rest-api/endpoints/ramp/wallet-addresses) -- Understand wallet resolution