Configure Webhooks

To configure your Webhooks, you need to provide Yuno's with:

  1. URL to receive notifications
  2. API_key (x-api-key) and API_secret (x-secret) from your side (with no format restrictions) for us to send in the notification header so your dev team can identify Yuno Webhooks.
  3. A name to identify each endpoint in the dashboard.

Once configured, you'll need to define which events you want to list for the enabled webhook. The webhook will be sent whenever one or more registered events occur, avoiding constant searches for answers.

You can configure different webhooks using the Yuno Merchant Dashboard. At the Developers tab, you can choose Webhooks. To create a new webhook, you need to name it, define the endpoint, and select the trigger event. The image below shows the side panel to add a webhook.

In the Yuno Merchant Dashboard Developers tab, you can activate and deactivate webhooks using the Status toggle button.

Access the Webhooks Examples page to check examples for payment and enrollment notification events.

Receipt confirmation process

Yuno webhooks expect to receive an HTTP 200 OK status as a response to indicate that the webhook was received. The merchant system response does not need to provide any information on the body request, only the HTTP 200 status. In case of not receiving a response at the specified time, Yuno webhooks will send the event notification up to seven times to avoid information loss. The table below presents the webhooks notification schedule and the confirmation waiting time.

EventDeadline after the first tryConfirmation waiting time
First try-23 seconds
Second try5 minutes7 seconds
Third try50 minutes7 seconds
Fourth try6 hours7 seconds
Fifth try24 hours7 seconds
Sixth try48 hours7 seconds
Seventh try96 hours7 seconds

Webhooks event types

Depending on the type of event, you will receive a different type of webhook and event. The next table presents the possible event types for enrollments and payments currently available.

typetype_event
enrollmentenroll
enrollmentunenroll
enrollmentexpiration
paymentpurchase
paymentauthorize
paymentcapture
paymentrefund
paymentcancel
paymentverify
paymentchargeback
payoutpayout