Pembayaran Redirect (Redirect Payment)
Redirect Payment memungkinkan Anda menggunakan halaman pembayaran iPaymu.
LINGKUNGAN API
Endpoint
https://sandbox.ipaymu.com/api/v2/paymentGunakan kredensial sesuai lingkungan yang dipilih. Kredensial Sandbox dan Production berbeda.
Redirect Payment memungkinkan Anda menggunakan halaman pembayaran yang di-host oleh iPaymu. Ini adalah cara termudah untuk integrasi jika Anda tidak ingin menangani UI untuk pemilihan pembayaran.
Persyaratan Production
Dalam mode Production, pastikan server Anda menggunakan IP Statis dan domain Anda terdaftar. Lihat Validasi IP & Domain.
Alur Integrasi Pembayaran Redirect
6 tahapan integrasi pembayaran halaman ter-host iPaymu
Request Redirect Payment
Merchant mengunggah detail pesanan ke /api/v2/payment disertai returnUrl, notifyUrl & cancelUrl.
Dapatkan SessionID & Url Checkout
iPaymu mengembalikan SessionID & Url pembayaran hosted checkout resmi iPaymu.
Redirect Pelanggan ke iPaymu
Sistem Merchant mengarahkan (redirect) pelanggan ke Halaman Pembayaran Hosted iPaymu.
Pilih Kanal & Bayar
Pelanggan memilih kanal pembayaran favorit (VA / e-Wallet / QRIS / CC) di UI iPaymu dan menyelesaikan transaksi.
Notifikasi Webhook Callback
iPaymu mengirim HTTP POST notifikasi callback ke notifyUrl milik Merchant.
Redirect Kembalikan Pelanggan
iPaymu mengarahkan kembali pelanggan ke returnUrl (Halaman Berhasil) milik Merchant.
Request Headers
Content-Type
string- Contoh / nilai
application/json- Deskripsi
- Tipe MIME untuk body request JSON.
va
string- Contoh / nilai
YOUR_VA- Deskripsi
- Nomor Virtual Account merchant. Ambil dari menu Integrasi di dashboard iPaymu: Production / Sandbox. Gunakan VA sesuai environment yang dipilih.
signature
string · 64 hex- Contoh / nilai
GENERATED_SIGNATURE- Deskripsi
- Buat signature HMAC-SHA256 untuk request ini memakai API Key dari Production / Sandbox. Jangan isi header ini dengan API Key. Lihat Pembuatan Signature.
timestamp
string · 14 digit- Contoh / nilai
20260102153045- Deskripsi
- Waktu saat request dibuat, format
YYYYMMDDHHmmss(contoh: 2 Jan 2026, 15:30:45). Ikuti panduan endpoint jika mensyaratkan ISO 8601.
Request Body
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
product[] | array | Ya | Daftar nama produk. |
qty[] | array | Ya | Daftar jumlah produk. |
price[] | array | Ya | Daftar harga produk. |
description[] | array | Ya | Daftar deskripsi produk. |
imageUrl[] | array | Tidak | Opsional. Ganti gambar produk di halaman pembayaran iPaymu. Diurutkan berdasarkan index. |
returnUrl | string | Ya | URL untuk redirect setelah pembayaran berhasil. |
notifyUrl | string | Ya | URL untuk menerima notifikasi webhook. |
cancelUrl | string | Ya | URL untuk redirect setelah pembayaran gagal/dibatalkan. |
referenceId | string | Tidak | ID transaksi unik Anda. |
buyerName | string | Tidak | Nama pembeli. |
buyerEmail | string | Tidak | Email pembeli. |
buyerPhone | string | Tidak | Telepon pembeli. |
expired | number | Tidak | Waktu kedaluwarsa kustom dalam jam. |
feeDirection | string | Tidak | BUYER atau MERCHANT. |
paymentMethod | string | Tidak | Pilih metode pembayaran pra-seleksi (misal: va, cc). |
account | string | Tidak | ID Child account VA (opsional). |
Contoh Request
{
"product": ["T-Shirt"],
"qty": ["1"],
"price": ["100000"],
"description": ["Blue Size L"],
"imageUrl": ["https://images.com/example.jpg"],
"returnUrl": "https://your-website.com/thank-you",
"notifyUrl": "https://your-website.com/callback",
"cancelUrl": "https://your-website.com/cancel",
"referenceId": "INV-002"
}Contoh Response (Sukses)
{
"Status": 200,
"Message": "success",
"Data": {
"SessionID": "91538218-5158-459B-8716-DD97FFE3EDAB",
"Url": "https://sandbox.ipaymu.com/payment/91538218-5158-459B-8716-DD97FFE3EDAB"
}
}Anda harus mengarahkan pengguna ke Url yang disediakan dalam response.