Hosted checkout

Hosted checkout lets Yera Connect manage the customer payment page.

The merchant creates a checkout session, sends the customer to the Yera hosted checkout URL, and then receives payment status updates through the dashboard and webhooks.

How it works

1. Merchant creates a checkout session.
2. Yera Connect returns a checkout URL.
3. Customer opens the hosted checkout page.
4. Customer completes payment.
5. Yera Connect records the result and sends webhooks.

What the merchant backend should send

A hosted checkout request usually includes:

1. Amount
2. Fiat currency
3. Customer email
4. Internal order ID
5. Callback or return URL
6. Webhook metadata
7. Checkout description
8. Selected payment or settlement preferences if supported

Keep enough metadata to match the Yera payment session back to the merchant order.

Use hosted checkout when

1. You want a fast integration.
2. You do not want to build your own payment UI.
3. You need customer redirects and payment status tracking.
4. You use a custom ecommerce backend.

Customer redirect behavior

After checkout, the customer should return to a merchant success, pending, or failure page.

The return page is useful for customer communication, but the merchant backend should still rely on webhooks for final payment status.

Do not treat a browser redirect alone as proof of payment.

Merchant checklist

Before using hosted checkout live:

1. Create server-side API keys.
2. Store secret keys securely.
3. Create checkout sessions from the backend.
4. Store Yera session IDs with internal order IDs.
5. Configure webhook delivery.
6. Test success, failed, pending, and expired flows.
7. Confirm the dashboard shows the sessions and transactions.