Introduction

With our API it is possible to create PayLinks, e-Mandates and import records for our scripts. To use the PayLink and e-Mandate service, additional configuration and setup are required. Please contact our customer support if you would like to use additional services.

Please also read our Import and Result Data formats document.

GraphQL

Our API is written in GraphQL. On How To GraphQL you can read the fundamentals. Creating PayLinks should be as easy as using a REST API. We have added some examples of how to use our API with a GraphQL Client.

To explore our API and its documentation you could use the Altair GraphQL Client. This client has the option to set the required authentication header. Watch this demo video to view how to use the built-in documentation browser.

Alphacomm > Collectmaxx API > image-20210413-095328.png

Example collection for Altair

To explore our API and view all available fields, import the following collection to the Altair Client and update the header with your API key.

API endpoint

https://reminders.alphacommapi.com/v1

note

Our API is behind load balancers so an IP change is possible at any time.

Test endpoint

Contact us for the test endpoint and credentials.

API Keys

You will need an access key to connect to our API. Your keys can be managed through our portal. At the portal go to "Account → API keys". You must be a portal manager for your company to access this page.

Key usage

For each request set the "X-AUTH-TOKEN" HTTP header with your key.

Key IP restriction

It is possible to allow keys to only work from certain IP addresses.

127.1.1.1
192.1.0.0/32

Code example

We created one request example in PHP to get you started.

APIs

Through our API we provide multiple services. The requirements for fields are defined in the API itself. Use a GraphQL client to view the documentation. In this document, we will give you some examples to get started.

note

All the dates fields in our responses are formatted in RFC 3339, 'Y-m-d\TH:i:sP'.

Import

The import API is an alternative for our batch SFTP (CSV) import. Through this endpoint, you are able to import records. The records are batched and visible in the portal on the import page.

When sending records to our API, we still starting import the records according to your account’s Import schedule. These import windows are visible at your upload page.

The reminder results are reported at the end of the day in one or multiple result files, grouped by script. For more information see our Import and Result Data formats document.

Required fields

The scripts that are set up in our portal may be set up for voice messages, text messages or emails, that optionally contain a PayLink or e-Mandate. Each script has its own set of required fields.

When a new script is set up we will provide a list of required fields. You can also use our matrix of required fields for medium and services.

Status codes

More information about status codes, which are used at the portal and the API.

Batch statuses

Name	Description
empty	No records added to this batch yet.
queued	Records are waiting to be processed.
running	Records are being processed.
done	Records have finished processing.
error	Something went wrong.

Record statuses

Name	Description
notLoaded	Records that could not be read.
loaded	Records that have been read.
rejected	Records that could not be converted into a job.
accepted	Records that could be converted into a job.
enriching	Records that are currently enriching.
created	Records that have created a new job.
updated	Records that have updated an existing job.
dropped	Records that could not be saved to the database.

Input options

Through the 'addRecords' mutation you are able to add records.

Argument

Description

When to use

rows [RowInput!]

An endpoint that has a preset of fields.

This is the preferred way to deliver your records and usable in most cases.
Use this option for small batches or loose records.

file [FileInput!]

Base64 encoded file.

For example: csv, xml, xlsx, xls, ods.

For large batch import, 1000 or more.
Or when your script requires fields that are not available at the RowInput.

If you have questions please contact us.

Examples

When we set up a new script we will inform you about the required fields.

Row Input

This is an example of a mail with PayLink record using the RowInput.

Query body

mutation addRecords (
  $file: FileInput,
  $rows: [RowInput!]
) {
  import {
    addRecords(file: $file, rows: $rows) {
      name
      action
      status
      records {
        scriptId
        status
        reference
        messages {
          context
          message
          level
        }
      }
    }
  }
}

Variables

