Use webhooks when you want ReceiptRoller to automatically notify an external system whenever something happens on the Receipt Roller side. No polling is required — you receive events in real time.

Registering a webhook

• Open "Developer" → "Webhooks" from the organization management screen
• From "Register New," enter the receiving URL (HTTPS required) and select the events you want to receive
• A secret for signature verification will be issued, so be sure to save it

Main events

• Sales/order events (new sales, refunds, cancellations)
• Receipt events (electronic receipt issued, downloaded)
• Product/inventory events (price changes, stock changes)
• Store/staff events (store added, staff added/removed)

Implementation points on the receiving side

• Validate the signature header that is sent (to prevent spoofing)
• Return a 2xx response promptly. We recommend performing processing asynchronously
• Failed deliveries are automatically retried. Make your processing idempotent

Detailed developer information

For payload specifications for each event, sample signature verification code, retry intervals, and more, see the developer help.

https://receiptroller.io/en/developer/help

Related articles

• Developer API overview
• API reference