capabilities.work

Custom Checkout, Charge, and Poll

A 4-step recipe with Cellulant. We can help you get access.

Recipe · 4 steps

Custom Checkout, Charge, and Poll

Initiate a custom checkout, charge the customer, and poll until the payment is resolved.

  1. Exchange the client credentials for a bearer access token used to authorize the checkout and charge calls.
  2. Initiate a host-to-host custom checkout and capture the checkout_request_id used to drive the charge.
  3. Post the charge request against the initiated checkout to push the USSD/STK prompt or card charge to the customer.
  4. Query the request status by merchant_transaction_id. Repeat while the charge is in flight; end once a payment is reported.
What you'll need to have ready
  • clientId: OAuth client id issued in the Tingg dashboard.
  • clientSecret: OAuth client secret issued in the Tingg dashboard.
  • apiKey: Merchant apikey header value issued in the Tingg dashboard.
  • merchantTransactionId: Unique merchant transaction id for this checkout.
  • serviceCode: Tingg service code identifying the merchant product line.
  • countryCode: ISO 3166-1 alpha-2 country code.
  • currencyCode: ISO 4217 currency code.
  • requestAmount: Amount to charge the customer.
  • callbackUrl: IPN callback URL Tingg posts the payment result to.
  • payerMode: Custom checkout payer mode (MOBILE, BANK, or CARD).
  • paymentOptionCode: Payment option code identifying the rail to charge.
  • msisdn: Customer phone in E.164 format to receive the charge prompt.
For your developer

Arazzo workflow cellulant:custom-checkout-charge-and-poll, 4 operations: requestAccessToken → initiateCustomCheckout → initiateChargeRequest → queryRequestStatus. Specs on APIs.io.