Virtual Accounts

Layanan untuk membuat Virtual Account. Layanan ini akan mengembalikan Nomor Virtual Account yang akan dibayarkan satu kali saja.

Request Headers

Name	Desc	Note
X-CLIENT-ID	Nilai dari Client ID	Mandatory
X-CLIENT-SECRET	Nilai dari Client Secret	Mandatory
X-SIGNATURE	Hasil nilai signature yang telah dibuat sebelumnya	Mandatory

Request Body

Name	Desc	Note
partner_reference_number	Nomor referensi dari merchant dan bersifat Unik.	Mandatory
bank_code	Kode bank sesuai pada table	Mandatory
amount	Harus lebih besar dari 9999	Mandatory
expired	Format yyyyMMddHHiiss	Mandatory
remark	Catatan transaksi	Optional
customer_id	ID pelanggan dari merchant	Mandatory
customer_name	Nama pelanggan dari merchant	Mandatory
customer_email	Email pelanggan dari merchant	Mandatory
customer_phone	Nomor HP pelanggan dari merchant	Mandatory
redirect_url	URL untuk mengembalikan ke halaman tertentu jika status transaksi berhasil	Optional
callback_url	URL Callback mengembalikan data transaksi ke merchant (khusus untuk sandbox)	Optional

Contoh Kode dalam PHP:

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-sandbox.ipaymax.com/transaction/create/va',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "partner_reference_number": "TRX12341232144",
    "bank_code": "BCAVA",
    "amount": 10000,
    "expired": "20241102230000",
    "remark": "Coba kak",
    "customer_id": "31857118",
    "customer_name": "Sahabat Ipaymax",
    "customer_phone": "08123456789",
    "customer_email": "[email protected]",
    "redirect_url": ""
}',
  CURLOPT_HTTPHEADER => array(
    'X-CLIENT-ID: 3346754028',
    'X-CLIENT-SECRET: sandbox-ipaymax',
    'X-SIGNATURE: dc1aeb9a2c16f235d47bae5a155d89e183059958b649ee6b59067d4656fecc9f',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Contoh Response Berhasil

{
    "responseCode": "00",
    "responseMessage": "OK",
    "responseData": {
        "reference_number": "REF987654",
        "partner_reference_number": "PARTNER456789",
        "bank_code": "BCAVA",
        "bank_name": "BCA Virtual Account",
        "amount": 100000,
        "expired_at": "2024-10-30 14:30:00",
        "status": "pending",
        "remark": "Payment for order",
        "redirect_url": "https://example.com/redirect",
        "customer_id": "12",
        "customer_name": "John Doe",
        "customer_phone": "[phone]",
        "customer_email": "[email protected]",
        "checkout_url": "https://example.com/checkout",
        "payment_ref": "abcde1234",
        "instructions": [
            {
                "title": "ATM",
                "description": "Tata cara bayar"
	    }
        ]
    }
}

Contoh Response Gagal

{
    "responseCode": "99",
    "responseMessage": "An unexpected error occurred. Please try again later, or contact support if the issue persists."
}

List Bank Code

Nama Bank	Kode Bank
MANDIRI	BCAMAND
BANK BCA	BCAVA
BANK BRI	BRIVA
BANK BNI	BNIVA
BANK SYARIAH INDONESIA	BSIVA
BANK DANAMON	DANAMONVA
PERMATA BANK	PERMATAVA
BANK MUAMALAT	MUAMALATVA
BANK OCBC - INDONESIA	OCBCVA
BANK MAYBANK INDOCORP	MAYBANKVA
BANK CIMB NIAGA	CIMBVA

FAQ :

• Minimal transaksi IDR 10000

• Maksimum transaksi IDR 2.000.000.000

• Transaksi berhasil jika responseCode berniali "00"

• Transaksi gagal jika responseCode bernilai selain dari "00"

• Status Transaksi : pending/success/failed