Payment

Pembayaran Redirect (Redirect Payment)

Test on Postman

Redirect Payment memungkinkan Anda menggunakan halaman pembayaran iPaymu.

LINGKUNGAN API

Endpoint

POST
https://sandbox.ipaymu.com/api/v2/payment

Gunakan 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

Step 1POST /payment

Request Redirect Payment

Merchant mengunggah detail pesanan ke /api/v2/payment disertai returnUrl, notifyUrl & cancelUrl.

1 of 6
Step 2Checkout Url

Dapatkan SessionID & Url Checkout

iPaymu mengembalikan SessionID & Url pembayaran hosted checkout resmi iPaymu.

2 of 6
Step 3Browser Redirect

Redirect Pelanggan ke iPaymu

Sistem Merchant mengarahkan (redirect) pelanggan ke Halaman Pembayaran Hosted iPaymu.

3 of 6
Step 4Hosted Checkout UI

Pilih Kanal & Bayar

Pelanggan memilih kanal pembayaran favorit (VA / e-Wallet / QRIS / CC) di UI iPaymu dan menyelesaikan transaksi.

4 of 6
Step 5HTTP Callback

Notifikasi Webhook Callback

iPaymu mengirim HTTP POST notifikasi callback ke notifyUrl milik Merchant.

5 of 6
Step 6returnUrl Complete

Redirect Kembalikan Pelanggan

iPaymu mengarahkan kembali pelanggan ke returnUrl (Halaman Berhasil) milik Merchant.

6 of 6
DONE

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

ParameterTipeWajibDeskripsi
product[]arrayYaDaftar nama produk.
qty[]arrayYaDaftar jumlah produk.
price[]arrayYaDaftar harga produk.
description[]arrayYaDaftar deskripsi produk.
imageUrl[]arrayTidakOpsional. Ganti gambar produk di halaman pembayaran iPaymu. Diurutkan berdasarkan index.
returnUrlstringYaURL untuk redirect setelah pembayaran berhasil.
notifyUrlstringYaURL untuk menerima notifikasi webhook.
cancelUrlstringYaURL untuk redirect setelah pembayaran gagal/dibatalkan.
referenceIdstringTidakID transaksi unik Anda.
buyerNamestringTidakNama pembeli.
buyerEmailstringTidakEmail pembeli.
buyerPhonestringTidakTelepon pembeli.
expirednumberTidakWaktu kedaluwarsa kustom dalam jam.
feeDirectionstringTidakBUYER atau MERCHANT.
paymentMethodstringTidakPilih metode pembayaran pra-seleksi (misal: va, cc).
accountstringTidakID 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.

On this page