{
    "rows": [
      {
        "reference": "f0e7a0c3",
        "script": "1001",
        "personFamilyName": "Alphacomm",
        "toMailAddress": "reminders@alphacomm.nl",
        "toPhoneNumbers" => [
         "+31612345678",
        ],
        "invoiceDescription": "Example payment",
        "invoiceDate": "2019-04-04",
        "invoiceDueDate": "2019-07-30",
        "invoiceReference": "40824524",
        "invoiceCurrency": "EUR",
        "invoiceAmount": "56445",
        "invoiceNumber": "249075245",
        "personBirthDay": "2000-01-01"
      }
    ]
}

Response

note

We only return the records that were send during the request. This makes it easier to validate if added records are accepted, using the record’s reference.

{
  "data": {
    "import": {
      "addRecords": {
        "name": "20190403-965",
        "action": "IMPORT",
        "status": "done",
        "records": [
          {
            "reference": "f0e7a0c3",
            "scriptId": "1001",
            "status": "accepted",
            "messages": []
          }
        ]
      }
    }
  }
}

File Input

This is an example with FileInput. Your file should be sent as a Base64 encoded string. An imported file will always respond with a status queued. The slight delay is deliberate because we need time to process all records. It is possible to send a second request to get the status of the batch.

Query body

mutation addFile (
  $file: FileInput,
  $rows: [RowInput!]
) {
  import {
    addRecords(file: $file, rows: $rows) {
      name
      action
      status
    }
  }
}

Variables

{
  "file": {
   "extension": "csv",
   "contents": "<<BASE64 ENCODED STRING>>"
  }
}

Response

note

When a file is imported we will always respond with a status queued. Bacause we need some time to process the file.

{
  "data": {
    "import": {
      "addRecords": {
        "name": "20190404-579",
        "action": "IMPORT",
        "status": "queued",
        "records": []
      }
    }
  }
}

Search batches

This is an example of searching for a batch by name.

Query body

query ImportSearch(
  $filters: BatchFiltersInput
) {
  import {
    batches(
      filters: $filters
    ) {
      items {
        name
        action
        status
      }
      pagination {
        offset
        limit
        total
      }
    }
  }
}

Variables

{
  "filters": {
    "name": {
      "equalTo": "Test"
    }
  }
}

Response

{
  "data": {
    "import": {
      "batches": {
        "items": [
          {
            "name": "Test",
            "action": "VALIDATE",
            "status": "empty"
          }
        ],
        "pagination": {
          "offset": 0,
          "limit": 20,
          "total": 1
        }
      }
    }
  }
}

PayLink

To use this service we need to configure your iDEAL bank credentials and set up a landing page. Please contact us if you would like to use this service.

Status codes

Name	Description
ready	PayLink is created in our service.
started	Transaction has been started.
partially_paid	A part of the original PayLink amount is paid.
paid	The complete PayLink amount is paid.
cancelled	The last transaction of the PayLink has been cancelled.
failed	The last transaction of the PayLink has failed.

Examples

To make your start easier we have added some examples of common actions.

Keep in mind to use the POST method on all your request.

Create PayLink

When using GraphQL you have the ability to define what fields you get in the response. For this example, we only want the id of the created PayLink and the URLs.

Query body

mutation createPayLink($payLink: PayLinkInput!){
  payLink {
    create (payLink: $payLink) {
      attributes { id value }
      id
      shortUrl
      longUrl
    }
  }
}

Variables

This is the minimal information we need to create a PayLink.

Us the field visibleUntil to set the date when payment should not be possible anymore.

note

By default, the PayLink expires 90 days after the date of creation.

{
   "payLink": {
    "attributes": [
      {"id": "source", "value": "whatsapp"}
    ],
    "personName": "Alphacomm",
    "invoiceAmount": "15497",
    "invoiceCurrency": "EUR",
    "invoiceDescription": "Example",
    "invoiceReference": "103482",
    "invoiceDate": "2019-02-12T10:00:00+00:00"
  }
}

Response

