JGME Pay
Collect Payment

Collection - Standard Checkout

Redirect customers to JGME Pay hosted checkout using a server-side API request.

Standard checkout is a redirect flow:

  1. Your backend creates a checkout session.
  2. JGME Pay returns a checkout URL.
  3. You redirect the customer to that URL.
  4. Customer completes payment and JGME Pay notifies your system via webhook.

Why Use Standard Checkout?

Fastest Launch

Minimal frontend complexity. Your backend creates a checkout and redirects users.

Hosted Experience

JGME Pay handles payment method UI and provider-specific interactions.

Reliable Status Updates

Use webhook events and transaction verification for final payment outcomes.

Integration Steps

Collect payment details on your backend

Prepare required fields like amount, currency, country, and customer information.

Create checkout session

Send a request to POST /payments/v1/checkouts with your client-id and client-secret.

Redirect customer

Redirect users to data.shortURL (or data.url) from the response.

Confirm final status

Process webhook notifications and/or verify transaction status before order fulfillment.

Create Checkout Request

curl --location 'https://api.jgmepay.com/payments/v1/checkouts' \
  --header 'client-id: <client-id>' \
  --header 'client-secret: <client-secret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "reference": "ORDER-1001",
    "amount": 50000,
    "currency": "NGN",
    "country": "NG",
    "redirectURL": "https://yourapp.com/payment/complete",
    "webhook": "https://yourapp.com/webhooks/jgmepay",
    "user": {
      "email": "customer@example.com",
      "phoneNumber": "2348012345678",
      "name": "John Doe"
    }
  }'

Sample response:

{
  "data": {
    "url": "https://checkout.jgmepay.com/payfusion/66579afe04916ddcfcf73e7b",
    "shortURL": "https://l.6bd.co/XXXXX",
    "reference": "ORDER-1001",
    "amount": 50000
  }
}

Parameter Reference

FieldTypeRequiredDescription
referencestringRecommendedUnique transaction identifier from your system
amountintegerYesAmount in minor units (no decimals)
currencystringYesISO currency code (for example NGN)
countrystringYesISO country code (for example NG)
userobjectYesCustomer object (email/phone/name fields)
redirectURLstringNoCustomer return URL after checkout
webhookstringNoPer-transaction webhook override URL
metadataobjectNoCustom fields for your internal tracking

Amount Rule (Important)

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

  • 500.00 NGN -> 50000
  • 1250.75 NGN -> 125075

See Amount Specification for full conversion rules.

After Redirect and Payment

Production Best Practices

PracticeWhy It Matters
Generate references server-sidePrevent duplicate references and improve reconciliation
Process webhook idempotentlyAvoid duplicate order fulfillment on retries
Validate redirect parametersProtect against malformed/forged client-side values
Use backend verificationEnsure final status before business-critical actions

On this page