API reference

This API will allow you to start a Glider campaign or batch.
After calling the API: the recipient records will be validated, a unique URL will be generated for each valid recipient and an email campaign will be sent (or scheduled for later, if specified)

Requirements

A recipient record must contain the following values:

  • account_number: user identifier
  • email: user email address
  • amount: invoice amount value
ParameterDescriptionExample
recipientsObject with the recipient records and their attributes[
{
"email": "[email protected]",
"name": "John Doe",
"account_number": "22222",
"amount": 5000,
"company_name": "Green Energy",
"reference": "5353-XXXX",
"discount": "75%",
"custom1_label": "Due Date",
"custom1_value": "10/10/2020",
"planRate": 2.54,
"planMaxTerm": 10
},
{
"email": "[email protected]",
"name": "Mark Blue",
"account_number": "22111",
"amount": 3500,
"company_name": "Blue Gas",
"reference": "5232-XXXX",
"discount": "15%",
"custom1_label": "Due Date",
"custom1_value": "08/11/2020"
}
]
nameGlider campaign name (must be unique)GLIDER Campaign 0002
templateSubjectEmail Subject content (see above paragraph for more details)Email Campaign - Payment Request for {{account_number}}
templateBodyEmail Body content (see above paragraph for more details)<html><body><h2>Good morning {{name}}</h2>Please click on the button below to make your payment<br/>REFERENCE NO.: {{account_number}}<br/>AMOUNT: {{amount}}<br/><a href='{{url}}' class='btn'>Pay Now</a></body></html>
scheduledTime(optional) Date time (UTC) when you want your campaign to be delivered. Format: YYYY-MM-DD HH:mm:ss2020-10-30 10:20:00
handler(optional) Agent ID to be stored for reporting as part of the campaignAgent1
period(optional) Minutes to throttle the campaign on (e.g.: 300 - the campaign reminders will be evenly throttled to spread across 5 hours)300
isInstalment(optional, false by default) if true, the invoices created will give the ability to the user to choose between "pay now" or a tailored payment plantrue
portalTemplate(optional) Payment Portal Introduction text (see above paragraph for more details)<h2>{{name}}</h2><br>Your outstanding debt is managed by Glider.<br><br>Amount to pay<h3>{{amount}}</h3>
expiryTime(optional) Invoice TTL (in seconds) from the campaign scheduled time84600
planRate(optional) Annual interest rate if the campaign allows instalments, in percent (e.g.: 3.5% => 3.5)3.5
planMaxTerm(optional) Maximum length of the term (if max term period is not defined this value is intended in years)10
planMaxTermPeriod(optional) Defines the period/unit of the above value planMaxTerm, values accepted: day, week, month, yearmonth

This API request will return a successful response if at least one record in the CSV contains valid information.

Successful recipient records will be returned under the recipients JSON object.

Incorrect records will be listed under the errors JSON object, line and an error type will also be specified.

Successful responses will provide a batch identifier number batchId that can be used to retrieve batch status via the Report API.

Language
Click Try It! to start a request and see the response here!