capabilities.work

Web Checkout And Confirm

A 2-step recipe with Interswitch. We can help you get access.

Recipe · 2 steps

Web Checkout And Confirm

Initiate a hosted payment and confirm it server-side before delivering value.

  1. Post the checkout form to redirect the customer to the Interswitch hosted payment page. A 302 redirect is the documented success response.
  2. Authoritative server-side requery. Branches on ResponseCode: 00 means the transaction is approved and value may be released.
What you'll need to have ready
  • accessToken: Bearer access token from the Passport OAuth token endpoint.
  • merchantCode: Merchant code issued by Interswitch.
  • payItemId: Pay item identifier configured on the merchant account.
  • txnRef: Unique merchant transaction reference.
  • amount: Amount in minor currency units (kobo).
  • currency: ISO 4217 numeric currency code (e.g. 566 for NGN).
  • custEmail: Customer email address.
  • siteRedirectUrl: URL the hosted page redirects back to after payment.
For your developer

Arazzo workflow interswitch:checkout-and-confirm, 2 operations: initiateWebRedirectPayment → getTransactionStatus. Specs on APIs.io.