DOKUMENTASI IPAYMU API V2

Tentukan cara pelanggan membayar

Pilih Redirect untuk checkout melalui halaman iPaymu, atau Direct untuk memilih metode pembayaran langsung dari aplikasi Anda.

ipaymu / quickstart

Alur cepat untuk developer

  1. 01Siapkan VA & API Key
  2. 02Buat signature request
  3. 03Kirim request pembayaran
  4. 04Validasi callback
Redirect POST /api/v2/paymentDirect POST /api/v2/payment/direct

ALUR INTEGRASI

Empat langkah sampai pembayaran pertama

01

Ambil kredensial

Temukan VA dan API Key di dashboard iPaymu. Gunakan kredensial sandbox untuk pengujian.

Panduan awal
02

Tandatangani request

Buat signature HMAC-SHA256 dan sertakan timestamp pada setiap request API.

Cara membuat signature
03

Pilih alur pembayaran

Redirect membuka halaman pembayaran iPaymu; Direct menentukan metode dan channel dari aplikasi Anda.

Bandingkan dua alur
04

Tangani callback

Terima notifikasi status dan validasi signature sebelum memperbarui transaksi.

Panduan callback

DUA CARA MEMBUAT PEMBAYARAN

Pilih alur, lihat request-nya

Endpoint-nya berbeda. Bandingkan contoh Redirect dan Direct sebelum memilih yang cocok untuk aplikasi Anda.

Respons berisi URL checkout untuk diarahkan ke pembeli.

Buka dokumentasi endpoint
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"
  }'

Yang perlu disiapkan

Bagian penting dari request ini:

va + signature
Identitas merchant dan tanda tangan request.
timestamp
Waktu request untuk validasi signature.
product · qty · price
Detail produk dan nominal pembayaran.
returnUrl · notifyUrl · cancelUrl
Tujuan redirect dan notifikasi status.
Pelajari signature