Getting StartedLive
Developer Quickstart
Create a checkout session, redirect your customer, and confirm payment with webhooks.
Integration flow
Start with a sandbox 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
Create a sandbox API key from the Yera Connect 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. Secret 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_test_sk_your_secret_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
- Use yera_test_sk_ keys for sandbox and test integrations.
- Use yera_live_sk_ keys only from production server code.
- Configure webhook URLs before going live.
- Do not mark merchant orders paid from frontend redirects.