IPAYMU API V2 DOCUMENTATION

Choose how customers pay

Choose Redirect for checkout on an iPaymu page, or Direct to select a payment method right from your app.

Start integrating Explore API reference
ipaymu / quickstart

A quick path for developers

  1. 01Get your VA & API Key
  2. 02Sign the request
  3. 03Create a payment
  4. 04Validate the callback
Redirect POST /api/v2/paymentDirect POST /api/v2/payment/direct

CHOOSE A PATH

Start with your goal

The docs are organized around the task you want to complete.

API integrationGet credentials and create your first payment.Getting started Account verificationComplete merchant details to prepare your account.Verification guide CMS pluginsConnect iPaymu to your store without building from scratch.Browse plugins

INTEGRATION FLOW

Four steps to your first payment

01

Get credentials

Find your VA and API Key in the iPaymu dashboard. Use sandbox credentials for testing.

Getting started
02

Sign the request

Create an HMAC-SHA256 signature and include a timestamp in each API request.

Signature guide
03

Choose a payment flow

Redirect opens iPaymu's checkout page; Direct selects the method and channel in your app.

Compare both flows
04

Handle the callback

Receive status updates and verify their signature before updating a transaction.

Callback guide

TWO WAYS TO CREATE A PAYMENT

Choose a flow, see the request

The endpoints differ. Compare Redirect and Direct examples before choosing the right fit for your app.

The response includes a checkout URL for your buyer.

Open endpoint documentation
bash
curl -X POST https://sandbox.ipaymu.com/api/v2/payment \
  -H "Content-Type: application/json" \
  -H "va: YOUR_VA" \
  -H "signature: GENERATED_SIGNATURE" \
  -H "timestamp: YYYYMMDDHHmmss" \
  -d '{
    "product": ["Example Product"],
    "qty": ["1"],
    "price": ["100000"],
    "description": ["First order"],
    "returnUrl": "https://example.com/success",
    "notifyUrl": "https://example.com/webhook",
    "cancelUrl": "https://example.com/cancel"
  }'

What you need

The essential parts of this request:

va + signature
Merchant identity and request signature.
timestamp
Request time used to validate the signature.
product · qty · price
Product details and payment amount.
returnUrl · notifyUrl · cancelUrl
Redirect destinations and status notification.
Learn about signatures

KEEP BUILDING

After your first request succeeds

Payment methodsFind available methods and channels.Payment notificationsProcess transaction status securely.Complete referenceBrowse every endpoint and technical guide.