JGME Pay
Collect Payment

Collections - Inline

Embed JGME Pay checkout directly on your website using the JavaScript SDK.

JGME Pay Inline

Inline checkout lets customers pay without leaving your page. You load the JGME Pay SDK, initialize checkout with your transaction data, and open the payment iframe.

CDN SDK URL:

https://cdn.jgmepay.com/jgmepay.min.js

Why Use Inline?

Seamless UX

Customers stay on your site while completing payment.

Fast Integration

Add one script and trigger checkout from your pay button.

Event Hooks

Use callbacks for completion and close events in your app flow.

Before You Start

Get your API credentials

Retrieve your client-id from Settings -> Security -> API Keys and Webhooks in https://merchant.jgmepay.com.

Set your environment

Set environment to production. Every payment is live, so test with the smallest amount your providers accept.

Generate unique references

Create a unique reference for every payment attempt to avoid duplicates.

Never expose client-secret in frontend code. Inline checkout should only use client-id.

Quick Integration Example

Inline SDK
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>JGME Pay Inline</title>
</head>
<body>
  <button id="pay-btn">Pay NGN 1,000.00</button>

<script src="https://cdn.jgmepay.com/jgmepay.min.js"></script>

  <script>
    document.getElementById("pay-btn").addEventListener("click", () => {
      const handler = new JGME Pay({
        environment: "production",
        reference: "ORDER-1001",
        clientId: "YOUR_CLIENT_ID",
        amount: 100000,
        currency: "NGN",
        country: "NG",
        customer: {
          name: "John Doe",
          email: "john@example.com",
          phoneNumber: "2348012345678"
        },
        metadata: {
          orderId: "ORDER-1001"
        },
        callback: (data) => {
          console.log("Payment callback:", data);
          // Verify transaction status on your backend before fulfillment.
        },
        onClose: () => {
          console.log("Customer closed checkout");
        }
      });

      handler.setup();
      handler.openIframe();
    });
  </script>

</body>
</html>

Parameter Reference

FieldTypeRequiredDescription
environmentstringYesTarget environment for the SDK
referencestringRecommendedUnique transaction reference
clientIdstringYesYour JGME Pay client-id
amountintegerYesAmount in minor units (no decimals)
currencystringYesISO currency code (for example NGN)
countrystringYesISO country code (for example NG)
customerobjectYesCustomer details (name/email/phone)
metadataobjectNoCustom fields returned in callbacks/webhooks
callbackfunctionYesRuns after payment event payload is returned
onClosefunctionNoRuns when checkout modal is closed

Amount Rule (Important)

JGME Pay does not support decimal API amounts. Send integer minor-unit values only.

  • 1000.00 NGN -> 100000
  • 250.50 NGN -> 25050

See Amount Specification for full conversion guidance.

Troubleshooting

SymptomLikely CauseFix
Checkout does not openSDK script not loadedConfirm script URL and browser console errors
Authentication/authorization issuesInvalid clientId or wrong environmentUse credentials issued for the environment you call
Amount validation failureDecimal amount usedConvert to integer minor units
Duplicate transaction errorReused referenceGenerate a new unique reference

On this page