DevelopersPreview
Webhooks
Receive payment, checkout, and settlement changes on your server.
Events
Yera Connect normalizes payment events so merchant systems can update orders after backend confirmation.
- checkout.created
- checkout.expired
- payment.pending
- payment.completed
- payment.failed
- settlement.processing
- settlement.completed
- settlement.failed
Signature headers
Webhook payloads should be verified with the raw request body and your webhook signing secret.
Webhook payload
{
"event": "payment.completed",
"eventId": "evt_123456",
"paymentId": "yc_pay_987654",
"checkoutSessionId": "yc_chk_123456",
"merchantOrderId": "ORDER-1001",
"amount": 250,
"currency": "EUR",
"status": "completed"
}Headers
- Yera-Signature: sha256=...
- Yera-Timestamp: 1760000000000
- Yera-Event-ID: evt_123456