bpjs-kes.md 5.42 KB

BPJS KS MODULE BPJS KS

  1. Inquiry: protokol untuk melakukan pengecekan data tagihan/pembelian REQ :

    cid=[CLIENT ID]
    modul=gp
    command=inq
    input1=[IDPEL]
    input2=1
    input3=
    biller=[KODE BILLER]
    amount=
    trxid=[TRANSAKSI ID]
    resp=XML
    

    Contoh request :

    cid=6ffacfed-6296-11e6-8325- 002590495d2a
    dt=20170729
    hc=574e57f30a3b86d460da70e56f20e9709bdd5a61e376419a48d8793292ec6eb2
    modul=gp
    command=inq
    input1=888880000100
    input2=1
    input3=
    biller=0060012
    amount=
    trxid=JRYPEFXTXH
    resp=XML
    

    Contoh response Sukses:

    <?xml version="1.0"?>
    <root>
      <status>SUCCESS</status>
      <rc>0000</rc>
      <rcm>[0] Cek Tagihan Sukses ke:888880000100 refnum:1362F31B7D42455DAE3942E1F0292C02</rcm>
      <text>INFORMASI TAGIHAN BPJS KESEHATAN<br/>
          ID PEL:888880000100, JML
          BLN:1, NO HP:<br/>
          EKI HENDRAWANBRATA<br/>
          JUMLAH PESERTA : 3<br/>
          TAG Rp:255.000<br/>
          ADM Rp:2.500<br/>
          TOTALRp:257.500<br/>
          TOTAL SALDO : 0<br/>
          TOTAL PREMI : 255.000<br/>
      </text>
      <refnum>1362F31B7D42455DAE3942E1F0292C02</refnum>
      <input1>888880000100</input1>
      <jmltagihan>255000</jmltagihan>
      <admin>2500</admin>
      <totaltag>257500</totaltag>
      <info1>0</info1>
      <info2>255000</info2>
      <infotext/>
    </root> 
    

    Contoh response Error:

    <?xml version="1.0"?>
    <root>
      <status>ERROR</status>
      <rc>0077</rc>
      <rcm>ID ANDA DIBLOK, SILAHKAN HUBUNGI BPJS Kesehatan Terdekat</rcm>
    </root>
    
  2. Payment

    Protokol untuk melakukan pembayaran/pembelian dengan terlebih dahulu melakukan inquiry REQ :

    cid=[CLIENT ID]
    modul=gp
    command=pay
    input1=[IDPEL]
    input2=1
    input3=
    biller=[KODE BILLER]
    amount=[TOTAL]
    trxid=[TRX
    ID]
    resp=XML
    

    Contoh request :

    cid=6ffacfed-6296-11e6-8325- 002590495d2a
    dt=20170729
    hc=574e57f30a3b86d460da70e56f20e9709bdd5a61e376419a48d8793292ec6eb2
    modul=gp
    command=pay
    input1=888880000100
    input2=1
    input3=
    biller=0060012
    amount=257500
    trxid=JRYPEFXTXH
    resp=XML 
    

    Contoh response Sukses:

    <?xml version="1.0"?>
    <root>
      <status>SUCCESS</status>
      <rc>0000</rc>
      <rcm>[0] Pembayaran Sukses ke:888880000100 refnum:1362F31B7D42455DAE3942E1F0292C02</rcm>
      <text>PEMBAYARAN 0060012<br/>
        28/08/2017 14:55<br/>
        IDPEL:888880000100, JML BLN:1, NO HP:<br/>
        EKI HENDRAWANBRATA<br/>
        : <br/>
        1362F31B7D42455DAE3942E1F0292C02<br/>
        TAG Rp:255.000<br/>
        ADM Rp:2.500<br/>
        TOTAL Rp:257.500<br/>
        SUKSES</text>
      <refnum>1362F31B7D42455DAE3942E1F0292C02</refnum>
      <input1>888880000100</input1>
      <jmltagihan>255000</jmltagihan>
      <admin>2500</admin>
      <totaltag>257500</totaltag>
      <info1/>
    </root>
    

    Contoh response Error:

    <?xml version="1.0"?>
    <root>
      <status>ERROR</status>
      <rc>0013</rc>
      <rcm>Jumlah Yang Harus Dibayar Tidak Valid</rcm>
    </root>
    
  3. Advice

    Protokol untuk melakukan pengecekan transaksi dengan input payment refnum REQ :

    cid=[CLIENTID]
    dt=[DATE]
    hc=[HASHCODE]
    modul=gp
    command=adv
    input1=[IDPEL]
    input2=1
    input3=
    biller=[KODE
    BILLER]
    amount=[TOTAL]
    trxid=[TRX ID]
    resp=xml
    

    Contoh request :

    cid=6ffacfed-6296-11e6-8325- 002590495d2a
    dt=20170729
    hc=574e57f30a3b86d460da70e56f20e9709bdd5a61e376419a48d8793292ec6eb2
    modul=gp
    command=adv
    input1=8888801260000100
    input2=1
    input3=
    biller=0060012
    amount=257500
    trxid=APFDQXQWHU
    resp=xml 
    

    Contoh Response Sukses:

    <?xml version="1.0"?>
    <root>
      <status>SUCCESS</status>
      <rc>0000</rc>
      <rcm>[0] Pembayaran Sukses ke:8888801260000100 refnum:140E9C17B55641D188E4E010E8741C76</rcm>
      <text>PEMBAYARAN 0060012<br/>
        28/08/2017 15:09<br/>
        IDPEL:8888801260000100, JML BLN:1, NO HP:<br/>
        EKI HENDRAWANBRATA<br/>
        : <br/>
        140E9C17B55641D188E4E010E8741C76<br/>
        TAG Rp:255.000<br/>
        ADM Rp:2.500<br/>
        TOTAL Rp:257.500<br/>
        SUKSES</text>
      <refnum>140E9C17B55641D188E4E010E8741C76</refnum>
      <input1>8888801260000100</input1>
      <jmltagihan>255000
      </jmltagihan>
      <admin>2500</admin>
      <totaltag>257500</totaltag>
      <info1/>
    </root>
    

    Contoh response Error:

    <?xml version="1.0"?>
    <root>
      <status>ERROR</status>
      <rc>0013</rc>
      <rcm>Jumlah Yang Harus Dibayar Tidak Valid</rcm>
    </root> 
    

Keterangan:

  1. cid = identitas mitra, akan diinfokan ke mitra pada saat test maupun production.
  2. dt = tanggal jam transaksi (YYYYMMDD).
  3. hc = SHA256(cid+dt+secret key) , secret key dan cid akan diinfokan ke mitra pada saat test maupun production.
  4. Semua info/nilai yang diapit oleh {…} wajib diganti dengan nilai yang seharusnya (tanpa mengandung {}).
  5. resp merupakan format respon yang diinginkan (XML), secara default jika dikosongkan maka responnya merupakan format plaintext.
  6. INPUT 1 : Id Pelanggan
  7. INPUT 2 : Jumlah Bulan
  8. BILLER merupakan Kode Biller untuk BPJS KS yaitu 0060012