{
  "data": {
    "payLink": {
      "create": {
        "attributes": [
          {
            "id": "customer_source",
            "value": "whatsapp"
          },
          {
            "id": "origin",
            "value": "api"
          }
        ],
        "id": "a62c3726-d3b2-4b8c-8e4c-48ee0fd9451c",
        "shortUrl": "https://ibanaccept.com/u8t1nbw",
        "longUrl": "https://alphacomm.ibanaccept.com/pay/a62c3726-d3b2-4b8c-8e4c-48ee0fd9451c"
      }
    }
  }
}

Simple PayLink search

A basic search on all PayLinks.

Query body

query {
  payLink {
    payLinks {
      items {
        status
        id
      }
      pagination {
        offset
        limit
        total
      }
    }
  }
}

Variables

No variables are needed for this query.

{}

Response

{
  "data": {
    "payLink": {
      "payLinks": {
        "items": [
          {
            "status": "paid",
            "id": "a6e8b63c-927f-476b-8d47-d323e20e1a4f"
          },
          {
            "status": "cancelled",
            "id": "348bd90d-da76-4211-93c3-601cbb15f33a"
          },
          {
            "status": "ready",
            "id": "389f0187-6b5d-4896-8d78-e56a6bb1a156"
          }
        ],
        "pagination": {
          "offset": 0,
          "limit": 20,
          "total": 3
        }
      }
    }
  }
}

Find Single PayLink

An example of how to get the status of a single PayLink.

Query body

query PayLinks(
  $filters: PayLinkFiltersInput
) {
  payLink {
    payLinks (
      filters: $filters
    ) {
        items {
          id
          personName
          personGender
          status
          amountPaid
          createdOn
          updatedOn
        }
      }
    }
}

Variables

{
  "filters": {
    "id": {
      "equalTo": "5be41c4f-9fe6-403d-980b-5edc0139ee70"
    }
  }
}

Response

{
  "data": {
    "payLink": {
      "payLinks": {
        "items": [
          {
            "id": "5be41c4f-9fe6-403d-980b-5edc0139ee70",
            "personName": "Demo",
            "personGender": "U",
            "status": "paid",
            "amountPaid": 0,
            "createdOn": "2019-02-05T09:57:14+00:00",
            "updatedOn": "2019-02-05T09:57:14+00:00"
          }
        ]
      }
    }
  }
}

Search PayLink with record identifer

PayLinks can not only be created through our API but also though the import to our scripts. In this last case the PayLink is delivered by us via email or SMS.

During a record import you are required to define the ‘idenfification_identifier' or also called 'reference’. In case you want to know what the current status of the PayLink is your are able to search our PayLink service with this reference.

Query body

query PublicApiPayLinks(
  $filters: PayLinkFiltersInput
  $order: PayLinkOrderInput
  $offset: Int
  $limit: Int
) {
  payLink {
    payLinks (
      filters: $filters
      order: $order
      offset: $offset
      limit: $limit
    ) {
        items {
          attributes {
            id
            value
          }
          id
          personName
          personGender
          status
        }
      }
    }
}

Variables

{
  "filters": {
    "attributes": [
      {
      	"id": "reference",
      	"equalTo": "20220216-6"
    	}
    ]
  }
}

Response

{
  "data": {
    "payLink": {
      "payLinks": {
        "items": [
          {
            "attributes": [
              {
                "id": "origin",
                "value": "sms"
              },
              {
                "id": "script",
                "value": "1003"
              },
              {
                "id": "reference",
                "value": "20220216-6"
              }
            ],
            "id": "42c949b9-5945-4273-912d-00f5563df1fd",
            "personName": "Alphacomm",
            "personGender": "M",
            "status": "ready"
          }
        ]
      }
    }
  }
}

Advanced PayLink search

An example of how to find all PayLinks with the status paid created on 08-02-2019.

You have the option to set filters, order, offset and limit. All the options are defined in the API docs.

Query body

