Webhooks

Architecture and functionality: Webhooks

The section on how a project learns about a payment.

1. Statuses

A table of payment statuses: pending, paid, failed, expired and refunded, with the events that accompany them.

2. Headers

When a payment is paid, Somonly sends a POST to the project's Webhook URL with the X-Somonly-Event, X-Somonly-Delivery and X-Somonly-Signature headers, the last being an HMAC-SHA256 of the request body.

3. Example

Below is a full payment.paid webhook example: the project, order number, amount, currency, bank and payment time.