Checkout Event

  • amount_centile
    Type: integer
    required

    A total centile amount for the checkout in the iso_currency.

  • campaign_id
    Type: integer
    required

    Tola Identifier for a particular stream of traffic.

  • checkout_reference
    Type: string
    required

    A Tola generated unique reference for the checkout session.

  • date_created
    Type: string
    required

    Date and time when the checkout session was created in UTC.

  • date_finalised
    Type: string
    required

    Date and time when the funds were collected in UTC.

  • initiator
    Type: object
    required

    Details about the entity that created this Checkout request.

    Properties: 3
  • iso_currency
    Type: string
    required

    The ISO 4217 currency code for this Checkout

  • items
    Type: array of object
    required
    Properties: 4
  • status
    enum
    required

    The finalised status of the checkout, funds-transferred can be intrepreted as a success, all other status can be considered as a failure to collect funds.

    values
    cancelledfunds-transferredno-more-attemptstimeout-expiredsystem-error
  • customer_remark
    Type: string

    Contains the value of the customer remark provided at the Checkout creation time or an empty string if not supplied.

  • fulfillment_details
    Type: array of object

    Array of collection attempts ordered by time ascending.

    Properties: 6
  • payer
    Type: object

    Information about the identified consumer that completed the checkout, null when payer information is not available.

    Properties: 3
Examples 
{
  "amount_centile": 2000,
  "campaign_id": 123,
  "checkout_reference": "00FDPZJP3A5",
  "customer_remark": "",
  "date_created": "2024-11-26T12:32:35Z",
  "date_finalised": "2024-11-26T12:35:32Z",
  "fulfillment_details": [
    {
      "channel": "KENYA.SAFARICOM",
      "supplier_reference": "XKQ679SM1Z",
      "supplier_account": "123456_KE",
      "reference": "9.932.1732624452.1",
      "status": "ok",
      "type": "charge"
    }
  ],
  "initiator": {
    "reference": "fbe8z0db-8x69-4dcb-b5eb-c7f5927af17e",
    "type": "merchant-checkout",
    "metadata": null
  },
  "iso_currency": "KES",
  "items": [
    {
      "amountCentile": 2000,
      "description": "Customer Entry",
      "productCode": "",
      "quantity": 1
    }
  ],
  "payer": {
    "confirmed_channel": "KENYA.SAFARICOM",
    "id": "254000000001",
    "type": "msisdn"
  },
  "status": "funds-transferred",
  "user_comments": {
    "key": "",
    "value": ""
  }
}