query PayLinks(
  $filters: PayLinkFiltersInput
  $order: PayLinkOrderInput
  $offset: Int
  $limit: Int
) {
  payLink {
    payLinks (
      filters: $filters
      order: $order
      offset: $offset
      limit: $limit
    ) {
        items {
          id
          personName
          personGender
          status
          amountPaid
          createdOn
          updatedOn
        }
        pagination {
          offset
          limit
          total
        }
      }
    }
}

Variables

{
  "filters": {
    "status": {
      "equalTo": "paid"
    },
    "createdOn": {
      "greaterThan": "2019-02-08T00:00:00+00:00",
      "lesserThan": "2019-02-09T00:00:00+00:00"
    }
  },
  "order": {
    "createdOn": "DESCENDING"
  },
  "offset": 0,
  "limit": 20
}

Response

{
  "data": {
    "payLink": {
      "payLinks": {
        "items": [
          {
            "id": "5be41c4f-9fe6-403d-980b-5edc0139ee70",
            "personName": "Demo",
            "personGender": "U",
            "status": "paid",
            "amountPaid": 0,
            "createdOn": "2019-02-05T09:57:14+00:00",
            "updatedOn": "2019-02-05T09:57:14+00:00"
          },
          {
            "id": "96f3cf79-98ab-43d1-80ca-fa5c9fccab23",
            "personName": "Test Person",
            "personGender": "U",
            "status": "paid",
            "amountPaid": 0,
            "createdOn": "2019-02-01T14:49:35+00:00",
            "updatedOn": "2019-02-01T14:49:36+00:00"
          }
        ],
        "pagination": {
          "offset": 0,
          "limit": 0,
          "total": 2
        }
      }
    }
  }
}

E-Mandate

To use this service we need to configure your e-Mandate bank credentials and setup a landing page. Please contact us if you would like to use this service.

Status codes

Name	Description
new	Mandate is created on our service.
pending	Waiting for second authorization.
success	Mandate is given.

Examples

To make your start easier we have added some examples of common actions.

Keep in mind to use the POST method on all your request.

Create Mandate

When using GraphQL you have the ability to define what fields you get in the response. For this example, we only want the id, reference, URLs and type.

Query body

mutation createMandate($mandate: MandateInput!){
  mandate {
    create (mandate: $mandate) {
      id
      reference
      shortUrl
      longUrl
      type
    }
  }
}

Variables

Example values.

{
  "mandate": {
    "personName": "Alphacomm",
    "reference": "AC-HUUR"
    "type": "RCUR",
    "reason": "huur",     
    "debtorReference": "20190301"
  }
}

Response

{
  "data": {
    "mandate": {
      "create": {
        "id": "4442ddf6-7371-4e6a-8939-087f8fd3b17c",
        "reference": "AC-HUUR",
        "shortUrl": "https://betaalmachtiging.nl/akps797",
        "longUrl": "https://alphacomm.betaalmachtiging.nl/pay/94e592f0-9f21-4404-bdfe-a6e51c6bf547",
        "type": "RCUR"
      }
    }
  }
}

Simple Mandate search

A basic search query for all Mandates.

Query body

query {
  mandate {
    mandates {
      items {
        status
        id
      }
    }
  }
}

Variables

No variables are needed for this query.

{}

Response

{
  "data": {
    "mandate": {
      "mandates": {
        "items": [
          {
            "status": "new",
            "id": "a6e8b63c-927f-476b-8d47-d323e20e1a4f"
          },
          {
            "status": "pending",
            "id": "348bd90d-da76-4211-93c3-601cbb15f33a"
          },
          {
            "status": "success",
            "id": "389f0187-6b5d-4896-8d78-e56a6bb1a156"
          }
        ]
      }
    }
  }
}

Find Single Mandate

An example of how to get the status of a single Mandate.

Query body

query Mandates(
  $filters: MandateFiltersInput
) {
  mandate {
    mandates (
      filters: $filters
    ) {
        items {
          id
          personName
          status
          createdOn
          updatedOn
        }
      }
    }
}

Variables

{
  "filters": {
    "id": {
      "equalTo": "5be41c4f-9fe6-403d-980b-5edc0139ee70"
    }
  }
}

