Getting StartedLive
Developer Quickstart
Create a checkout session, redirect your customer, and confirm payment with webhooks.
Integration flow
Start with an approved Live API key, create a checkout session from your server, redirect the customer to the returned checkoutUrl, and listen for webhook events before updating your order.
1
Get your API key
Copy your approved Yera Live API key from the dashboard.
2
Create a checkout session
Use the API to create a hosted checkout session for your customer.
3
Redirect the customer
Send the customer to the checkoutUrl returned by the API.
4
Confirm payment
Use webhooks to receive real-time payment confirmation and update your order status.
Create a checkout session
The public merchant API currently runs under the app host at /api/v1. Yera API keys must be sent from your server using Bearer authentication.
Create session
curl -X POST https://app.yeraconnect.io/api/v1/checkout/sessions \
-H "Authorization: Bearer yera_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"amount": 250,
"currency": "EUR",
"destinationAsset": "USDC",
"network": "polygon",
"countryCode": "DE",
"customerEmail": "customer@example.com",
"merchantOrderId": "ORDER-1001",
"successUrl": "https://merchant.com/success",
"cancelUrl": "https://merchant.com/cancel",
"webhookUrl": "https://merchant.com/webhooks/yera"
}'Production readiness
- Only yera_live_ keys authenticate new requests.
- Historical Test credentials cannot be reused.
- Yera plugins register webhooks automatically; custom integrations can manage webhook endpoints in the dashboard.
- Do not mark merchant orders paid from frontend redirects.