Cellulant · Schema

Tingg Express Checkout Request

Payload submitted to /v3/checkout-api/checkout-request/express-request to create a hosted checkout session.

PaymentsMobile MoneyCheckoutPayoutsDisbursementAfricaPan-AfricanFintechBank TransferCardsAirtimeBill PaymentSMSOTPTingg

Properties

Name	Type	Description
merchant_transaction_id	string	Unique merchant-generated transaction identifier.
service_code	string	Tingg service code identifying the merchant's product line.
country_code	string	ISO 3166-1 alpha-2 country code (KE, UG, TZ, NG, GH, ...).
currency_code	string	ISO 4217 currency code.
request_amount	number
request_description	string
account_number	string
msisdn	string	E.164 phone number, no leading + or 00.
customer_first_name	string
customer_last_name	string
customer_email	string
due_date	string
callback_url	string
success_redirect_url	string
fail_redirect_url	string
payment_option_code	string
language_code	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/cellulant/refs/heads/main/json-schema/cellulant-checkout-request-schema.json",
  "title": "Tingg Express Checkout Request",
  "description": "Payload submitted to /v3/checkout-api/checkout-request/express-request to create a hosted checkout session.",
  "type": "object",
  "required": [
    "merchant_transaction_id",
    "service_code",
    "country_code",
    "currency_code",
    "request_amount",
    "callback_url"
  ],
  "properties": {
    "merchant_transaction_id": {
      "type": "string",
      "description": "Unique merchant-generated transaction identifier."
    },
    "service_code": {
      "type": "string",
      "description": "Tingg service code identifying the merchant's product line."
    },
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code (KE, UG, TZ, NG, GH, ...)."
    },
    "currency_code": {
      "type": "string",
      "description": "ISO 4217 currency code."
    },
    "request_amount": {
      "type": "number",
      "minimum": 0
    },
    "request_description": { "type": "string" },
    "account_number": { "type": "string" },
    "msisdn": {
      "type": "string",
      "description": "E.164 phone number, no leading + or 00."
    },
    "customer_first_name": { "type": "string" },
    "customer_last_name": { "type": "string" },
    "customer_email": { "type": "string", "format": "email" },
    "due_date": { "type": "string", "format": "date-time" },
    "callback_url": { "type": "string", "format": "uri" },
    "success_redirect_url": { "type": "string", "format": "uri" },
    "fail_redirect_url": { "type": "string", "format": "uri" },
    "payment_option_code": { "type": "string" },
    "language_code": { "type": "string", "default": "en" }
  },
  "additionalProperties": false
}