Response

{
  "data": {
    "mandate": {
      "mandates": {
        "items": [
          {
            "id": "5be41c4f-9fe6-403d-980b-5edc0139ee70",
            "personName": "Demo",
            "status": "success",
            "createdOn": "2019-02-05T09:57:14+00:00",
            "updatedOn": "2019-02-05T09:57:14+00:00"
          }
        ]
      }
    }
  }
}

Advanced Mandate search

An example of how to find all e-Mandates with the status success, created on 08-02-2019.

You have the option to set filters, order, offset and limit. All the options are defined in the API docs.

Query body

query Mandates(
  $filters: MandateFiltersInput
  $order: MandateOrderInput
  $offset: Int
  $limit: Int
) {
  mandate {
    mandates (
      filters: $filters
      order: $order
      offset: $offset
      limit: $limit
    ) {
        items {
          id
          personName
          status
          createdOn
          updatedOn
        }
        pagination {
          offset
          limit
          total
        }
      }
    }
}

Variables

{
  "filters": {
    "status": {
      "equalTo": "success"
    },
    "createdOn": {
      "greaterThan": "2019-02-08T00:00:00+00:00",
      "lesserThan": "2019-02-09T00:00:00+00:00"
    }
  },
  "order": {
    "createdOn": "DESCENDING"
  },
  "offset": 0,
  "limit": 20
}

Response

{
  "data": {
    "mandate": {
      "mandates": {
        "items": [
          {
            "id": "5be41c4f-9fe6-403d-980b-5edc0139ee70",
            "personName": "Demo",
            "status": "success",
            "createdOn": "2019-02-05T09:57:14+00:00",
            "updatedOn": "2019-02-05T09:57:14+00:00"
          },
          {
            "id": "96f3cf79-98ab-43d1-80ca-fa5c9fccab23",
            "personName": "Test Person",
            "status": "success",
            "createdOn": "2019-02-01T14:49:35+00:00",
            "updatedOn": "2019-02-01T14:49:36+00:00"
          }
        ],
        "pagination": {
          "offset": 0,
          "limit": 0,
          "total": 2
        }
      }
    }
  }
}

Voice

To use this service we need to configure a voice script. Please contact us if you would like to use this service.

Examples

To make your start easier we have added some examples of common actions.

Stop Calling

Use this action to remove any leftover scheduled voice calls, related to the specified scriptId and reference.

Query body

mutation stopCalling(
  $scriptId: Int!
  $reference: String!
){
  voice {
    stopCalling (
      scriptId: $scriptId
      reference: $reference
    )
  }
}

Variables

{
  "scriptId": 18301,
  "reference": "your_identifier"
}

Response

{
  "data": {
    "voice": {
      "stopCalling": "done"
    }
  }
}

Webhook events

We are working on adding more events and improving the information in the payload. So the content of the data might change.

We can authenticate to your webhook with basic access authentication. At the moment we need to configure your webhook URL.

Voice

Via our webhook you will get information about all the call actions we do for the record given to us. In a regular setup, this means you might get a busy call result in the morning and the afternoon a successful one, because at that moment the phone call was answered.

Call completed

Field

Format

datetime
string

When the event occurred

RFC3339
2023-10-12T07:20:50.52Z

id
string

Identifying the call.

UUID

d670a4af-8562-4d5f-ae30-5cc36acf82ee

serviceId
string

Identifier of the Call Request.

UUID

a2654d8a-3f8d-402e-a03b-980953802a09

service
string

voice
To indicate this is a voice event.

voice

reference
string

Identifier used during import, also known as identification_identifier

20220908-1547471

event
string

VoiceCallCompleted

data
array

Contains the details of the call.

See Data table below.

Data

direction
string

Call direction

ENUM DIRECTION

  outbound
  inbound

status
string

The call status

ENUM STATUS

  ringing
  active
  finished
  no answer
  busy
  rejected
  invalid number
  failed

