How to configure webhooks

Generate a secret key

Start by generating a webhook secret. Every Loop webhook request will include a loop-signature header which contains a signature that you can verify to make sure the request came from Loop. The signature is encoded using your webhook shared private key. Please verify this signature before acting on the request in your system.

Set webhook destination and select events

Using the create webhooks endpoint, you can set the URL destination using the postURL parameter and selecting the events you wish to trigger using the events parameter. You can retrieve a list of all the available webhooks using the list webhooks endpoint.

Available webhooks

Name	Return	Description
payin.processed	create payin response + paidDate (unix timestamp)	Triggered when a payment confirms onchain.
missed_payin.payment	create payin response + missedReason ("Insufficient token balance" and/or "Insufficient token authorization")	Triggered 10 minutes after the due date for the payin has passed. If the payin is processed within that 10 minute window, no missed payment notification will be sent.