Externally-Managed Purchases - Recurring Billing

šŸ‘

Check our Reference Materials for more details about a payment connector.

Recurring billing as part of Externally-Managed Purchases means that a subscription is created and managed outside of Cleeng, for example inside either a given payment gateway or the Broadcasterā€™s billing engine.

It is then gateway-specific how to notify the connector about successful/failed payment attempts or subscription status changes (e.g. new payment, refund, or subscription termination).

How to set up listeners in the connector to receive status change notifications?

A listener is an endpoint in the connector to which payment gateway notifications are sent.

You need to create an endpoint and register its URL within the payment gateway so that notifications will be sent there. You might create one endpoint for all notifications or one endpoint for each message type, depending on what a payment gateway allows.

After a gateway notification is received by the connector it must call appropriate Payment API endpoints to notify Cleeng about the changes. For example, if a notification about a successful payment capture is received by the connector, it should call POST /3.1/payments to create a captured payment.

Externally-Managed recurring Billing

Externally-Managed Recurring Billing

For smooth integration, Cleeng should be informed about the following:

šŸ“˜

Note

It is important that notifications are set up in such a way that all the events that happen on the payment gateway are also registered at Cleeng.