localNumber
string

The phone number we use when calling

E.164

remoteNumber
string

E.164 or anonymous

events
array

Array of events during the call,
contains the following fields

nodeId: string, node identifier
nodeType: string, ENUM NODETYPE
order: int, event order
type: string, ENUM EVENTTYPE
data: array, data that is specific to the node type and event type
time: string, RFC3339

Empty array when call is not answered.

NODETYPE:
  AddResult
  CheckCallAttempt
  CheckCounter
  CheckGenderBirthday
  CheckVariable
  DTMF
  DTMFString
  Forward
  Hangup
  IsCallOutbound
  IsRemoteMobile
  IsRemoteVoiceMail
  IsTimeInInterval
  Sound
  WaitForSilence

EVENTTYPE:
  NodeStart
  NodeUpdate
  NodeResult

answeredOn
string

Empty if the call has not been answered

RFC3339 or empty
2019-10-12T07:20:50.52Z

How to determine a call has reached the success point

To determine a call was successful, a defined point in the voice message should be reached.

This is always an AddResult type node with a data result value success-ok

...
	"events": [
      {
        "nodeId": "success",
        "nodeType": "AddResult",
        "order": 16,
        "type": "NodeResult",
        "data": {
			"result": "success-ok"
        },
        "time": "2020-05-06T08:43:11+00:00"
      }
    ]
...

Use the NodeResult type with the data['result'] value when evaluating the events. The NodeId’s are more likely to change when altering voice script flows.

Example completed outbound call

{
  "datetime": "2022-09-08T14:22:52+00:00",
  "id": "f3e445ce-75ee-4c94-9d6d-370949664fd7",
  "serviceId": "f3e445ce-75ee-4c94-9d6d-370949664fd7",
  "service": "voice",
  "reference": "20231208-1547471",
  "event": "VoiceCallCompleted",
  "data": {
    "direction": "outbound",
    "status": "finished",
    "localNumber": "3225882397",
    "remoteNumber": "316123456789",
    "answeredOn": "2022-09-08T14:23:10+00:00",
    "events": [
      {
        "nodeId": "vm_beep",
        "nodeType": "Sound",
        "order": 1,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:13+00:00"
      },
      {
        "nodeId": "vm_beep",
        "nodeType": "Sound",
        "order": 2,
        "type": "NodeResult",
        "data": [],
        "time": "2022-09-08T14:23:16+00:00"
      },
      {
        "nodeId": "vm_wait_for_silence",
        "nodeType": "WaitForSilence",
        "order": 3,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:17+00:00"
      },
      {
        "nodeId": "vm_wait_for_silence",
        "nodeType": "WaitForSilence",
        "order": 4,
        "type": "NodeResult",
        "data": [],
        "time": "2022-09-08T14:23:18+00:00"
      },
      {
        "nodeId": "name",
        "nodeType": "Sound",
        "order": 5,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:18+00:00"
      },
      {
        "nodeId": "name",
        "nodeType": "Sound",
        "order": 6,
        "type": "NodeResult",
        "data": [],
        "time": "2022-09-08T14:23:20+00:00"
      },
      {
        "nodeId": "invoice_reference",
        "nodeType": "Sound",
        "order": 7,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:20+00:00"
      },
      {
        "nodeId": "invoice_reference",
        "nodeType": "Sound",
        "order": 8,
        "type": "NodeResult",
        "data": [],
        "time": "2022-09-08T14:23:22+00:00"
      },
      {
        "nodeId": "vmresult",
        "nodeType": "IsRemoteVoiceMail",
        "order": 9,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:22+00:00"
      },
      {
        "nodeId": "vmresult",
        "nodeType": "IsRemoteVoiceMail",
        "order": 10,
        "type": "NodeResult",
        "data": {
          "detected": "HUMAN",
          "outcome": "no"
        },
        "time": "2022-09-08T14:23:22+00:00"
      },
      {
        "nodeId": "text2",
        "nodeType": "Sound",
        "order": 11,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:22+00:00"
      },
      {
        "nodeId": "text2",
        "nodeType": "Sound",
        "order": 12,
        "type": "NodeResult",
        "data": [],
        "time": "2022-09-08T14:23:25+00:00"
      },
      {
        "nodeId": "success",
        "nodeType": "AddResult",
        "order": 13,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:25+00:00"
      },
      {
        "nodeId": "success",
        "nodeType": "AddResult",
        "order": 14,
        "type": "NodeResult",
        "data": {
          "result": "success-ok"
        },
        "time": "2022-09-08T14:23:25+00:00"
      },
      {
        "nodeId": "text3",
        "nodeType": "DTMF",
        "order": 15,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:25+00:00"
      },
      {
        "nodeId": "text3",
        "nodeType": "DTMF",
        "order": 16,
        "type": "NodeResult",
        "data": {
          "input": [
            "3"
          ],
          "outcome": "tone:3"
        },
        "time": "2022-09-08T14:23:31+00:00"
      },
      {
        "nodeId": "pre_send_sms",
        "nodeType": "Sound",
        "order": 17,
        "type": "NodeStart",
        "data": [],
        "time": "2022-09-08T14:23:32+00:00"
      },
      {
        "nodeId": "remote_hangup",
        "nodeType": "RemoteHangup",
        "order": 18,
        "type": "RemoteHangup",
        "data": [],
        "time": "2022-09-08T14:23:33+00:00"
      }
    ]
  }
}

