New Rajabiller

Keterangan & Response Code

#DOKUMENTASI
SEMUA TRANSAKSI MENGGUNAKAN INQ TERLEBIH DAHULU KECUALI PRODUK PULSA PONSEL PRABAYAR DAN GAME ONLINE

1. WAKTU dalam RESP INQ maupun PAY menggunakan format YMDHis (contoh: 20181201170207)

2. IDPEL1, IDPEL2, IDPEL3 waktu REQ INQ dan REQ PAY dikategorikan sbb:

  1. PLN Pascabayar
       ID Pelanggan PLN Pascabayar diisikan pada parameter IDPEL1 dengan jumlah 12 digit, untuk IDPEL2 dan IDPEL3 cukup di kosongkan saja.

  2. PLN Prabayar,pada produk ada 2 cara pengiriman request dengan penginputan ID Pelanggan
       Jika ID Pelanggan terdiri dari 11 digit (disebut No Meter) bisa dimasukkan pada IDPEL1, untuk IDPEL2 dan IDPEL3 cukup di kosongkan saja
       Jika ID Pelanggan terdiri dari 12 digit (disebut ID Pelanggan) bisa dimasukkan pada IDPEL2, untuk IDPEL1 dan IDPEL3 cukup di kosongkan saja

  3. PRODUK TELEPON
       Pada request produk ini, perlu diperhatikan bahwa penginputan ID Pelanggan harus dimasukkan pada parameter IDPEL1 dan IDPEL2.
       Untuk IDPEL1 diisi dengan KODE AREA sedangkan IDPEL2 diisi dengan No Telp.
  4. PDAM
       Untuk PDAM Bangkalan, Tapin, Mojokerto dimasukkan pada IDPEL2 (disebut No Sambungan),
       sedangkan PDAM selain itu dimasukkan pada IDPEL1.
3. NOMINAL pada saat REQ PAY diisi dengan NOMINAL yang didapat pada saat RESP INQ (tanpa tambahan ADMIN), untuk produk PLN PRA
BAYAR, REQ PAY diisi   dengan list denom 20000, 50000, 100000, 200000, 500000, 1000000, selain PLN PRA BAYAR NOMINAL sudah termasuk DENDA, TAGIHAN LAIN-LAIN jika ada

4. PERIODE jika lebih dari 2 tunggakan dipisah dengan separator koma(,), untuk PERIODE REQ INQ dan PAY BPJS Kesehatan berisi jumlah bulan (BUKAN BULAN KE) yang dibayarkan dengan value MIN 1 MAX 12

5. REF1 bersifat OPTIONAL (boleh diisi atau tidak), atau bisa digunakan sebagai ID TRANSAKSI PARTNER, perlu diingat jika REF1 diisi maka pada saat Reqeust PAY, REF1 juga harus diisi.

6. REF2 bersifat MANDATORY (wajib), REF2 waktu REQ PAY diisi dengan REF2 yang didapat pada saat RESP INQ

7. TGL1 dan TGL2 pada REQ Data Transaksi menggunakan format YMDHis (contoh: 20181201170207) dengan max selisih 1 hari

8. Field STATUS pada RESPONSE PAY jika:
  1. "00" selain dengan keterangan "SEDANG DIPROSES" atau mengandung kata "sedang diproses" adalah transaksi berhasil
  2. "00" dengan keterangan "SEDANG DIPROSES" & "PENDING" adalah transaksi pending
  3. "" (Tanpa isi) adalah transaksi pending
  4. "35" adalah transaksi pending
  5. "68" adalah transaksi pending
  6. http status code selain 200 dikatakan pending
  7. RC apapun itu dengan keterangan yang mengandung kata "sedang diproses" adalah pending
Contoh case jika mendapatkan RC 00 dengan Keterangan "SEDANG DIPROSES" / pending, maka yang harus dilakukan yaitu cek data
transaksi yang pending tersebut menggunakan API DataTransaksi secara berkala (5 s/d 15 menit) setelah transaksi tersebut.
Jika result status cek data trasaksi sukses silahkan cetak ulang transaksi tersebut dengan API CetakUlang, jika result status
cek data transaksi gagal (saldo tomatis di refund), silahkan untuk inquiry ulang.

9. Field STATUS pada RESPONSE Data Transaksi jika 00 menandakan REQ Data Transaksi yang diinputkan terdapat pada sistem kami
dan BUKAN menandakan Transaksi yang dikirim sukses, untuk hasil akhir bisa dilihat pada field RESULT_TRANSAKSI

10. Tidak ada REVERSAL untuk Rajabiller
11. Menggunakan sistem callback untuk menimimalisir terjadinya timeout dan digunakan untuk crosscek menggunakan REF PARTNER bukan lagi ID PEL 1.
12. Jika inquiry mendapatkan response dengan keterangan yang mengandung "sedang dirproses", silahkan melakukan inquiry ulang.

Contoh penggunaan script dengan PHP

<?php
error_reporting(E_ALL);
ini_set('display_errors', TRUE);
ini_set('display_startup_errors', TRUE);

function send_json($data){
    $api_url = "https://rajabiller.fastpay.co.id/transaksi/json.php";
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $api_url);
    curl_setopt($ch, CURLOPT_TIMEOUT, 0);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 500);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    $result = curl_exec($ch); 
    return $result;
}

$request_data = array(
    'method'    =>'rajabiller.balance',
    'uid'       =>'UID',
    'pin'       =>'PIN'
);

$send_data 		= send_json($request_data);
$respon 		= json_decode($send_data);
echo $send_data; //json output response
echo "<pre>", print_r($respon) ,"</pre>"; // untuk output array
?>