Skip to Main Content

API Reference

Bango-Initiated Entitlement Notifications to Reseller

Bango uses notifications to tell you about changes to your entitlements whether merchant- or reseller-initiated. Use these notifications to ensure your records stay in sync with Bango’s entitlement state.

Notifications are sent to the notificationUrl you included in the create entitlement request. We do not add any parameters to the URL or change it in any way, so each notificationUrl should include your own identifier for the entitlement. To guarantee delivery, notifications may be sent more than once.

Requests to the given notificationUrl can be secured in a number of ways:

  • Basic Auth – a secure username and password
  • API key – a secure string known to both you and Bango, and transmitted either:
    • in an Authorization header, prefixed with the keyword Bearer
    • in an X-Api-Key header
  • OAuth2 – a secure access token retrieved from a trusted authorization server by username and password and transmitted in an Authorization header, prefixed with the keyword Bearer