Skip to main content

Setting up the webhooks

1. Expose endpoints on your server​

You can configure one or many endpoints on your side to receive webhooks. This allow you to route different events to different endpoints, or receive all the notifications in the same endpoint and then process them accordingly depending on the event_type.

Endpoints should:

  • Allow traffic from our domain nopan.com
  • Handle HTTP Post with a JSON body
  • Allow HTTPS traffic

2. Configure events to be received​

You can configure with events or notifications you want to receive from our Customer Portal.

  1. Go to Developers > Webhooks
  2. Select Add new webhook
  3. Add the full URL of your webhook
  4. Select the webhook you want to receive from the list

3. Processing webhooks​

With the previous configuration, you will receive requests to the URL provided when an event of the selected type occurs.

Webhook calls will be retried in case of errors up to 10 times within 24 hours to ensure the notification is received. Nopan expects a 2xx response if the webhook was successfully processed.

Best Practices
  • Do not perform business logic before returning 2xx.
  • Return any non 2xx codes if something is wrong with the notification format or content.
  • Use a persistence service on your side (database, queue, etc) to handle retries. Issues while applying business logic on your side might cause lost notifications after all retries are processed.
  • Verify HMAC signature to ensure the request is legitimate.