Example completed outbound busy call

{
  "datetime": "2022-09-09T10:05:41+00:00",
  "id": "adbc180b-a494-477f-958d-9f0b050a09c3",
  "serviceId": "55b22bce-c0fe-43a0-a0f6-c684579e0452",
  "service": "voice",
  "reference": "20220908-3432",
  "event": "VoiceCallCompleted",
  "data": {
    "direction": "outbound",
    "status": "busy",
    "localNumber": "3225882397",
    "remoteNumber": "316123456789",
    "answeredOn": "",
    "events": []
  }
}

Example anonymous inbound call

Example message for an anonymous or not recognized inbound call

Someone may be calling from a phone number we cannot match to a record, or they have blocked their phone number.

In this case, we cannot provide the attribute reference.

{
  "datetime": "2022-09-08T14:22:52+00:00",
  "id": "f3e445ce-75ee-4c94-9d6d-370949664fd7",
  "serviceId": "f3e445ce-75ee-4c94-9d6d-370949664fd7",
  "service": "voice",
  "reference": "20220908-1547471",
  "event": "VoiceCallCompleted",
  "data": {
    "direction": "inbound",
    "status": "finished",
    "localNumber": "3225882397",
    "remoteNumber": "anonymous",
    "answeredOn": "2022-09-08T14:23:10+00:00",
    "events": 
      ..........
    ]
  }
}

PayLink

Event

Field

Format

datetime
string

When the event occurred

RFC3339
2023-10-12T07:20:50.52Z

id
string

Identifying the event uniquely

UUID

d670a4af-8562-4d5f-ae30-5cc36acf82ee

serviceId
string

Identifier of the PayLink

UUID

a2654d8a-3f8d-402e-a03b-980953802a09

service
string

paylink

reference
string

Identifier used during import, also known as identification_identifier

Empty when PayLink was created through our API.

event
string

PayLinkVisited
PayLinkPaid

data
array

{
"payment-method": "ideal",
"transaction-amount": 1344 # Amount in cents
}

Example Paid

{
  "datetime": "2022-11-11T11:11:11.11Z",
  "id": "f3e445ce-75ee-4c94-9d6d-370949664fd7",
  "reference": "",
  "serviceId": "adbc180b-a494-477f-958d-9f0b050a09c3",
  "service": "paylink",
  "event": "PayLinkPaid",
  "data": {
    "payment-method": "ideal",
    "transaction-amount": 114
  }
}