On This Page
Notifications
The new Recurring Billing service supports two customer notification methods: email and
webhooks. You can configure one or both notification methods.
Email Notifications to Customers
Notifications are sent automatically to the email address associated with the customer
token. They contain information from the plan and subscription details for a prepayment,
successful payment, or failed payment. Sending these notifications can be disabled in the
Recurring Billing settings.
Webhook Notifications to Merchants
Cybersource
offers a Webhooks REST API that you can use to receive notifications about
Recurring Billing events. Webhooks are automated notifications that are sent to you when
specific system events occur. By using the Webhooks REST API, you can subscribe to receive
these notifications for events of your choice and designate a URL in your system to receive
the notifications. You can configure your system to respond to the events in any way you
choose. This is helpful for events that are not a part of an API request and response, or
are not available through the Reporting API. For more information, see the Webhooks Implementation Guide.Create and manage webhook subscriptions for the Recurring Billing event types listed
in the table. In the webhooks request message, set the
productId
API
field to recurringBilling
. Set the eventTypes
API field
to one of the values listed in the Event Type column of the table.Product ID | Event Type | Description |
|---|---|---|
recurringBilling | rbs.subscriptions.charge.failed | Notifies the customer of a recurring payment failure. |
rbs.subscriptions.charge.pre-notified | Notifies the customer of an upcoming recurring
payment. | |
rbs.subscriptions.charge.created | Notifies the customer of a successful recurring
payment. |
You can use webhooks to customize your customer notifications. For more information,
go to the
Cybersource
API Developer Center. In the left navigation pane,
select Platform Services
> Webhooks
>
Create Webhook Security Keys
. Use the webhook request builder and
live console to test example REST API requests.