Events

Cloud Elements currently supports events via polling or webhooks depending on the endpoint.

• Polling is a mechanism where Cloud Elements executes the configured query every n minutes and captures the changed information.
• Webhooks are when the provider lets Cloud Elements know what information has changed. Note that additional endpoint setup may be required prior to creating your Element Instance.

If you would like to see more information on our Events framework, please see the Event Management Guide.

Set Up Events for Zuora

The Zuora element supports webhooks. For Zuora events to work with Cloud Elements, you must configure each element instance and set up the endpoint.

Set up the Cloud Elements instance

To enable events, add these extra configurations to your instance JSON:

"event.notification.enabled": "true",
"event.notification.callback.url": "<INSERT_YOUR_APPS_CALLBACK_URL>"

instance JSON with polling events enabled:

{
  "element": {
    "key": "zuorav2"
  },
  "configuration": {
    "zuorav2.sandbox": false,
    "username": "zuora_user",
    "password": "password",
    "event.notification.enabled": true,
    "event.notification.callback.url": "<INSERT_YOUR_APPS_CALLBACK_URL>"
  },
  "tags": [
    "<Add_Your_Tag>"
  ],
  "name": "<Insert_Instance_Name>"
}

Note: To instantiate a sandbox account, set zuorav2.sandbox to false.

Record your Instance ID

To set up the event in Zuora, you need the instance ID associated with your event.

• To find the Instance ID via API, call GET elements/zuorav2/instances:

  curl -X POST
  -H 'Authorization: User <INSERT_USER_SECRET>, Organization <INSERT_ORGANIZATION_SECRET>'
  -H 'Content-Type: application/json'
  'https://staging.cloud-elements.com/elements/api-v2/elements/zuorav2/instances'
  

• To find the Instance ID in the user interface, go to Elements > My Instances:

Set Up the Endpoint

Zuora refers to webhooks as callout notifications. When setting up events, refer to the Zuora documentation: Configure Callout Notifications.

To set up the Zuora endpoint:

1. Log in to Zuora and navigate to the Billing, Payments, or Finance settings.
2. Click the Setup Profiles, Notifications, and Email Templates link.
3. Notifications should appear by default, but if not, click Notifications at the top.
4. Locate the callout notifications that you want to use as an event, and then click the Edit link associated with it.
5. Select the Active check box to activate the event.
6. In Base URL, add the URL to the Cloud Elements events API, and append your Instance ID. For example, 'https://cloud-elements.com/elements/api-v2/events/zuorav2/'
7. Click add parameter to add the following required parameters:
   • Event.Category
   • Event.Date
8. Click Save.