capabilities.work

Express Checkout and Poll Status

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

Recipe · 3 steps

Express Checkout and Poll Status

Create an Express Checkout session and poll until payment status is resolved.

  1. Exchange the client credentials for a bearer access token used to authorize the checkout calls.
  2. Create a hosted Express Checkout session and return the short and long URLs the customer uses to pay.
  3. Query the status of the checkout request by merchant_transaction_id. Repeat this step while the request remains in flight; branch to the 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 (KE, UG, TZ, NG, GH, ...).
  • currencyCode: ISO 4217 currency code.
  • requestAmount: Amount to charge the customer.
  • requestDescription: Human-readable description shown on the checkout.
  • msisdn: Customer phone in E.164 format.
  • customerEmail: Customer email address.
  • callbackUrl: IPN callback URL Tingg posts the payment result to.
For your developer

Arazzo workflow cellulant:express-checkout-and-poll-status, 3 operations: requestAccessToken → createExpressCheckout → queryRequestStatus. Specs on APIs.io.