SNAP Checkout Transaction

Layanan untuk membuat transaksi pembayaran dengan mudah tanpa membuat tampilan sendiri.

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
amount	Harus lebih besar dari 9999	Mandatory
expired	Format yyyyMMddHHiiss	Mandatory
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/checkout',
  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",
    "amount": 10000,
    "expired": "20241102230000",
    "customer_id": "31857118",
    "customer_name": "Sahabat Ipaymax",
    "customer_phone": "08123456789",
    "customer_email": "[email protected]",
    "redirect_url": "",
    "callback_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": "",
        "bank_name": "",
        "amount": 100000,
        "expired_at": "2024-10-30 14:30:00",
        "status": "pending",
        "remark": "",
        "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": "",
        "instructions": [
            {
                "title": "Pembayaran via QRIS",
                "description": "<ol><li>Masuk ke aplikasi dompet digital/mobile banking Anda yang telah mendukung QRIS</li><li>Pindai/Scan QR Code yang tersedia</li><li>Akan muncul detail transaksi. Pastikan data transaksi sudah sesuai</li><li>Selesaikan proses pembayaran Anda</li><li>Transaksi selesai. Simpan bukti pembayaran Anda</li></ol>"
            }
        ]
    }
}

Contoh Response Gagal

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