Hosted Checkout
iPint's pre-built, user-friendly hosted payment page for crypto payments.
Hosted Checkout
iPint's Hosted Checkout is a pre-built, user-friendly, hosted payment page for digital asset payments. It's the fastest way to start accepting payments — no frontend code required beyond a redirect.
How it works
Create a checkout session
Call
POST /checkoutwith the payment details. You'll receive apayment_process_urland asession_id.Redirect your customer
Send your customer to the
payment_process_url. This opens iPint's checkout page where they'll complete the payment.Customer selects an asset
Your customer picks which cryptocurrency to pay with from the supported list.
Customer enters amount
If you didn't pass an amount in the
/checkoutcall, the customer enters it here. The exchange rate is locked at this point.Customer pays via QR
iPint generates a QR code. The customer scans it with their wallet, or copies the address and amount manually. On mobile, they can tap "Open in wallet" to launch their wallet app with details pre-filled.
Customer confirms
After paying, the customer clicks "Paid & Confirm". They're redirected back to your
merchant_website.iPint sends a callback
When payment succeeds or fails, iPint sends a POST to your
invoice_callback_url. Use this as a trigger to verify the payment viaGET /invoice.
Example
const response = await fetch(
"https://api.ipint.io:8003/checkout",
{
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_email_id: "customer@email.com",
client_preferred_fiat_currency: "USD",
amount: "25.00",
merchant_website: "https://yoursite.com/thank-you",
invoice_callback_url: "https://yoursite.com/webhook"
}),
}
);
const { payment_process_url, session_id } = await response.json();
// Redirect your customer
window.location.href = payment_process_url;Parameters
| Parameter | Required | Description |
|---|---|---|
client_email_id | Yes | Customer's email address |
client_preferred_fiat_currency | Yes | Customer's fiat currency (e.g. USD) |
amount | No | Payment amount. If omitted, customer enters it on the checkout page |
merchant_website | Yes | URL to redirect to after payment completes |
invoice_callback_url | Yes | Your webhook URL for payment status updates |
The session_id returned is the same as the invoice_id you'll receive in
webhook callbacks. Use it to correlate the checkout session with payment status.
Next steps
- POST /checkout reference — full endpoint details
- Check payment status — verify payments server-side
- Webhooks — callback payload reference