Pembayaran Redirect (Redirect Payment)

Coba di Postman

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

Endpoint

URL: {{baseUrl}}/api/v2/payment Metode: POST

Request Headers

Kunci	Nilai	Deskripsi
`Content-Type`	`application/json`
`signature`	`{{signature}}`	Signature yang dihasilkan. Lihat Pembuatan Signature.
`va`	`{{va}}`	Nomor Virtual Account Anda.
`timestamp`	`{{timestamp}}`	Timestamp saat ini.

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.