Skip to main content

Checkout Integration

Checkout Integration is the standard way to integrate directly with the Echezona API. You initialize a transaction on your backend, then hand the customer off to Echezona to complete the payment — either by redirecting them to a hosted checkout page, or by mounting one of our SDKs on the frontend. Echezona's hosted UI/SDK collects and handles all sensitive payment data, so there's no special compliance or licensing burden on you.

How It Works​

  1. Initialize the Transaction​

    Send a POST request to Payments/Initialize with the transaction details (amount, currency, email, etc.).

  2. Get the Checkout URL and Access Code​

    On success, the response contains a paymentUrl (the checkout URL) and an accessCode.

    Response (200)
    {
      "responseCode": "00",
      "responseMessage": "Authorization URL created",
      "data": {
        "paymentUrl": "https://checkout.echezona.com/2a11mganDV4u",
        "accessCode": "2a11mganDV4u"
      }
    }

  3. Render the Checkout​

    Choose whichever fits your platform:

    • Redirect — Send the customer's browser to paymentUrl. See Echezona Standard for the full redirect walkthrough, including handling the callbackUrl return.
    • Mount inline (web, script tag) — Use the Inline JS popup library directly in your HTML.
    • Mount via npm SDK — Use echezona-pop in a React/Vue/vanilla JS app.
    • Mount via mobile SDK — Use the React Native SDK's startCheckout(accessCode) and <CheckoutModal />/<CheckoutView /> components.

  4. Handle Post-Payment​

    After the transaction completes, confirm the outcome server-side with Fetch Transaction Status before updating order state.

Do I need any special licenses or compliance certifications?​

No. Since Echezona's hosted checkout page or SDK handles all sensitive card, transfer, and USSD data, Checkout Integration carries no special compliance or licensing requirement. If you need to build your own checkout UI and handle raw payment data directly, see Core API Integration instead — that path requires relevant licenses and compliance certifications.

Support​

If you need assistance, our support team is here to help. Reach out at hello@echezona.com.