API Services

Keagenan

Version 1.15
 
1. Keagenan PING
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
typereq String Yes Request type. Default “ping”
Response Definition
Name Type Description
status String If success, value is “true” else “false”
code String Default “1”
data String Message ping successfully
Response (error) See Response Code

Request

{  
   "typereq":"ping"
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{  
   "status":true,
   "code":"1",
   "data":"Access from 172.18.1.242 at 2018?01?19 11:02:58"
}

Response (error)

{  
   "status":false,
   "error":"Unauthorized"
}
 
2. TELKOM - Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.areaCode String Yes Area code of the customer phone number (TELKOM phone number)
typereq String Yes Request type. Default “trans”
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
ket String Transaction description
reffNum String Reference number, as perRequest
amount String Total of amount payment
areaCode String Area code of the customerphone number (TELKOM phone number), as perRequest
phoneNum String Customer phone number (TELKOM phone number), as perRequest
divreCode String TELKOM divre code
NPWP String Customer's NPWP
paymentFlag String Payment flag
amountBill String Amount of billing
datelCode String Region code
billAmount1 String Amount payment of billing 1
billRef1 String Reference number of billing 1
billAmount2 String Amount payment of billing 2
billRef2 String Reference number of billing 2
billAmount3 String Amount payment of billing 3
billRef3 String Reference number of billing 3
Response (error) See Response Code

Request

{  
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR439",
   "data":{  
      "clientId":"IBOC",
      "reffNum":"20161028110953000001",
      "areaCode":"0021",
      "phoneNum":"998877441"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{  
   "error":false,
   "ket":"Telkom Inquiry",
   "reffNum":"20170810170406998877",
   "amount":"65000",
   "areaCode":"0021",
   "phoneNum":"998877441",
   "divreCode":"020201",
   "NPWP":"123456789012345",
   "customerName":"EDWARD VAN DER KAAT",
   "paymentFlag":"02",
   "amountBill":"2",
   "datelCode":"0201",
   "billAmount1":"",
   "billRef1":"",
   "billAmount2":"30000",
   "billRef2":"209A238010",
   "billAmount3":"35000",
   "billRef3":"208A837050"
}

Response (error)

{  
   "error":true,
   "errorNum":"TELKOM91",
   "message":"Pastikan nomor yang Anda input benar"
}
 
3. TELKOM - Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.areaCode String Yes Area code of the customer phone number (TELKOM phone number)
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.providerId String Yes Default “TELKOM”
data.amount String Yes Total of amount payment. Same value as Inquiry response
data.divreCode String Yes TELKOM divre code. Same value as Inquiry response
data.NPWP String Yes Customer NPWP. Same value as Inquiry response
data.customerName String Yes Customer Name. Same value as Inquiry response
data.paymentFlag String Yes Payment flag. Same value as Inquiry response
data.amountBill String Yes Amount of billing. Same value as Inquiry response
data.datelCode String Yes Region code. Same value as Inquiry response
data.billAmount1 String Yes Amount payment of billing 1. Same value as Inquiry response
data.billRef1 String Yes Reference numberof billing 1. Same value as Inquiry response
data.billAmount2 String Yes Amount payment of billing 2. Same value as Inquiry response
data.billRef2 String Yes Reference numberof billing 2. Same value as Inquiry response
data.billAmount3 String Yes Amount payment of billing 3. Same value as Inquiry response
data.billRef3 String Yes Reference numberof billing 3. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
Response Definition
Name Type Description
trxType String Transaction type. “20” is for TELKOM payment
status String Connection status with 3rd parties.
data.error String Transaction status. If transaction is success, value will be “false” else “true”
data.ket String Transaction description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
data.amountBill String Amount of billing.Same value as Payment request
data.amount String Total of amount payment.Same value as Payment request
data.billAmount1 String Amount payment of billing 1. Same value as Payment request
data.billAmount2 String Amount payment of billing 2. Same value as Payment request
data.billAmount3 String Amount payment of billing 3. Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.biaya_adm String Transaction admin fee
CustomerData.no_tel String Area code of the customer’s phone number + customer’s phone number
CustomerData.nominal String Total of amount payment.
CustomerData.time String Transaction datetime
Response (error) See Response Code

Request

{  
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR440",
   "data":{  
      "kode_mitra":"IPY",
      "kode_loket":"00005",
      "kode_cabang":"014",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "reffNum":"20151203111111111311",
      "providerId":"TELKOM",
      "amount":"65000",
      "areaCode":"0021",
      "phoneNum":"998877441",
      "divreCode":"020201",
      "NPWP":"123456789012345",
      "customerName":"JACO VAN NISTELROOY",
      "paymentFlag":"02",
      "amountBill":"2",
      "datelCode":"0201",
      "billAmount1":"",
      "billRef1":"",
      "billAmount2":"30000",
      "billRef2":"209A238010",
      "billAmount3":"35000",
      "billRef3":"208A837050",
      "accountNum":"113020167"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{  
   "trxType":"20",
   "status":"success",
   "data":{  
      "error":false,
      "ket":"TelkomPayment",
      "journal":"941330158 ",
      "financialJournal":"194770",
      "customerName":"JACO VAN NISTELROOY",
      "amountBill":"2",
      "amount":"65000",
      "billAmount1":"",
      "billAmount2":"30000",
      "billAmount3":"35000"
   },
   "result":{  
      "kode_loket":"BNI02250001",
      "kd_lkt":50001,
      "nama":"Ryan Ditya Permadi",
      "kode_cabang":"022",
      "kode_mitra":"BNI",
      "alamat":"1\/1 Jatikarya Jati Sampurna Kota Bekasi Jawa Barat 17435"
   },
   "CustomerData":{  
      "biaya_adm":"2500",
      "no_tel":"0021998877441",
      "nominal":"65000",
      "time":"2015?12?30T10:52:42?08:00"
   }
}

Response (error)

{  
   "trxType":"20",
   "status":"success",
   "data":{  
      "error":true,
      "errorNum":"TELKOM91",
      "message":"Pastikan nomor yang Anda input benar"
   },
   "result":{  
      "kode_loket":"INV259100024",
      "kd_lkt":"100024",
      "nama":"Devi Miraj Pusparini",
      "kode_cabang":"259",
      "kode_mitra":"INV",
      "alamat":"004 Cikini Menteng Kota Jakarta Pusat DKI Jakarta 10330"
   },
   "CustomerData":{  
      "biaya_adm":"2500",
      "no_tel":"00214351603",
      "nominal":"100000",
      "time":"2017-08-02T14:48:54+07:00"
   }
}
 
4. TV Subscription – Indovision - Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
typereq String Yes Request type. Default “trans”
data.customerId String Yes Customer number
data.providerId String Yes Default “INDOVISION”
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
ket String Transaction description
amount String Total of amount payment
NPWP String Customer's NPWP
customerId String Customer Number
customNum String Service period
telkomFlag String Transaction flag, default “02”
numOfBill String Number of billing
billAmount String Amount Payment
Response (error) See Response Code

Request

{  
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR428",
   "data":{  
      "clientId":"IBOC",
      "reffNum":"20151201091320000252",
      "providerId":"INDOVISION",
      "customerId":"0123012345678"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{  
   "error":false,
   "ket":"TV Berlangganan TORABIKA CAPPUCINO NAN UENAKSS",
   "amount":"729000",
   "customerId":"0123012345678",
   "customNum":"30092013-30",
   "npwp":"102013",
   "customerName":"TORABIKA CAPPUCINO NAN UENAKSS",
   "telkomFlag":"02",
   "numOfBill":"1",
   "billAmount":"729000"
}

Response (error)

{  
   "error":true,
   "errorNum":"91",
   "message":"Issuer down"
}
 
5. TV Subscription – Indovision - Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.amount String Yes Total of amount payment. Same value as Inquiry response
data.customerName String Yes Customer Name. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.customerId String Yes Customer number
data.providerId String Yes Default “INDOVISION”
data.customNum String Yes Transaction flag.Same value as Inquiry response
data.npwp String Yes Customer NPWP. Same value as Inquiry response
data.telkomFlag String Yes Transaction flag. Same value as Inquiry response
data.numOfBill String Yes Number of billing. Same value as Inquiry response
data.billAmount String Yes Amount payment. Same value as Inquiry response
Response Definition
Name Type Description
status String Connection status with 3rd parties.
data.error String Transaction status. If transaction is success, value will be “false” else “true”
data.ket String Transaction description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.biaya_adm String Transaction admin fee
CustomerData.nominal String Total of amount payment.
CustomerData.time String Transaction datetime
data.customerId String Customer number.Same value as Payment request
data.reffNum String Transaction reference number.Same value as Payment request
Response (error) See Response Code

Request

{  
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR429",
   "data":{  
      "kode_mitra":"IPY",
      "kode_loket":"00005",
      "kode_cabang":"014",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "reffNum":"20151201091320000255",
      "providerId":"INDOVISION",
      "amount":"700000",
      "customerId":"0123012345678",
      "customNum":"200801 ?20",
      "npwp":"0802",
      "customerName":"HUDI SUKARMA",
      "telkomFlag":"02",
      "numOfBill":"1",
      "billAmount":"700000",
      "accountNum":"115258134"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{  
   "trxType":"40",
   "status":"success",
   "data":{  
      "error":false,
      "ket":"TV Payment Indovision",
      "financialJournal":"317844",
      "journal":"945525391 ",
      "customerId":"0401000040584",
      "customerName":"YUSNITA PRANIDYA",
      "reffNum":"20160212084553050068"
   },
   "result":{  
      "kode_loket":"BNI06650068",
      "kd_lkt":50068,
      "nama":"DENOK WULANDARI",
      "kode_cabang":"066",
      "kode_mitra":"BNI",
      "alamat":"003\/004 Lempeh Sumbawa Kab Sumbawa Nusa Tenggara Barat 
(NTB) 84312"
   },
   "CustomerData":{  
      "biaya_adm":0,
      "nominal":"104900",
      "time":"2016?02?12T08:45:56+07:00"
   }
}

Response (error)

{  
   "trxType":"40",
   "status":"success",
   "data":{  
      "error":true,
      "errorNum":"91",
      "message":"Issuer down"
   },
   "result":{  
      "kode_loket":"IPY01400005",
      "kd_lkt":"00005",
      "nama":"Agung",
      "kode_cabang":"014",
      "kode_mitra":"IPY",
      "alamat":"06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
   },
   "CustomerData":{  
      "biaya_adm":0,
      "nominal":"70000",
      "time":"2018-01-15T10:08:49+07:00"
   }
}
 
6. TV Subscription – Firstmedia - Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
typereq String Yes Request type. Default “trans”
data.customerId String Yes Customer number
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
ket String Transaction description
amount String Total of amount payment
customerId String Customer Number
systemId String Default “FIRSTMEDIA”
channelId String Default “IBOC”
clientId String Default “IBOC”
reffNum String Transaction reference number.Same value as Inquiry request
penalty String Transaction penalty
billReffNo String Bill reference number
kandatelNum String Transaction region code
fee String Bank admin fee
Response (error) See Response Code

Request

{  
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR500",
   "data":{  
      "reffNum":"20170815114523000929",
      "customerId":"11113333"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{  
   "error":false,
   "ket":"First Media Payment",
   "systemId":"FIRSTMEDIA",
   "channelId":"IBOC",
   "clientId":"IBOC",
   "reffNum":"20170823114523000930",
   "amount":"250000",
   "customerId":"11113333",
   "penalty":"0",
   "billReffNo":"111111111111111",
   "customerName":"HAJI MUIDIN",
   "kandatelNum":"0000",
   "fee":"0"
}

Response (error)

{  
   "error":true,
   "errorNum":"91",
   "message":"Transaksi tidak dapat dilakukan. Tidak ada balasan dari database provider/biller. (RC 91)"
}
 
7. TV Subscription – Firstmedia - Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.amount String Yes Total of amount payment. Same value as Inquiry response
data.customerName String Yes Customer Name. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.customerId String Yes Customer number
data.penalty String Yes Transaction penalty.Same value as Inquiry response
data.billReffNo String Yes Bill reference number. Same value as Inquiry response
data.kandatelNum String Yes Transaction region code. Same value as Inquiry response
Response Definition
Name Type Description
status String Connection status with 3rd parties.
data.error String Transaction status. If transaction is success, value will be “false” else “true”
data.ket String Transaction description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
data.amount String Total of amount payment.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.biaya_adm String Transaction admin fee
CustomerData.nominal String Total of amount payment.
CustomerData.time String Transaction datetime
data.customerId String Customer number.Same value as Payment request
data.reffNum String Transaction reference number.Same value as Payment request
trxType String Transaction type. “39” is for Firstmedia payment
data.penalty String Transaction penalty. Same value as Payment request
data.billReffNo String Bill reference number. Same value as Payment request
data.kandatelNum String Transaction region code. Same value as Payment request
data.accountNum String BNI Agent account number. Same value as Payment request
data.fee String Bank admin fee
data.errorNum String Error number, if transaction success value = “”
data.systemId String Default “FIRSTMEDIA”
data.channelId String Default “IBOC”
data.clientId String Default “IBOC”. Same value as Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR427",
   "data":{ 
      "kode_mitra":"BNI",
      "kode_loket":"50309",
      "kode_cabang":"225",
      "pin_transaksi":"12345",
      "reffNum":"20170808114523000995",
      "amount":"25000",
      "customerId":"11113333",
      "penalty":"0",
      "billReffNo":"111111111111111",
      "customerName":"HAJI MUIDIN",
      "kandatelNum":"0000",
      "accountNum":"115258134"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"39",
   "status":"success",
   "data":{ 
      "error":false,
      "ket":"First Media Payment",
      "systemId":"FIRSTMEDIA",
      "channelId":"IBOC",
      "clientId":"IBOC",
      "reffNum":"20170823114523000931",
      "journal":"917530407 ",
      "financialJournal":"469690",
      "amount":"25000",
      "customerId":"11113333",
      "penalty":"0",
      "billReffNo":"111111111111111",
      "customerName":"HAJI MUIDIN",
      "kandatelNum":"0000",
      "accountNum":"115258134",
      "fee":"0",
      "errorNum":""
   },
   "result":{ 
      "kode_loket":"BNI22550309",
      "kd_lkt":"50309",
      "nama":"BNI BANSOS",
      "kode_cabang":"225",
      "kode_mitra":"BNI",
      "alamat":"3/4 Jatikalang Sawahan Kab Sidoarjo JAWA TIMUR 60252"
   },
   "CustomerData":{ 
      "biaya_adm":0,
      "nominal":"25000",
      "time":"2017?08?23T16:18:29+07:00"
   }
}

Response (error)

{ 
   "trxType":"39",
   "status":"success",
   "data":{ 
      "error":true,
      "message":"Nomor pelanggan/billing/handphone/tagihan/kode bayar/kartu tidak ditemukan, pastikan nomor yang Anda masukkan sudah benar. (RC D0)",
      "errorNum":"D0",
      "ori_errorNum":"D0"
   },
   "result":{ 
      "nama":"Desi",
      "alamat":"000 Kebon Sirih Menteng Kota Jakarta Pusat DKI Jakarta 10340",
      "kd_lkt":"100048",
      "kode_loket":"PTN259100048",
      "kode_mitra":"PTN",
      "kode_cabang":"259"
   },
   "CustomerData":{ 
      "time":"2017-11-02T14:10:12+07:00",
      "nominal":"300000"
   }
}
 
8. BPJS KS VA - Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.billingId String Yes BPJS participant VA/billing Id
data.numberOfMonthsOfBills String Yes Number of months of payment, with options 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, dan 12
Response Definition
Name Type Description
error String Transaction status. If transaction is success, value will be “false” else “true"
PAYMENT_TYPE String Default “BPJS_KESEHATAN_VA”
CHANNEL String Default “AGENT”
MCP_ID String Default “BPJS_KESEHATAN_VA”
h_billingId String BPJS participantVA/billing Id. Same value as Inquiry request
h_numberOfMonthsOfBills String Number of months of payment. Same value as Inquiry request
h_customerName String BPJS participant name
h_branchCode String BPJS Branch code
h_branchName String BPJS Branch name
h_currency String Transaction currency
h_totalBills String Total bill
h_memberNumber String BPJS head of participant number
h_totalMember String Number of family member
h_detailBillingId String BPJS Participant billing Id
h_detailPremi String Nominal of participant premi
h_detailName String BPJS participant name
h_inquiryTransId String Inquiry transaction Id
h_transactionId String Transaction Id
biaya_loket String Counter Fee
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR442",
   "data":{ 
      "kode_mitra":"IPY",
      "kode_cabang":"014",
      "kode_loket":"00005",
      "pin_transaksi":"12345",
      "billingId":"8888801260835323",
      "numberOfMonthsOfBills":"1",
      "reffNum":"20160829093604000005"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "PAYMENT_TYPE":"BPJS_KESEHATAN_VA",
   "CHANNEL":"AGENT",
   "MCP_ID":"BPJS_KESEHATAN_VA",
   "h_billingId":"8888801260835323",
   "h_numberOfMonthsOfBills":"1",
   "h_customerName":"SEPTIA HANNY LESTARI",
   "h_branchCode":"1501",
   "h_branchName":"PONTIANAK",
   "h_currency":"IDR",
   "h_totalBills":"25500",
   "c_fee":"5000",
   "h_memberNumber":"0001260835323",
   "h_totalMember":"1",
   "h_detailBillingId":"8888801260835323",
   "h_detailPremi":"25500.0",
   "h_detailName":"SEPTIA HANNY LESTARI",
   "h_inquiryTransId":"20160829T094525N000006J0000000840R030SRAVI0",
   "h_transactionId":"E098CF4618BB556C",
   "biaya_loket":"2500"
}

Response (error)

{ 
   "error":true,
   "errorNum":"20",
   "message":"Transaksi tidak dapat dilakukan. (RC 20)"
}
 
9. BPJS KS VA - Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.billingId String Yes BPJS participant VA/billing Id
data.numberOfMonthsOfBills String Yes Number of months of payment, with options 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, dan 12
data.PAYMENT_TYPE String Yes Default “BPJS_KESEHATAN_VA”. Same value as Inquiry response
data.CHANNEL String Yes Default “AGENT”. Same value as Inquiry response
data.MCP_ID String Yes Default “BPJS_KESEHATAN_VA”. Same value as Inquiry response
data.h_billingId String Yes BPJS participant VA/billing Id. Same value as Inquiry response
data.h_numberOfMonthsOfBills String Yes Number of months of payment. Same value as Inquiry response
data.h_customerName String Yes BPJS participant name. Same value as Inquiry response
data.h_branchCode String Yes BPJS Branch code. Same value as Inquiry response
data.h_branchName String Yes BPJS Branch name. Same value as Inquiry response
data.h_currency String Yes Transaction currency. Same value as Inquiry response
data.h_totalBills String Yes Total bill. Same value as Inquiry response
data.c_fee String Yes Bank admin fee. Same value as Inquiry response
data.h_memberNumber String Yes BPJS head of participant number. Same value as Inquiry response
data.h_totalMember String Yes Number of family member. Same value as Inquiry response
data.h_amountPaid String Yes Default “0”
data.c_payMethod String Yes Default “2”
data.c_dbAccountNum String Yes BNI Agent account number
data.h_totalAmount String Yes Total payment. SUM of the values of data.h_totalBills and data.h_fee
data.h_detailBillingId String Yes BPJS Participant billing Id. Same value as Inquiry response
data.h_detailPremi String Yes Nominal of participant premi. Same value as Inquiry response
data.h_detailName String Yes BPJS participant name. Same value as Inquiry response
data.h_inquiryTransId String Yes Inquiry transaction Id. Same value as Inquiry response
data.h_transactionId String Yes Transaction Id. Same value as Inquiry response
data.c_description String Yes Transaction narration (free text)
data.biaya_loket String Yes Counter Fee. Same value as Inquiry response
Response Definition
Name Type Description
status String Connection status with 3rd parties.
data.error String Transaction status. If transaction is success, value will be “false” else “true”
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.biaya_adm String Transaction admin fee
CustomerData.nominal String Total of amount payment.
CustomerData.time String Transaction datetime
data.errorNum String Error number, if transaction success value = “”
trxType String Transaction type. “101” is for BPJS KS VA payment
data.PAYMENT_TYPE String Default “BPJS_KESEHATAN_VA”. Same value as Payment request
data.CHANNEL String Default “AGENT”. Same value as Payment request
data.MCP_ID String Default “BPJS_KESEHATAN_VA”. Same value as Payment request
data.h_billingId String BPJS participant VA/billing Id. Same value as Payment request
data.h_numberOfMonthsOfBills String Number of months of payment. Same value as Payment request
data.h_customerName String BPJS participant name. Same value as Payment request
data.h_branchCode String BPJS Branch code. Same value as Payment request
data.h_branchName String BPJS Branch name. Same value as Payment request
data.h_currency String Transaction currency. Same value as Payment request
data.h_totalBills String Total bill. Same value as Payment request
data.h_amountPaid String Default “0”. Same value as Payment request
data.status String Transaction status : > SUKSES : success transaction > GAGAL : failed transaction > TRANSAKSI DALAM PROSES : suspend transaction
data.c_fee String Bank admin fee. Same value as Payment request
data.h_totalAmount String Total payment. SUM of the values of data.h_totalBills and data.h_fee
data.c_payMethod String Default “2”. Same value as Payment request
data.c_dbAccountNum String BNI Agent account number. Same value as Payment request
data.c_description String Transaction narration. Same value as Payment request
data.h_memberNumber String BPJS head of participant number. Same value as Payment request
data.h_totalMember String Number of family member. Same value as Payment request
data.trxNum String Transaction number
data.accountNumber String BNI Agent account number. Same value as Payment request
data.trxTime String Transaction time
data.h_transactionId String Transaction Id. Same value as Payment request
data.biaya_loket String Counter fee. Same value as Payment request
CustomerData.noRek String BNI Agent account number
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR443",
   "data":{ 
      "kode_mitra":"IPY",
      "kode_loket":"00005",
      "kode_cabang":"014",
      "pin_transaksi":"12345",
      "accountNum":116724773,
      "reffNum":"20160829093713000005",
      "PAYMENT_TYPE":"BPJS_KESEHATAN_VA",
      "CHANNEL":"AGENT",
      "MCP_ID":"BPJS_KESEHATAN_VA",
      "h_billingId":"8888801260835323",
      "h_numberOfMonthsOfBills":"1",
      "h_customerName":"SEPTIA HANNY LESTARI",
      "h_branchCode":"1501",
      "h_branchName":"PONTIANAK",
      "h_currency":"IDR",
      "h_totalBills":"25500",
      "c_fee":"5000",
      "h_memberNumber":"0001260835323",
      "h_totalMember":"1",
      "h_amountPaid":"0",
      "c_payMethod":"2",
      "c_dbAccountNum":116724773,
      "h_totalAmount":30500,
      "h_detailBillingId":"8888801260835323",
      "h_detailPremi":"25500.0",
      "h_detailName":"SEPTIA HANNY LESTARI",
      "h_inquiryTransId":"20160829T094525N000006J0000000840R030SRAVI0",
      "h_transactionId":"E098CF4618BB556C",
      "biaya_loket":"2500",
      "c_description":"ok"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"101",
   "status":"success",
   "data":{ 
      "error":false,
      "ket":"vabpjsPayment",
      "PAYMENT_TYPE":"BPJS_KESEHATAN_VA",
      "CHANNEL":"AGENT",
      "MCP_ID":"BPJS_KESEHATAN_VA",
      "h_billingId":"8888801260835542",
      "h_numberOfMonthsOfBills":"3",
      "h_customerName":"DIONWIYOKO",
      "h_branchCode":"0101",
      "h_branchName":"TANJUNG PRIOK PONDOK CABE",
      "h_currency":"IDR",
      "h_totalBills":"200000",
      "h_amountPaid":"0",
      "status":"SUKSES",
      "c_fee":"0",
      "h_totalAmount":"200000",
      "c_payMethod":"2",
      "c_dbAccountNum":"125143302",
      "c_description":"undefined",
      "h_memberNumber":"0001835276297",
      "h_totalMember":"6",
      "trxNum":"630939",
      "accountNumber":"125143302",
      "trxTime":"13:16:13",
      "journal":"630939",
      "h_transactionId":"E098CF4618BB556C",
      "errorNum":"",
      "biaya_loket":"2500"
   },
   "result":{ 
      "kode_loket":"KSN25950312",
      "kd_lkt":"50312",
      "nama":"KIOSON",
      "kode_cabang":"259",
      "kode_mitra":"KSN",
      "alamat":"RT 4 Tangsel Setiabudi Jakarta Selatan DKI JAKARTA 12910"
   },
   "CustomerData":{ 
      "biaya_adm":0,
      "noRek":"125143302",
      "nominal":"200000",
      "time":"2017?09?29T13:17:53+07:00"
   }
}

Response (error)

{ 
   "trxType":"101",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"",
      "message":"TRANSAKSI GAGAL : Pin transaksi salah"
   },
   "result":{ 
      "kode_loket":"KSN25950303",
      "kd_lkt":"50303",
      "nama":"Indra Gunawan Wibisono",
      "kode_cabang":"259",
      "kode_mitra":"KSN",
      "alamat":"04\/09 KEBAYORAN LAMA SELATAN KEBAYORAN LAMA JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "biaya_adm":0,
      "noRek":"315647407",
      "nominal":"200000",
      "time":"2017-10-23T11:19:51+08:00"
   }
}
 
10. PDAM - Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
typereq String Yes Request type. Default “trans”
data.providerId String Yes Provider id, value refer to mapping on Appendix 2.5.2 column “provider_id” (According to the chosen PDAM)
data.adminFeeFlag String Yes Admin fee flag, value refer to mapping on Appendix 2.5.2 column “admin_fee_flag” (According to the chosen PDAM)
data.pdam_type String Yes Type of PDAM, value refer to mapping on Appendix 2.5.2 column “pdam_type” (According to the chosen PDAM)
data.billingId String Yes Customer number > PDAM Aggegator : billingId send as per customer input on screen added with the last 2 digit of biller code as prefix. Value of biller code refer to mapping on Appendix 2.5.2 column “biller_code” (According to the chosen PDAM) Example : Customer noinput by customer : 123456 biller code : 131001 billingId : 01123456 > PDAM Non Aggregator : billingId send as per customer input on screen
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
ket String Transaction description
kandatelNum String Transaction region code
billingId String Customer number
flag String Default “02”
billRepeatCount String Amount of bill
langCode String Default “1”
billerCode String Biller code
adminFee String Bank admin fee
billDate String Billing date
billAmount String Bill amount
kubikasi String Total usage
amount String Total payment
response String variable for internal needs
bl_th String Billing period
nominalTagihan String Nominal bill
penalti String Transaction penalty
totalTagihan String Total bill payment
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR479",
   "data":{ 
      "kode_mitra":"BNI",
      "kode_loket":"50309",
      "kode_cabang":"225",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "reffNum":"20170811113337151005",
      "providerId":"AETRA",
      "adminFeeFlag":"1",
      "pdam_type":"NON_AGGREGATOR",
      "billingId":"400"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "ket":"AETRA",
   "billingId":"400",
   "customerName":"SRIYANTO",
   "flag":"02",
   "billRepeatCount":"5",
   "kandatelNum":"",
   "langCode":" 1",
   "billerCode":"1302",
   "adminFee":12500,
   "billDate":[ 
      "201211",
      "201212",
      "201301",
      "201302",
      "201303"
   ],
   "billAmount":[ 
      "000000003500",
      "000000003500",
      "000000003500",
      "000000003500",
      "000000003500"
   ],
   "kubikasi":18000,
   "amount":"371558",
   "response":"<flag>02</flag><billRepeatCount>5</billRepeatCount><adminFee>2500</adminFee><langCode>1</langCode><billDate1>201211</billDate1><billAmount1>000000003500</billAmount1><kubikasi1>00050000?00060000</kubikasi1><billDate2>201212</billDate2><billAmount2>000000003500</billAmount2><kubikasi2>00005000-00007000</kubikasi2><billDate3>201301</billDate3><billAmount3>000000003500</billAmount3><kubikasi3>00005000?00007000</kubikasi3><billDate4>201302</billDate4><billAmount4>000000003500</billAmount4><kubikasi4>00005000?00007000</kubikasi4><billDate5>201303</billDate5><billAmount5>000000003500</billAmount5><kubikasi5>00005000?00007000</kubikasi5><billDate6></billDate6><billAmount6></billAmount6><kubikasi6></kubikasi6><billDate7></billDate7><billAmount7></billAmount7><kubikasi7></kubikasi7><billDate8></billDate8><billAmount8></billAmount8><kubikasi8></kubikasi8><billDate9></billDate9><billAmount9></billAmount9><kubikasi9></kubikasi9>",
   "bl_th":"NOV12, DEC12, JAN13, FEB13, MAR13",
   "nominalTagihan":17500,
   "penalti":354058,
   "totalTagihan":384058
}

Response (error)

{ 
   "error":true,
   "errorNum":"91",
   "message":"Transaksi tidak dapat dilakukan. Tidak ada balasan dari database provider/biller. (RC 91)"
}
 
11. PDAM - Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.customerName String Yes Customer Name. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.providerId String Yes Provider id, value refer to mapping on Appendix 2.5.2 column “provider_id” (According to the chosen PDAM)
data.billingId String Yes Customer number. Same value as Inquiry response
data.response String Yes Same value as Inquiry response
data.bl_th String Yes Billing period. Same value as Inquiry response
data.penalti String Yes Transaction penalty. Same value as Inquiry response
data.namaPerusahaan String Yes PDAM company name, value refer to mapping on Appendix 2.5.2 column “provider_name” (According to the chosen PDAM)
data.kubikasi String Yes Total usage. Same value as Inquiry response
data.amount String Yes Total payment. Same value as Inquiry response
data.adminFee String Yes Bank admin fee. Same value as Inquiry response
data.nominalTagihan String Yes Nominal bill. Same value as Inquiry response
data.totalTagihan String Yes Total bill payment. Same value as Inquiry response
Response Definition
Name Type Description
status String Connection status with 3rd parties.
data.error String Transaction status. If transaction is success, value will be “false” else “true”
data.ket String Transaction description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.time String Transaction datetime
data.reffNum String Transaction reference number.Same value as Payment request
data.accountNum String BNI Agent account number. Same value as Payment request
data.errorNum String Error number, if transaction success value = “”
CustomerData.noRek String BNI Agent account number
trxType String Transaction type. “69” is for PDAM payment
data.amount String Total payment. Same value as Payment request
data.billingId String Customer number. Same value as Payment request
data.billReffNum String Billing refference number
data.bl_th String Billing period. Same value as Payment request
data.penalti String Transaction penalty. Same value as Payment request
data.kubikasi String Total usage. Same value as Payment request
data.nominalTagihan String Nominal bill. Same value as Payment request
data.totalTagihan String Total bill payment. Same value as Payment request
CustomerData.customerName String Customer name. Same value as Payment request
CustomerData.adminFee String Bank admin fee
CustomerData.namaPerusahaan String PDAM company name. Same value as Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR480",
   "data":{ 
      "kode_mitra":"IPY",
      "kode_loket":"00005",
      "kode_cabang":"014",
      "clientId":"IBOC",
      "reffNum":"20170811113336400026",
      "providerId":"AETRA",
      "billingId":"400",
      "customerName":"SRIYANTO",
      "response":"<flag>02</flag><billRepeatCount>5</billRepeatCount><adminFee>25000</adminFee><langCode>1</langCode><billDate1>201211</billDate1><billAmount1>000000003500</billAmount1><kubikasi1>00050000?00060000</kubikasi1><billDate2>201212</billDate2><billAmount2>000000003500</billAmount2><kubikasi2>00005000?00007000</kubikasi2><billDate3>201301</billDate3><billAmount3>000000003500</billAmount3><kubikasi3>00005000?00007000</kubikasi3><billDate4>201302</billDate4><billAmount4>000000003500</billAmount4><kubikasi4>00005000?00007000</kubikasi4><billDate5>201303</billDate5><billAmount5>000000003500</billAmount5><kubikasi5>00005000?00007000</kubikasi5><billDate6></billDate6><billAmount6></billAmount6><kubikasi6></kubikasi6><billDate7></billDate7><billAmount7></billAmount7><kubikasi7></kubikasi7><billDate8></billDate8><billAmount8></billAmount8><kubikasi8></kubikasi8><billDate9></billDate9><billAmount9></billAmount9><kubikasi9></kubikasi9>",
      "bl_th":"NOV12, DEC12, JAN13, FEB13, MAR13",
      "penalti":"354058",
      "namaPerusahaan":"AETRA",
      "kubikasi":"18000",
      "amount":"371558",
      "adminFee":"125000",
      "nominalTagihan":"17500",
      "totalTagihan":"496558",
      "pin_transaksi":"12345",
      "accountNum":"115208477"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"69",
   "status":"success",
   "data":{ 
      "error":false,
      "ket":"AETRA",
      "reffNum":"20170811113336400026",
      "journal":"938490834 ",
      "financialJournal":"456261",
      "amount":"371558",
      "billingId":"400",
      "billReffNum":"132R94610001",
      "customerName":"SRIYANTO",
      "accountNum":"115208477",
      "bl_th":"NOV12, DEC12, JAN13, FEB13, MAR13",
      "penalti":"354058",
      "kubikasi":"18000",
      "nominalTagihan":"17500",
      "totalTagihan":"496558",
      "errorNum":""
   },
   "result":{ 
      "kode_loket":"IPY01400005",
      "kd_lkt":"00005",
      "nama":"Agung",
      "kode_cabang":"014",
      "kode_mitra":"IPY",
      "alamat":"06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
   },
   "CustomerData":{ 
      "noRek":"115208477",
      "customerName":"SRIYANTO",
      "adminFee":"125000",
      "namaPerusahaan":"AETRA",
      "time":"2017?08?11T17:40:29+07:00"
   }
}

Response (error)

{ 
   "trxType":"69",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"",
      "message":"TRANSAKSI GAGAL : Pin transaksi salah"
   },
   "result":{ 
      "kode_loket":"KSN25950312",
      "kd_lkt":"50312",
      "nama":"KIOSON",
      "kode_cabang":"259",
      "kode_mitra":"KSN",
      "alamat":"RT 4 Tangsel Setiabudi Jakarta Selatan DKI JAKARTA 12910"
   },
   "CustomerData":{ 
      "noRek":"116908716",
      "customerName":"SRIYANTO",
      "adminFee":5000,
      "namaPerusahaan":"AETRA",
      "time":"2017-09-20T15:25:15+07:00"
   }
}
 
12. Multifinance - Adira - Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.providerId String Yes Default “ADIRA_FINANCE”
data.billingId String Yes Customer’s billing number
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
Provider String Multifinance’s provider name
billerCode String Multifinance’s biller code
billingId String Customer’s bill number
totalBill String Customer’s total bill
installmentNo String Customer’s installment number
dueDate String Bill’s due date
policeNo String Police number/vehicle plate
installmentAmount String Customer’s installment amount
finedAmount String Customer’s fined amount
totalInstallment String Customer’s total installment
amount String Customer’s bill amount
collectionFee String Collection fee
langCode String Language code
transactionName String Transaction’s name
cutOffDate String Bill’s cut off date
billingInfo String Billing info
customerType String Customer’s type
mainDebt String Main debt
interest String Interest
outstandingAmount String Outstanding amount
maxPayment String Maximum payment
minPayment String Minimum payment
billReffNum String Bill’s reference number
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR450",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "providerId":"ADIRA_FINANCE",
      "billingId":"0754589745",
      "reffNum":"20170510093604000012"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "provider":"Adira Finance",
   "billerCode":"1003",
   "billingId":"0754589745",
   "totalBill":"2920000",
   "installmentNo":"10",
   "dueDate":"20121224?20121224",
   "policeNo":"",
   "installmentAmount":"2900000",
   "finedAmount":"20000",
   "totalInstallment":"2920000",
   "amount":"2940000",
   "adminFee":"0",
   "collectionFee":"0",
   "langCode":"0",
   "transactionName":"FIF KRD MBL MTR",
   "cutOffDate":"20121224",
   "billingInfo":"1",
   "customerName":"ROSTINAH",
   "customerType":"01",
   "mainDebt":"0",
   "interest":"0",
   "outstandingAmount":"0",
   "maxPayment":"2920000",
   "minPayment":"2920000",
   "billReffNum":"136677790105850011"
}

Response (error)

{ 
   "error":true,
   "errorNum":"86"
}
 
13. Multifinance - Adira – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.customerName String Yes Customer Name. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.adminFee String Yes Bank admin fee. Same value as Inquiry response
data.providerId String Yes Default “ADIRA_FINANCE”
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.collectionFee String Yes Collection fee. Same value as Inquiry response
data.langCode String Yes Language code. Same value as Inquiry response
data.transactionName String Yes Transaction’s name. Same value as Inquiry response
data.cutOffDate String Yes Bill’s cut off date. Same value as Inquiry response
data.billingInfo String Yes Billing info. Same value as Inquiry response
data.totalBill String Yes Customer’s total bill. Same value as Inquiry response
data.customerType String Yes Customer’s type. Same value as Inquiry response
data.installmentNo String Yes Customer’s installment number. Same value as Inquiry response
data.dueDate String Yes Bill’s due date. Same value as Inquiry response
data.policeNo String Yes Police number/vehicle plate. Same value as Inquiry response
data.mainDebt String Yes Main debt. Same value as Inquiry response
data.interest String Yes Interest. Same value as Inquiry response
data.installmentAmount String Yes Customer’s installment amount. Same value as Inquiry response
data.finedAmount String Yes Customer’s fined amount. Same value as Inquiry response
data.outstandingAmount String Yes Outstanding amount. Same value as Inquiry response
data.totalInstallment String Yes Customer’s total installment. Same value as Inquiry response
data.maxPayment String Yes Maximum payment. Same value as Inquiry response
data.minPayment String Yes Minimum payment. Same value as Inquiry response
data.billReffNum String Yes Bill’s reference number. Same value as Inquiry response
data.amount String Yes Customer’s bill amount. Same value as Inquiry response
Response Definition
Name Type Description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.time String Transaction datetime
data.reffNum String Transaction reference number.Same value as Payment request
data.errorNum String Error number, if transaction success value = “”
CustomerData.customerName String Customer name. Same value as Payment request
CustomerData.adminFee String Bank admin fee
trxType String Transaction’s type, “68” is for Multifinance payment
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.provider String Multifinance’s provider name
data.amount String Customer’s bill amount. Same value as Payment request
data.billingId String Customer’s bill number. Same value as Payment request
data.accountNum String Agent’s account number. Same value as Payment request
data.billerCode String Multifinance’s biller code
CustomerData.providerId String Multifinance’s provider ID. Same value as Payment request
CustomerData.nominal String Bill’s nominal
CustomerData.finedAmount String Customer’s fined amount. Same value as Payment request
CustomerData.dueDate String Bill’s due date. Same value as Payment request
CustomerData.installmentAmount String Customer’s installment amount. Same value as Payment request
CustomerData.totalInstallment String Customer’s total installment. Same value as Payment request
CustomerData.installmentNo String Customer’s installment number. Same value as Payment request
CustomerData.collectionFee String Collection fee. Same value as Payment request
CustomerData.trxtime String Transaction’s time
CustomerData.policeNo String Police number/vehicle plate. Same value as Payment request
CustomerData.minPayment String Minimum payment. Same value as Payment request
CustomerData.maxPayment String Maximum payment. Same value as Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR451",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "clientId":"IBOC",
      "reffNum":"20170510132923050320",
      "providerId":"ADIRA_FINANCE",
      "billingId":"0754589745",
      "adminFee":"0",
      "collectionFee":"0",
      "langCode":"0",
      "transactionName":"FIF KRD MBL MTR",
      "cutOffDate":"20121224",
      "billingInfo":"1",
      "totalBill":"2920000",
      "customerName":"ROSTINAH",
      "customerType":"01",
      "installmentNo":"10",
      "dueDate":"20121224?20121224",
      "policeNo":"",
      "mainDebt":"0",
      "interest":"0",
      "installmentAmount":"2900000",
      "finedAmount":"20000",
      "outstandingAmount":"0",
      "totalInstallment":"2920000",
      "maxPayment":"2920000",
      "minPayment":"2920000",
      "billReffNum":"136677790105850011",
      "amount":"2970000",
      "accountNum":"116724773",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":false,
      "provider":"FIF KRD MBL MTR",
      "journal":"941020094 ",
      "financialJournal":"307401",
      "amount":"2970000",
      "billingId":"0754589745",
      "accountNum":"116724773",
      "reffNum":"20170510132923050320",
      "billerCode":"1003",
      "customerName":"0ROSTINAH",
      "errorNum":""
   },
   "result":{ 
      "kode_loket":"ARD259100019",
      "kd_lkt":"100019",
      "nama":"LALA",
      "kode_cabang":"259",
      "kode_mitra":"ARD",
      "alamat":"002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "customerName":"ROSTINAH",
      "adminFee":"0",
      "providerId":"ADIRA_FINANCE",
      "nominal":"2970000",
      "finedAmount":"20000",
      "dueDate":"20121224?20121224",
      "installmentAmount":"2900000",
      "totalInstallment":"2920000",
      "installmentNo":"10",
      "collectionFee":"0",
      "time":"2017?05?10T13:42:30+07:00",
      "trxtime":"10?May?2017 13:42:30",
      "policeNo":"",
      "minPayment":"2920000",
      "maxPayment":"2920000"
   }
}

Response (error)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"86",
      "ori_errorNum":"86"
   },
   "result":{ 
      "kode_loket":"AYP259100049",
      "kd_lkt":"100049",
      "nama":"Tommy Yuwono",
      "kode_cabang":"259",
      "kode_mitra":"AYP",
      "alamat":"03/02 Cempaka Putih Barat Cempaka Putih Kota Jakarta Pusat DKI Jakarta 10520"
   },
   "CustomerData":{ 
      "customerName":"USEN",
      "adminFee":"7500",
      "providerId":"ADIRA_FINANCE",
      "nominal":402500,
      "finedAmount":"0",
      "dueDate":"27 OCT 11",
      "installmentAmount":"395000",
      "totalInstallment":"0",
      "installmentNo":"33",
      "collectionFee":"0",
      "time":"2017-11-28T16:14:04+07:00",
      "trxtime":"28-Nov-2017 16:14:04",
      "policeNo":"B6406WBR",
      "minPayment":"395000",
      "maxPayment":"395000"
   }
}
 
14. Multifinance - FIF – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.billingId String Yes Customer’s billing number
data.providerId String Yes Default “FIF”
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
adminFee String Bank admin fee
Provider String Multifinance’s provider name
billerCode String Multifinance’s biller code
billingId String Customer’s bill number
totalBill String Customer’s total bill
installmentNo String Customer’s installment number
dueDate String Bill’s due date
policeNo String Police number/vehicle plate
installmentAmount String Customer’s installment amount
finedAmount String Customer’s fined amount
totalInstallment String Customer’s total installment
amount String Customer’s bill amount
langCode String Language code
transactionName String Transaction’s name
cutOffDate String Bill’s cut off date
billingInfo String Billing info
customerType String Customer’s type
mainDebt String Main debt
interest String Interest
outstandingAmount String Outstanding amount
maxPayment String Maximum payment
minPayment String Minimum payment
billReffNum String Bill’s reference number
collectionFee String General info
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR452",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "providerId":"FIF",
      "billingId":"726000151612",
      "reffNum":"20170512094013050302"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "provider":"FIF",
   "billerCode":"1004",
   "billingId":"726000151612",
   "totalBill":"2920000",
   "installmentNo":"10",
   "dueDate":"20121224?20121224",
   "policeNo":"",
   "installmentAmount":"2900000",
   "finedAmount":"20000",
   "totalInstallment":"2920000",
   "amount":"2920000",
   "adminFee":"0",
   "collectionFee":"0",
   "langCode":"0",
   "transactionName":"FIF KRD MBL MTR",
   "cutOffDate":"20121224",
   "billingInfo":"1",
   "customerName":"ROSTINAH",
   "customerType":"01",
   "mainDebt":"0",
   "interest":"0",
   "outstandingAmount":"0",
   "maxPayment":"2920000",
   "minPayment":"2920000",
   "billReffNum":"136677790105850011"
}

Response (error)

{ 
   "error":true,
   "errorNum":"86"
}
 
15. Multifinance - FIF – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.customerName String Yes Customer Name. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.adminFee String Yes Bank admin fee. Same value as Inquiry response
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.langCode String Yes Language code. Same value as Inquiry response
data.transactionName String Yes Transaction’s name. Same value as Inquiry response
data.cutOffDate String Yes Bill’s cut off date. Same value as Inquiry response
data.billingInfo String Yes Billing info. Same value as Inquiry response
data.totalBill String Yes Customer’s total bill. Same value as Inquiry response
data.customerType String Yes Customer’s type. Same value as Inquiry response
data.installmentNo String Yes Customer’s installment number. Same value as Inquiry response
data.dueDate String Yes Bill’s due date. Same value as Inquiry response
data.policeNo String Yes Police number/vehicle plate. Same value as Inquiry response
data.mainDebt String Yes Main debt. Same value as Inquiry response
data.installmentAmount String Yes Customer’s installment amount. Same value as Inquiry response
data.finedAmount String Yes Customer’s fined amount. Same value as Inquiry response
data.totalInstallment String Yes Customer’s total installment. Same value as Inquiry response
data.maxPayment String Yes Maximum payment. Same value as Inquiry response
data.minPayment String Yes Minimum payment. Same value as Inquiry response
data.billReffNum String Yes Bill’s reference number. Same value as Inquiry response
data.amount String Yes Customer’s bill amount. Same value as Inquiry response
data.providerId String Yes Default “FIF”
data.collectionFee String Yes General info. Same value as Inquiry response
data.interest String Yes FIF admin fee. Same value as Inquiry response
data.outstandingAmount String Yes FIF collection fee. Same value as Inquiry response
Response Definition
Name Type Description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.time String Transaction datetime
data.reffNum String Transaction reference number.Same value as Payment request
data.errorNum String Error number, if transaction success value = “”
CustomerData.customerName String Customer name. Same value as Payment request
CustomerData.adminFee String Bank admin fee
trxType String Transaction’s type, “68” is for Multifinance payment
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.provider String Multifinance’s provider name
data.amount String Customer’s bill amount. Same value as Payment request
data.billingId String Customer’s bill number. Same value as Payment request
data.accountNum String Agent’s account number. Same value as Payment request
data.billerCode String Multifinance’s biller code
CustomerData.providerId String Multifinance’s provider ID. Same value as Payment request
CustomerData.nominal String Bill’s nominal
CustomerData.finedAmount String Customer’s fined amount. Same value as Payment request
CustomerData.dueDate String Bill’s due date. Same value as Payment request
CustomerData.installmentAmount String Customer’s installment amount. Same value as Payment request
CustomerData.totalInstallment String Customer’s total installment. Same value as Payment request
CustomerData.installmentNo String Customer’s installment number. Same value as Payment request
CustomerData.trxtime String Transaction’s time
CustomerData.policeNo String Police number/vehicle plate. Same value as Payment request
CustomerData.minPayment String Minimum payment. Same value as Payment request
CustomerData.maxPayment String Maximum payment. Same value as Payment request
CustomerData.collectionFee String General info. Same value as Payment request
CustomerData.interest String FIF admin fee. Same value as Payment request
CustomerData.outstandingAmount String FIF collection fee. Same value as Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR453",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "clientId":"IBOC",
      "reffNum":"20170512093757050351",
      "providerId":"FIF",
      "billingId":"726000151612",
      "adminFee":"0",
      "collectionFee":"0",
      "langCode":"0",
      "transactionName":"FIF KRD MBL MTR",
      "cutOffDate":"20121224",
      "billingInfo":"1",
      "totalBill":"2920000",
      "customerName":"ROSTINAH",
      "customerType":"01",
      "installmentNo":"10",
      "dueDate":"20121224?20121224",
      "policeNo":"",
      "mainDebt":"0",
      "interest":"0",
      "installmentAmount":"2900000",
      "finedAmount":"20000",
      "outstandingAmount":"0",
      "totalInstallment":"2920000",
      "maxPayment":"2920000",
      "minPayment":"2920000",
      "billReffNum":"136677790105850011",
      "amount":"2930000",
      "accountNum":"115258134",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":false,
      "provider":"FIF KRD MBL MTR",
      "journal":"940060328 ",
      "financialJournal":"308220",
      "amount":"2930000",
      "billingId":"726000151612",
      "accountNum":"115258134",
      "reffNum":"20170512093757050351",
      "billerCode":"1004",
      "customerName":"ROSTINAH",
      "errorNum":""
   },
   "result":{ 
      "kode_loket":"ARD259100019",
      "kd_lkt":"100019",
      "nama":"LALA",
      "kode_cabang":"259",
      "kode_mitra":"ARD",
      "alamat":"002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "customerName":"ROSTINAH",
      "adminFee":"0",
      "providerId":"FIF",
      "nominal":"2930000",
      "finedAmount":"20000",
      "dueDate":"20121224?20121224",
      "installmentAmount":"2900000",
      "totalInstallment":"2920000",
      "installmentNo":"10",
      "collectionFee":"0",
      "time":"2017?05?12T09:42:07+07:00",
      "trxtime":"12?May?2017 09:42:07",
      "policeNo":"",
      "minPayment":"2920000",
      "maxPayment":"2920000",
      "interest":"0",
      "outstandingAmount":"0"
   }
}

Response (error)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"86",
      "ori_errorNum":"86"
   },
   "result":{ 
      "kode_loket":"AYP259100049",
      "kd_lkt":"100049",
      "nama":"Tommy Yuwono",
      "kode_cabang":"259",
      "kode_mitra":"AYP",
      "alamat":"03/02 Cempaka Putih Barat Cempaka Putih Kota Jakarta Pusat DKI Jakarta 10520"
   },
   "CustomerData":{ 
      "customerName":"ROSTINAH",
      "adminFee":"0",
      "providerId":"FIF",
      "nominal":2920000,
      "finedAmount":"20000",
      "dueDate":"20121224-20121224",
      "installmentAmount":"2900000",
      "totalInstallment":"2920000",
      "installmentNo":"10",
      "collectionFee":"0",
      "time":"2017-11-28T16:34:39+07:00",
      "trxtime":"28-Nov-2017 16:34:39",
      "policeNo":"",
      "minPayment":"2920000",
      "maxPayment":"2920000"
   }
}
 
16. Multifinance - OTO Kredit – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.billingId String Yes Customer’s billing number
data.providerId String Yes Default “OTO_FINANCE”
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
adminFee String Bank admin fee
Provider String Multifinance’s provider name
billerCode String Multifinance’s biller code
billingId String Customer’s bill number
totalBill String Customer’s total bill
installmentNo String Customer’s installment number
dueDate String Bill’s due date
policeNo String Police number/vehicle plate
installmentAmount String Customer’s installment amount
finedAmount String Customer’s fined amount
totalInstallment String Customer’s total installment
amount String Customer’s bill amount
collectionFee String Collection fee
langCode String Language code
transactionName String Transaction’s name
cutOffDate String Bill’s cut off date
billingInfo String Billing info
customerType String Customer’s type
mainDebt String Main debt
interest String Interest
outstandingAmount String Outstanding amount
maxPayment String Maximum payment
minPayment String Minimum payment
billReffNum String Bill’s reference number
Response (error) See Response Code

Request

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"86",
      "ori_errorNum":"86"
   },
   "result":{ 
      "kode_loket":"AYP259100049",
      "kd_lkt":"100049",
      "nama":"Tommy Yuwono",
      "kode_cabang":"259",
      "kode_mitra":"AYP",
      "alamat":"03/02 Cempaka Putih Barat Cempaka Putih Kota Jakarta Pusat DKI Jakarta 10520"
   },
   "CustomerData":{ 
      "customerName":"ROSTINAH",
      "adminFee":"0",
      "providerId":"FIF",
      "nominal":2920000,
      "finedAmount":"20000",
      "dueDate":"20121224-20121224",
      "installmentAmount":"2900000",
      "totalInstallment":"2920000",
      "installmentNo":"10",
      "collectionFee":"0",
      "time":"2017-11-28T16:34:39+07:00",
      "trxtime":"28-Nov-2017 16:34:39",
      "policeNo":"",
      "minPayment":"2920000",
      "maxPayment":"2920000"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "provider":"OTO Kredit Mobil/Motor",
   "billerCode":"1002",
   "billingId":"01345212443",
   "totalBill":"395000",
   "installmentNo":"33",
   "dueDate":"27 OCT 11",
   "policeNo":"B6406WBR",
   "installmentAmount":"395000",
   "finedAmount":"0",
   "totalInstallment":"0",
   "amount":"395000",
   "adminFee":"2000",
   "collectionFee":"0",
   "langCode":"1",
   "transactionName":"ADIRA FINANCE",
   "cutOffDate":"",
   "billingInfo":"1",
   "customerName":"USEN",
   "customerType":"2",
   "mainDebt":"0",
   "interest":"0",
   "outstandingAmount":"0",
   "maxPayment":"395000",
   "minPayment":"395000",
   "billReffNum":""
}

Response (error)

{ 
   "error":true,
   "errorNum":"86"
}
 
17. Multifinance - OTO Kredit – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.customerName String Yes Customer Name. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.adminFee String Yes Bank admin fee. Same value as Inquiry response
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.collectionFee String Yes Collection fee. Same value as Inquiry response
data.langCode String Yes Language code. Same value as Inquiry response
data.transactionName String Yes Transaction’s name. Same value as Inquiry response
data.cutOffDate String Yes Bill’s cut off date. Same value as Inquiry response
data.billingInfo String Yes Billing info. Same value as Inquiry response
data.totalBill String Yes Customer’s total bill. Same value as Inquiry response
data.customerType String Yes Customer’s type. Same value as Inquiry response
data.installmentNo String Yes Customer’s installment number. Same value as Inquiry response
data.dueDate String Yes Bill’s due date. Same value as Inquiry response
data.policeNo String Yes Police number/vehicle plate. Same value as Inquiry response
data.mainDebt String Yes Main debt. Same value as Inquiry response
data.interest String Yes Interest. Same value as Inquiry response
data.installmentAmount String Yes Customer’s installment amount. Same value as Inquiry response
data.finedAmount String Yes Customer’s fined amount. Same value as Inquiry response
data.outstandingAmount String Yes Outstanding amount. Same value as Inquiry response
data.totalInstallment String Yes Customer’s total installment. Same value as Inquiry response
data.maxPayment String Yes Maximum payment. Same value as Inquiry response
data.minPayment String Yes Minimum payment. Same value as Inquiry response
data.billReffNum String Yes Bill’s reference number. Same value as Inquiry response
data.amount String Yes Customer’s bill amount. Same value as Inquiry response
data.providerId String Yes Default “OTO_FINANCE”
Response Definition
Name Type Description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.time String Transaction datetime
data.reffNum String Transaction reference number.Same value as Payment request
data.errorNum String Error number, if transaction success value = “”
CustomerData.customerName String Customer name. Same value as Payment request
CustomerData.adminFee String Bank admin fee
trxType String Transaction’s type, “68” is for Multifinance payment
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.provider String Multifinance’s provider name
data.amount String Customer’s bill amount. Same value as Payment request
data.billingId String Customer’s bill number. Same value as Payment request
data.accountNum String Agent’s account number. Same value as Payment request
data.billerCode String Multifinance’s biller code
CustomerData.providerId String Multifinance’s provider ID. Same value as Payment request
CustomerData.nominal String Bill’s nominal
CustomerData.finedAmount String Customer’s fined amount. Same value as Payment request
CustomerData.dueDate String Bill’s due date. Same value as Payment request
CustomerData.installmentAmount String Customer’s installment amount. Same value as Payment request
CustomerData.totalInstallment String Customer’s total installment. Same value as Payment request
CustomerData.installmentNo String Customer’s installment number. Same value as Payment request
CustomerData.collectionFee String Collection fee. Same value as Payment request
CustomerData.trxtime String Transaction’s time
CustomerData.policeNo String Police number/vehicle plate. Same value as Payment request
CustomerData.minPayment String Minimum payment. Same value as Payment request
CustomerData.maxPayment String Maximum payment. Same value as Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR455",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "clientId":"IBOC",
      "reffNum":"20170512100902050390",
      "providerId":"OTO_FINANCE",
      "billingId":"01345212443",
      "adminFee":"2000",
      "collectionFee":"0",
      "langCode":"1",
      "transactionName":"ADIRA FINANCE",
      "cutOffDate":"",
      "billingInfo":"1",
      "totalBill":"395000",
      "customerName":"USEN",
      "customerType":"2",
      "installmentNo":"33",
      "dueDate":"27 OCT 11",
      "policeNo":"B6406WBR",
      "mainDebt":"0",
      "interest":"0",
      "installmentAmount":"395000",
      "finedAmount":"0",
      "outstandingAmount":"0",
      "totalInstallment":"0",
      "maxPayment":"395000",
      "minPayment":"395000",
      "billReffNum":"",
      "amount":"397000",
      "accountNum":"115258134",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":false,
      "provider":"FIF KRD MBL MTR",
      "journal":"940060328 ",
      "financialJournal":"308220",
      "amount":"2930000",
      "billingId":"726000151612",
      "accountNum":"115258134",
      "reffNum":"20170512093757050351",
      "billerCode":"1004",
      "customerName":"ROSTINAH",
      "errorNum":""
   },
   "result":{ 
      "kode_loket":"ARD259100019",
      "kd_lkt":"100019",
      "nama":"LALA",
      "kode_cabang":"259",
      "kode_mitra":"ARD",
      "alamat":"002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "customerName":"ROSTINAH",
      "adminFee":"0",
      "providerId":"FIF",
      "nominal":"2930000",
      "finedAmount":"20000",
      "dueDate":"20121224?20121224",
      "installmentAmount":"2900000",
      "totalInstallment":"2920000",
      "installmentNo":"10",
      "collectionFee":"0",
      "time":"2017?05?12T09:42:07+07:00",
      "trxtime":"12?May?2017 09:42:07",
      "policeNo":"",
      "minPayment":"2920000",
      "maxPayment":"2920000"
   }
}

Response (error)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"86",
      "ori_errorNum":"86"
   },
   "result":{ 
      "kode_loket":"AYP259100049",
      "kd_lkt":"100049",
      "nama":"Tommy Yuwono",
      "kode_cabang":"259",
      "kode_mitra":"AYP",
      "alamat":"03/02 Cempaka Putih Barat Cempaka Putih Kota Jakarta Pusat DKI Jakarta 10520"
   },
   "CustomerData":{ 
      "customerName":"ROSTINAH",
      "adminFee":"0",
      "providerId":"OTO_FINANCE",
      "nominal":2920000,
      "finedAmount":"20000",
      "dueDate":"20121224-20121224",
      "installmentAmount":"2900000",
      "totalInstallment":"2920000",
      "installmentNo":"10",
      "collectionFee":"0",
      "time":"2017-11-28T17:52:44+07:00",
      "trxtime":"28-Nov-2017 17:52:44",
      "policeNo":"",
      "minPayment":"2920000",
      "maxPayment":"2920000"
   }
}
 
18. Multifinance - SMS Finance – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.billingId String Yes Customer’s billing number
data.providerId String Yes Default “SMS_FINANCE”
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
adminFee String Bank admin fee
Provider String Multifinance’s provider name
billerCode String Multifinance’s biller code
billingId String Customer’s bill number
totalBill String Customer’s total bill
installmentNo String Customer’s installment number
dueDate String Bill’s due date
policeNo String Police number/vehicle plate
installmentAmount String Customer’s installment amount
finedAmount String Customer’s fined amount
totalInstallment String Customer’s total installment
amount String Customer’s bill amount
collectionFee String Collection fee
langCode String Language code
transactionName String Transaction’s name
cutOffDate String Bill’s cut off date
billingInfo String Billing info
customerType String Customer’s type
mainDebt String Main debt
interest String Interest
outstandingAmount String Outstanding amount
maxPayment String Maximum payment
minPayment String Minimum payment
billReffNum String Bill’s reference number
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR456",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "providerId":"SMS_FINANCE",
      "billingId":"18132135",
      "reffNum":"20170510140850050372"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "provider":"SMS Finance",
   "billerCode":"1006",
   "billingId":"18132135",
   "totalBill":"582500",
   "installmentNo":"13",
   "dueDate":"20120116?20120116",
   "policeNo":"A1934AA",
   "installmentAmount":"577500",
   "finedAmount":"0",
   "totalInstallment":"577500",
   "amount":"57750",
   "adminFee":"5000",
   "collectionFee":"0",
   "langCode":"0",
   "transactionName":"SMS FINANCE KRD MBL MTR",
   "cutOffDate":"20120116",
   "billingInfo":"1",
   "customerName":"HAJIBI",
   "customerType":"01",
   "mainDebt":"577500",
   "interest":"0",
   "outstandingAmount":"0",
   "maxPayment":"0",
   "minPayment":"577500",
   "billReffNum":"135286270631511011"
}

Response (error)

{ 
   "error":true,
   "errorNum":"86"
}
 
19. Multifinance - SMS Finance – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.customerName String Yes Customer Name. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.adminFee String Yes Bank admin fee. Same value as Inquiry response
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.collectionFee String Yes Collection fee. Same value as Inquiry response
data.langCode String Yes Language code. Same value as Inquiry response
data.transactionName String Yes Transaction’s name. Same value as Inquiry response
data.cutOffDate String Yes Bill’s cut off date. Same value as Inquiry response
data.billingInfo String Yes Billing info. Same value as Inquiry response
data.totalBill String Yes Customer’s total bill. Same value as Inquiry response
data.customerType String Yes Customer’s type. Same value as Inquiry response
data.installmentNo String Yes Customer’s installment number. Same value as Inquiry response
data.dueDate String Yes Bill’s due date. Same value as Inquiry response
data.policeNo String Yes Police number/vehicle plate. Same value as Inquiry response
data.mainDebt String Yes Main debt. Same value as Inquiry response
data.interest String Yes Interest. Same value as Inquiry response
data.installmentAmount String Yes Customer’s installment amount. Same value as Inquiry response
data.finedAmount String Yes Customer’s fined amount. Same value as Inquiry response
data.outstandingAmount String Yes Outstanding amount. Same value as Inquiry response
data.totalInstallment String Yes Customer’s total installment. Same value as Inquiry response
data.maxPayment String Yes Maximum payment. Same value as Inquiry response
data.minPayment String Yes Minimum payment. Same value as Inquiry response
data.billReffNum String Yes Bill’s reference number. Same value as Inquiry response
data.amount String Yes Customer’s bill amount. Same value as Inquiry response
data.providerId String Yes Default “SMS_FINANCE”
Response Definition
Name Type Description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.time String Transaction datetime
data.reffNum String Transaction reference number.Same value as Payment request
data.errorNum String Error number, if transaction success value = “”
CustomerData.customerName String Customer name. Same value as Payment request
CustomerData.adminFee String Bank admin fee
trxType String Transaction’s type, “68” is for Multifinance payment
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.provider String Multifinance’s provider name
data.amount String Customer’s bill amount. Same value as Payment request
data.billingId String Customer’s bill number. Same value as Payment request
data.accountNum String Agent’s account number. Same value as Payment request
data.billerCode String Multifinance’s biller code
CustomerData.providerId String Multifinance’s provider ID. Same value as Payment request
CustomerData.nominal String Bill’s nominal
CustomerData.finedAmount String Customer’s fined amount. Same value as Payment request
CustomerData.dueDate String Bill’s due date. Same value as Payment request
CustomerData.installmentAmount String Customer’s installment amount. Same value as Payment request
CustomerData.totalInstallment String Customer’s total installment. Same value as Payment request
CustomerData.installmentNo String Customer’s installment number. Same value as Payment request
CustomerData.collectionFee String Collection fee. Same value as Payment request
CustomerData.trxtime String Transaction’s time
CustomerData.policeNo String Police number/vehicle plate. Same value as Payment request
CustomerData.minPayment String Minimum payment. Same value as Payment request
CustomerData.maxPayment String Maximum payment. Same value as Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR457",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "clientId":"IBOC",
      "reffNum":"20170510154811050309",
      "providerId":"SMS_FINANCE",
      "billingId":"18132135",
      "adminFee":"5000",
      "collectionFee":"0",
      "langCode":"0",
      "transactionName":"SMS FINANCE KRD MBL MTR",
      "cutOffDate":"20120116",
      "billingInfo":"1",
      "totalBill":"582500",
      "customerName":"HAJIBI",
      "customerType":"01",
      "installmentNo":"13",
      "dueDate":"20120116?20120116",
      "policeNo":"A1934AA",
      "mainDebt":"577500",
      "interest":"0",
      "installmentAmount":"577500",
      "finedAmount":"0",
      "outstandingAmount":"0",
      "totalInstallment":"577500",
      "maxPayment":"0",
      "minPayment":"577500",
      "billReffNum":"135286270631511011",
      "amount":"57750",
      "accountNum":"116724773",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":false,
      "provider":"FIF KRD MBL MTR",
      "journal":"940060328 ",
      "financialJournal":"308220",
      "amount":"2930000",
      "billingId":"726000151612",
      "accountNum":"115258134",
      "reffNum":"20170512093757050351",
      "billerCode":"1004",
      "customerName":"ROSTINAH",
      "errorNum":""
   },
   "result":{ 
      "kode_loket":"ARD259100019",
      "kd_lkt":"100019",
      "nama":"LALA",
      "kode_cabang":"259",
      "kode_mitra":"ARD",
      "alamat":"002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "customerName":"ROSTINAH",
      "adminFee":"0",
      "providerId":"FIF",
      "nominal":"2930000",
      "finedAmount":"20000",
      "dueDate":"20121224?20121224",
      "installmentAmount":"2900000",
      "totalInstallment":"2920000",
      "installmentNo":"10",
      "collectionFee":"0",
      "time":"2017?05?12T09:42:07+07:00",
      "trxtime":"12?May?2017 09:42:07",
      "policeNo":"",
      "minPayment":"2920000",
      "maxPayment":"2920000"
   }
}

Response (error)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"86",
      "ori_errorNum":"86"
   },
   "result":{ 
      "kode_loket":"AYP259100049",
      "kd_lkt":"100049",
      "nama":"Tommy Yuwono",
      "kode_cabang":"259",
      "kode_mitra":"AYP",
      "alamat":"03/02 Cempaka Putih Barat Cempaka Putih Kota Jakarta Pusat DKI Jakarta 10520"
   },
   "CustomerData":{ 
      "customerName":"HAJIBI",
      "adminFee":"5000",
      "providerId":"SMS_FINANCE",
      "nominal":62750,
      "finedAmount":"0",
      "dueDate":"20120116-20120116",
      "installmentAmount":"577500",
      "totalInstallment":"577500",
      "installmentNo":"13",
      "collectionFee":"0",
      "time":"2017-11-28T17:12:14+07:00",
      "trxtime":"28-Nov-2017 17:12:14",
      "policeNo":"A1934AA",
      "minPayment":"577500",
      "maxPayment":"0"
   }
}
 
20. Multifinance - NSC Finance – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.billingId String Yes Customer’s billing number
data.providerId String Yes Default “NSC_FINANCE”
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
adminFee String Bank admin fee
Provider String Multifinance’s provider name
billerCode String Multifinance’s biller code
billingId String Customer’s bill number
totalBill String Customer’s total bill
installmentNo String Customer’s installment number
dueDate String Bill’s due date
policeNo String Police number/vehicle plate
installmentAmount String Customer’s installment amount
finedAmount String Customer’s fined amount
totalInstallment String Customer’s total installment
amount String Customer’s bill amount
collectionFee String Collection fee
langCode String Language code
transactionName String Transaction’s name
cutOffDate String Bill’s cut off date
billingInfo String Billing info
customerType String Customer’s type
mainDebt String Main debt
interest String Interest
outstandingAmount String Outstanding amount
maxPayment String Maximum payment
minPayment String Minimum payment
billReffNum String Bill’s reference number
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR458",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "providerId":"NSC_FINANCE",
      "billingId":"100132",
      "reffNum":"20170510140850050372"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "provider":"NSC Finance",
   "billerCode":"1007",
   "billingId":"100132",
   "totalBill":"350000",
   "installmentNo":"25",
   "dueDate":"25112013?05122013",
   "policeNo":"B1506WUT",
   "installmentAmount":"350000",
   "finedAmount":"1000",
   "totalInstallment":"351000",
   "amount":"351000",
   "adminFee":"0",
   "collectionFee":"0",
   "langCode":"0",
   "transactionName":"NSC FINANCE",
   "cutOffDate":"22082004",
   "billingInfo":"1",
   "customerName":"JOHN DOE",
   "customerType":"01",
   "mainDebt":"351000",
   "interest":"0",
   "outstandingAmount":"0",
   "maxPayment":"600000",
   "minPayment":"527400",
   "billReffNum":"133766757313319011"
}

Response (error)

{ 
   "error":true,
   "errorNum":"86"
}
 
21. Multifinance - NSC Finance – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.customerName String Yes Customer Name. Same value as Inquiry response
typereq String Yes Request type. Default “trans”
data.adminFee String Yes Bank admin fee. Same value as Inquiry response
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.collectionFee String Yes Collection fee. Same value as Inquiry response
data.langCode String Yes Language code. Same value as Inquiry response
data.transactionName String Yes Transaction’s name. Same value as Inquiry response
data.cutOffDate String Yes Bill’s cut off date. Same value as Inquiry response
data.billingInfo String Yes Billing info. Same value as Inquiry response
data.totalBill String Yes Customer’s total bill. Same value as Inquiry response
data.customerType String Yes Customer’s type. Same value as Inquiry response
data.installmentNo String Yes Customer’s installment number. Same value as Inquiry response
data.dueDate String Yes Bill’s due date. Same value as Inquiry response
data.policeNo String Yes Police number/vehicle plate. Same value as Inquiry response
data.mainDebt String Yes Main debt. Same value as Inquiry response
data.interest String Yes Interest. Same value as Inquiry response
data.installmentAmount String Yes Customer’s installment amount. Same value as Inquiry response
data.finedAmount String Yes Customer’s fined amount. Same value as Inquiry response
data.outstandingAmount String Yes Outstanding amount. Same value as Inquiry response
data.totalInstallment String Yes Customer’s total installment. Same value as Inquiry response
data.maxPayment String Yes Maximum payment. Same value as Inquiry response
data.minPayment String Yes Minimum payment. Same value as Inquiry response
data.billReffNum String Yes Bill’s reference number. Same value as Inquiry response
data.amount String Yes Customer’s bill amount. Same value as Inquiry response
data.providerId String Yes Default “NSC_FINANCE”
Response Definition
Name Type Description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.time String Transaction datetime
data.reffNum String Transaction reference number.Same value as Payment request
data.errorNum String Error number, if transaction success value = “”
CustomerData.customerName String Customer name. Same value as Payment request
CustomerData.adminFee String Bank admin fee
trxType String Transaction’s type, “68” is for Multifinance payment
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.provider String Multifinance’s provider name
data.amount String Customer’s bill amount. Same value as Payment request
data.billingId String Customer’s bill number. Same value as Payment request
data.accountNum String Agent’s account number. Same value as Payment request
data.billerCode String Multifinance’s biller code
CustomerData.providerId String Multifinance’s provider ID. Same value as Payment request
CustomerData.nominal String Bill’s nominal
CustomerData.finedAmount String Customer’s fined amount. Same value as Payment request
CustomerData.dueDate String Bill’s due date. Same value as Payment request
CustomerData.installmentAmount String Customer’s installment amount. Same value as Payment request
CustomerData.totalInstallment String Customer’s total installment. Same value as Payment request
CustomerData.installmentNo String Customer’s installment number. Same value as Payment request
CustomerData.collectionFee String Collection fee. Same value as Payment request
CustomerData.trxtime String Transaction’s time
CustomerData.policeNo String Police number/vehicle plate. Same value as Payment request
CustomerData.minPayment String Minimum payment. Same value as Payment request
CustomerData.maxPayment String Maximum payment. Same value as Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR459",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "clientId":"IBOC",
      "reffNum":"20170512103150050372",
      "providerId":"NSC_FINANCE",
      "billingId":"100132",
      "adminFee":"0",
      "collectionFee":"0",
      "langCode":"0",
      "transactionName":"NSC FINANCE",
      "cutOffDate":"22082004",
      "billingInfo":"1",
      "totalBill":"350000",
      "customerName":"JOHN DOE",
      "customerType":"01",
      "installmentNo":"25",
      "dueDate":"25112013?05122013",
      "policeNo":"B1506WUT",
      "mainDebt":"351000",
      "interest":"0",
      "installmentAmount":"350000",
      "finedAmount":"1000",
      "outstandingAmount":"0",
      "totalInstallment":"351000",
      "maxPayment":"600000",
      "minPayment":"527400",
      "billReffNum":"133766757313319011",
      "amount":"351000",
      "accountNum":"115258134",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":false,
      "provider":"NSC FINANCE",
      "journal":"934050391 ",
      "financialJournal":"308401",
      "amount":"351000",
      "billingId":"100132",
      "accountNum":"115258134",
      "reffNum":"20170512103150050372",
      "billerCode":"1007",
      "customerName":"JOHN DOE",
      "errorNum":""
   },
   "result":{ 
      "kode_loket":"ARD259100019",
      "kd_lkt":"100019",
      "nama":"LALA",
      "kode_cabang":"259",
      "kode_mitra":"ARD",
      "alamat":"002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "customerName":"JOHN DOE",
      "adminFee":"0",
      "providerId":"NSC_FINANCE",
      "nominal":"351000",
      "finedAmount":"1000",
      "dueDate":"25112013-05122013",
      "installmentAmount":"350000",
      "totalInstallment":"351000",
      "installmentNo":"25",
      "collectionFee":"0",
      "time":"2017-05-12T10:36:12+07:00",
      "trxtime":"12-May-2017 10:36:12",
      "policeNo":"B1506WUT",
      "minPayment":"527400",
      "maxPayment":"600000"
   }
}

Response (error)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"86",
      "ori_errorNum":"86"
   },
   "result":{ 
      "kode_loket":"AYP259100049",
      "kd_lkt":"100049",
      "nama":"Tommy Yuwono",
      "kode_cabang":"259",
      "kode_mitra":"AYP",
      "alamat":"03/02 Cempaka Putih Barat Cempaka Putih Kota Jakarta Pusat DKI Jakarta 10520"
   },
   "CustomerData":{ 
      "customerName":"AKU ADALAH KATHREEN YANG MANIS",
      "adminFee":"5000",
      "providerId":"NSC_FINANCE",
      "nominal":356000,
      "finedAmount":"1000",
      "dueDate":"25112013-05122013",
      "installmentAmount":"350000",
      "totalInstallment":"351000",
      "installmentNo":"25",
      "collectionFee":"0",
      "time":"2017-11-28T17:44:37+07:00",
      "trxtime":"28-Nov-2017 17:44:37",
      "policeNo":"B1506WUT",
      "minPayment":"527400",
      "maxPayment":"600000"
   }
}
 
22. Multifinance – KreditPlus– Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.billingId String Yes Customer’s billing number
data.providerId String Yes Default “KREDITPLUS”
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
adminFee String Bank admin fee
Provider String Multifinance’s provider name
billerCode String Multifinance’s biller code
billingId String Customer’s bill number
totalBill String Customer’s total bill
installmentNo String Customer’s installment number
dueDate String Bill’s due date
policeNo String Police number/vehicle plate
installmentAmount String Customer’s installment amount
finedAmount String Customer’s fined amount
totalInstallment String Customer’s total installment
amount String Customer’s bill amount
collectionFee String Collection fee
langCode String Language code
transactionName String Transaction’s name
cutOffDate String Bill’s cut off date
billingInfo String Billing info
customerType String Customer’s type
mainDebt String Main debt
interest String Interest
outstandingAmount String Outstanding amount
maxPayment String Maximum payment
minPayment String Minimum payment
billReffNum String Bill’s reference number
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR460",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "providerId":"KREDITPLUS",
      "billingId":"90043012007177",
      "reffNum":"20170510155829050312"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "provider":"Finansia/Kreditplus",
   "billerCode":"1005",
   "billingId":"90043012007177",
   "totalBill":"390000",
   "installmentNo":"00006",
   "dueDate":"20121028?20121028",
   "policeNo":"D1293HB",
   "installmentAmount":"390000",
   "finedAmount":"0",
   "totalInstallment":"390000",
   "amount":"390000",
   "adminFee":"0",
   "collectionFee":"0",
   "langCode":"0",
   "transactionName":"FMF KRD MBL MTR",
   "cutOffDate":"20121028",
   "billingInfo":"1",
   "customerName":"MARENDRA GLADIYAKTI",
   "customerType":"01",
   "mainDebt":"390000",
   "interest":"0",
   "outstandingAmount":"0",
   "maxPayment":"0",
   "minPayment":"0",
   "billReffNum":"135234950292480011"
}

Response (error)

{ 
   "error":true,
   "errorNum":"86"
}
 
23. Multifinance – KreditPlus – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.customerName String Yes Customer Name. Same value as Inquiry response
typereq String Yes Request type. Default “trans”
data.adminFee String Yes Bank admin fee. Same value as Inquiry response
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.collectionFee String Yes Collection fee. Same value as Inquiry response
data.langCode String Yes Language code. Same value as Inquiry response
data.transactionName String Yes Transaction’s name. Same value as Inquiry response
data.cutOffDate String Yes Bill’s cut off date. Same value as Inquiry response
data.billingInfo String Yes Billing info. Same value as Inquiry response
data.totalBill String Yes Customer’s total bill. Same value as Inquiry response
data.customerType String Yes Customer’s type. Same value as Inquiry response
data.installmentNo String Yes Customer’s installment number. Same value as Inquiry response
data.dueDate String Yes Bill’s due date. Same value as Inquiry response
data.policeNo String Yes Police number/vehicle plate. Same value as Inquiry response
data.mainDebt String Yes Main debt. Same value as Inquiry response
data.interest String Yes Interest. Same value as Inquiry response
data.installmentAmount String Yes Customer’s installment amount. Same value as Inquiry response
data.finedAmount String Yes Customer’s fined amount. Same value as Inquiry response
data.outstandingAmount String Yes Outstanding amount. Same value as Inquiry response
data.totalInstallment String Yes Customer’s total installment. Same value as Inquiry response
data.maxPayment String Yes Maximum payment. Same value as Inquiry response
data.minPayment String Yes Minimum payment. Same value as Inquiry response
data.billReffNum String Yes Bill’s reference number. Same value as Inquiry response
data.amount String Yes Customer’s bill amount. Same value as Inquiry response
data.providerId String Yes Default “KREDITPLUS”
Response Definition
Name Type Description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.time String Transaction datetime
data.errorNum String Error number, if transaction success value = “”
CustomerData.customerName String Customer name. Same value as Payment request
CustomerData.adminFee String Bank admin fee
trxType String Transaction’s type, “68” is for Multifinance payment
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.provider String Multifinance’s provider name
data.amount String Customer’s bill amount. Same value as Payment request
data.billingId String Customer’s bill number. Same value as Payment request
data.accountNum String Agent’s account number. Same value as Payment request
data.billerCode String Multifinance’s biller code
CustomerData.providerId String Multifinance’s provider ID. Same value as Payment request
CustomerData.nominal String Bill’s nominal
CustomerData.finedAmount String Customer’s fined amount. Same value as Payment request
CustomerData.dueDate String Bill’s due date. Same value as Payment request
CustomerData.installmentAmount String Customer’s installment amount. Same value as Payment request
CustomerData.totalInstallment String Customer’s total installment. Same value as Payment request
CustomerData.installmentNo String Customer’s installment number. Same value as Payment request
CustomerData.collectionFee String Collection fee. Same value as Payment request
CustomerData.trxtime String Transaction’s time
CustomerData.policeNo String Police number/vehicle plate. Same value as Payment request
CustomerData.minPayment String Minimum payment. Same value as Payment request
CustomerData.maxPayment String Maximum payment. Same value as Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR461",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "clientId":"IBOC",
      "reffNum":"20170512104054050380",
      "providerId":"KREDITPLUS",
      "billingId":"90043012007177",
      "adminFee":"0",
      "collectionFee":"0",
      "langCode":"0",
      "transactionName":"FMF KRD MBL MTR",
      "cutOffDate":"20121028",
      "billingInfo":"1",
      "totalBill":"390000",
      "customerName":"MARENDRA GLADIYAKTI",
      "customerType":"01",
      "installmentNo":"00006",
      "dueDate":"20121028?20121028",
      "policeNo":"D1293HB",
      "mainDebt":"390000",
      "interest":"0",
      "installmentAmount":"390000",
      "finedAmount":"0",
      "outstandingAmount":"0",
      "totalInstallment":"390000",
      "maxPayment":"0",
      "minPayment":"0",
      "billReffNum":"135234950292480011",
      "amount":"390000",
      "accountNum":"115258134",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":false,
      "provider":"FMF KRD MBL MTR",
      "journal":"945490405 ",
      "financialJournal":"308454",
      "amount":"390000",
      "billingId":"90043012007177",
      "accountNum":"115258134",
      "reffNum":"20170512104054050380",
      "billerCode":"1005",
      "customerName":"MARENDRA GLADIYAKTI",
      "errorNum":""
   },
   "result":{ 
      "kode_loket":"ARD259100019",
      "kd_lkt":"100019",
      "nama":"LALA",
      "kode_cabang":"259",
      "kode_mitra":"ARD",
      "alamat":"002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "customerName":"MARENDRA GLADIYAKTI",
      "adminFee":"0",
      "providerId":"KREDITPLUS",
      "nominal":"390000",
      "finedAmount":"0",
      "dueDate":"20121028?20121028",
      "installmentAmount":"390000",
      "totalInstallment":"390000",
      "installmentNo":"00006",
      "collectionFee":"0",
      "time":"2017?05?12T10:47:43+07:00",
      "trxtime":"12?May?2017 10:47:43",
      "policeNo":"D1293HB",
      "minPayment":"0",
      "maxPayment":"0"
   }
}

Response (error)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"86",
      "ori_errorNum":"86"
   },
   "result":{ 
      "kode_loket":"AYP259100049",
      "kd_lkt":"100049",
      "nama":"Tommy Yuwono",
      "kode_cabang":"259",
      "kode_mitra":"AYP",
      "alamat":"03/02 Cempaka Putih Barat Cempaka Putih Kota Jakarta Pusat DKI Jakarta 10520"
   },
   "CustomerData":{ 
      "customerName":"MARENDRA GLADIYAKTI",
      "adminFee":"0",
      "providerId":"KREDITPLUS",
      "nominal":390000,
      "finedAmount":"0",
      "dueDate":"20121028-20121028",
      "installmentAmount":"390000",
      "totalInstallment":"390000",
      "installmentNo":"00006",
      "collectionFee":"0",
      "time":"2017-11-28T17:35:17+07:00",
      "trxtime":"28-Nov-2017 17:35:17",
      "policeNo":"D1293HB",
      "minPayment":"0",
      "maxPayment":"0"
   }
}
 
24. Multifinance - ACC Finance - Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.billingId String Yes Customer’s billing number
data.providerId String Yes Default “ACC_FINANCE”
Response Definition
Name Type Description
customerName String Customer Name
error String Transaction status. If transaction is success, value will be “false” else “true"
Provider String Multifinance’s provider name
billingId String Customer’s bill number
dueDate String Bill’s due date
installmentAmount String Customer’s installment amount
finedAmount String Customer’s fined amount
amount String Customer’s bill amount
adminFee1 String Admin fee 1
adminFee2 String Admin fee 2
adminFee String Admin fee
reffNum String Transaction’s refference number
telkomFlag String Telkom flag
regionCode String Region code
lateCharge String Customer’s late charge
biaya_adm_bank String Bank’s admin fee
total_amount String Payment’s total amount
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR462",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "pin_transaksi":"12345",
      "clientId":"IBOC",
      "providerId":"ACC_FINANCE",
      "billingId":"01307771239734",
      "reffNum":"20170512102800050310"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "provider":"Astra Credit Company",
   "billingId":"01307771239734",
   "adminFee1":"0",
   "adminFee2":"",
   "adminFee":"0",
   "reffNum":"20171122135442001006",
   "amount":"10300",
   "customerName":"0LELYANA SEBASTIAN BUBBLE",
   "dueDate":" 2008123",
   "installmentAmount":"000000001000",
   "finedAmount":"000000000500",
   "telkomFlag":"02",
   "regionCode":"0100",
   "lateCharge":"000000000010",
   "biaya_adm_bank":"5000",
   "total_amount":15300
}

Response (error)

{ 
   "error":true,
   "errorNum":"14",
   "message":"Nomor pelanggan/billing/handphone/tagihan/kode bayar tidak ditemukan, pastikan nomor yang Anda masukkan sudah benar. (RC 14)",
   "biaya_adm_bank":"5000",
   "total_amount":null
}
 
25. Multifinance - ACC Finance – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.amount String Yes Total of amount payment. Same value as Inquiry response
data.customerName String Yes Customer Name. Same value as Inquiry response
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.adminFee String Yes Bank admin fee. Same value as Inquiry response
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.dueDate String Yes Bill’s due date. Same value as Inquiry response
data.installmentAmount String Yes Customer’s installment amount. Same value as Inquiry response
data.finedAmount String Yes Customer’s fined amount. Same value as Inquiry response
data.providerId String Yes Default “ACC_FINANCE”
data.adminFee1 String Yes Admin fee 1. Same value as Inquiry response
data.adminFee2 String Yes Admin fee 2. Same value as Inquiry response
data.telkomFlag String Yes Telkom flag. Same value as Inquiry response
data.regionCode String Yes Region code. Same value as Inquiry response
data.lateCharge String Yes Customer’s late charge. Same value as Inquiry response
data.biaya_adm_bank String Yes Bank’s admin fee. Same value as Inquiry response
Response Definition
Name Type Description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
data.customerName String Customer name.Same value as Payment request
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.time String Transaction datetime
data.reffNum String Transaction reference number.Same value as Payment request
data.errorNum String Error number, if transaction success value = “”
CustomerData.customerName String Customer name. Same value as Payment request
CustomerData.adminFee String Bank admin fee
trxType String Transaction’s type, “68” is for Multifinance payment
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.amount String Customer’s bill amount. Same value as Payment request
data.billingId String Customer’s bill number. Same value as Payment request
data.accountNum String Agent’s account number. Same value as Payment request
CustomerData.providerId String Multifinance’s provider ID. Same value as Payment request
CustomerData.nominal String Bill’s nominal
CustomerData.finedAmount String Customer’s fined amount. Same value as Payment request
CustomerData.dueDate String Bill’s due date. Same value as Payment request
CustomerData.installmentAmount String Customer’s installment amount. Same value as Payment request
CustomerData.trxtime String Transaction’s time
data.finedAmount String Customer’s fined amount. Same value as Payment request
data.total_amount String Payment’s total amount
CustomerData.telkomFlag String Telkom flag. Same value as Payment request
CustomerData.regionCode String Region code. Same value as Payment request
CustomerData.lateCharge String Customer’s late charge. Same value as Payment request
CustomerData.adminFee1 String Admin fee 1. Same value as Payment request
CustomerData.adminFee2 String Admin fee 2. Same value as Payment request
CustomerData.bankadmin String Bank’s admin fee. Same value as “biaya_adm_bank” on Payment request
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR463",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_cabang":"259",
      "kode_loket":"100019",
      "clientId":"IBOC",
      "reffNum":"20171122111630011013",
      "providerId":"ACC_FINANCE",
      "billingId":"01307771239734",
      "adminFee":"0",
      "adminFee1":"0",
      "adminFee2":"",
      "customerName":"AISUKE GODAI 2",
      "dueDate":"01512300",
      "installmentAmount":"000000010000",
      "finedAmount":"000000002000",
      "telkomFlag":"02",
      "regionCode":"0700",
      "lateCharge":"000000001000",
      "amount":"12800",
      "biaya_adm_bank":"5000",
      "accountNum":"115258134",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":false,
      "journal":"910191573 ",
      "financialJournal":"572659",
      "amount":"12800",
      "billingId":"01307771239734",
      "accountNum":"115258134",
      "reffNum":"20171122111630011013",
      "finedAmount":"000000000020",
      "customerName":"0LELYANA SEBASTIAN BUBBLE",
      "errorNum":"",
      "total_amount":17800
   },
   "result":{ 
      "kode_loket":"ARD259100019",
      "kd_lkt":"100019",
      "nama":"LALA",
      "kode_cabang":"259",
      "kode_mitra":"ARD",
      "alamat":"002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "customerName":"AISUKE GODAI 2",
      "providerId":"ACC_FINANCE",
      "nominal":"12801",
      "finedAmount":"000000002000",
      "dueDate":"01512300",
      "installmentAmount":"000000010000",
      "telkomFlag":"02",
      "time":"2017?11?22T14:11:30+07:00",
      "trxtime":"22?Nov?2017 14:11:30",
      "regionCode":"0700",
      "lateCharge":"000000001000",
      "adminFee":"0",
      "adminFee1":"0",
      "adminFee2":"",
      "bankadmin":"5000"
   }
}

Response (error)

{ 
   "trxType":"68",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"30",
      "message":"Transaksi tidak dapat dilakukan. (RC 30)",
      "ori_errorNum":"30",
      "ori_message":"Message format error",
      "total_amount":15300
   },
   "result":{ 
      "kode_loket":"AYP259100049",
      "kd_lkt":"100049",
      "nama":"Tommy Yuwono",
      "kode_cabang":"259",
      "kode_mitra":"AYP",
      "alamat":"03/02 Cempaka Putih Barat Cempaka Putih Kota Jakarta Pusat DKI Jakarta 10520"
   },
   "CustomerData":{ 
      "customerName":"0LELYANA SEBASTIAN BUBBLE",
      "providerId":"ACC_FINANCE",
      "nominal":10300,
      "finedAmount":"000000000500",
      "dueDate":" 2008123",
      "installmentAmount":"000000001000",
      "telkomFlag":"02",
      "time":"2017-11-28T17:02:40+07:00",
      "trxtime":"28-Nov-2017 17:02:40",
      "regionCode":"0100",
      "lateCharge":"000000000010",
      "adminFee":"0",
      "adminFee1":"0",
      "adminFee2":"",
      "bankadmin":"5000"
   }
}
 
26. Insurance – BNI Life – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
typereq String Yes Request type. Default “trans”
data.providerId String Yes Mapping value of providerId for each payment type : > Initial premium : BNILIFE_PREMI_PERTAMA > Continuation Premium : BNILIFE_PREMI_LANJUTAN > Policy loan : BNILIFE_PINJAMAN_POLIS > Premium Top-up : BNILIFE_TOPUP_PREMI > Reprint Policy : BNILIFE_CETAK_ULANG_POLIS > Re-instatement fee : BNILIFE_BIAYA_CETAK_ULANG_POLIS
data.spajNumber String Yes Customer spaj number
data.amount String Yes Payment amount. For Continuation Premium and Reprint Policy, amount = “” (close payment) Others, value of amount base on input on screen (open payment)
Response Definition
Name Type Description
error String Transaction status. If transaction is success, value will be “false” else “true"
ket String Transaction description
reffNum String Transaction reference number.Same value as Inquiry request
telkomFlag String Telkom flag
amount String Payment amount/bill amount
spajNumber String Customer spaj number. Same value as Inquiry request
name String Customer name
billStatCode String Bill stat code
productIndicator String Product indicator
product1 String Detail product 1
premiAmount1 String Premi amount product 1
product2 String Detail product 2
premiAmount2 String Premi amount product 2
product3 String Detail product 3
premiAmount3 String Premi amount product 3
installment String Installment amount
dueDate String Due Date
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2114534465611173",
   "fiturId":"FTR437",
   "data":{ 
      "clientId":"IBOC",
      "reffNum":"20180118160827051299",
      "providerId":"BNILIFE_PREMI_PERTAMA",
      "spajNumber":"1114568975",
      "amount":"50000"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "ket":"BNI Life PREMIUM TOP UP Inquiry @rillulsyah i8rahim",
   "reffNum":"20180118160827051299",
   "amount":"50000",
   "spajNumber":"1114568975",
   "name":"@rillulsyah i8rahim",
   "telkomFlag":"02",
   "billStatCode":"1",
   "productIndicator":"1901",
   "product1":"",
   "premiAmount1":"",
   "product2":"",
   "premiAmount2":"",
   "product3":"",
   "premiAmount3":"",
   "installment":"",
   "dueDate":""
}

Response (error)

{ 
   "error":true,
   "errorNum":"9990",
   "message":"Duplicate Refference Number"
}
 
27. Insurance – BNI Life – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.telkomFlag String Yes Telkom flag. Same value as Inquiry response
data.providerId String Yes Mapping value of providerId for each payment type : > Initial premium : BNILIFE_PREMI_PERTAMA > Continuation Premium : BNILIFE_PREMI_LANJUTAN > Policy loan : BNILIFE_PINJAMAN_POLIS > Premium Top-up : BNILIFE_TOPUP_PREMI > Reprint Policy : BNILIFE_CETAK_ULANG_POLIS > Re-instatement fee : BNILIFE_BIAYA_CETAK_ULANG_POLIS
data.spajNumber String Yes Customer spaj number
data.amount String Yes Payment amount/bill amount. Same value as Inquiry response
data.spajNumber String Yes Customer spaj number. Same value as Inquiry response
data.installment String Yes Installment amount. Same value as Inquiry response
data.dueDate String Yes Due date. Same value as Inquiry response
data.name String Yes Customer name. Same value as Inquiry response
data.billStatCode String Yes Bill stat code. Same value as Inquiry response
data.productIndicator String Yes Product indicator. Same value as Inquiry response
data.product1 String Yes Detail product 1. Same value as Inquiry response
data.premiAmount1 String Yes Premi amount product 1. Same value as Inquiry response
data.product2 String Yes Detail product 2. Same value as Inquiry response
data.premiAmount2 String Yes Premi amount product 2. Same value as Inquiry response
data.product3 String Yes Detail product 3. Same value as Inquiry response
data.premiAmount3 String Yes Premi amount product 3. Same value as Inquiry response
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.biaya_adm String Transaction admin fee
CustomerData.time String Transaction datetime
data.reffNum String Transaction reference number.Same value as Payment request
status String Transaction’s status
data.error String Transaction status : false : success true : failed
CustomerData.nominal String Bill’s nominal
data.amount String Payment amount/bill amount. Same value as Payment request
data.spajNumber String Customer spaj number. Same value as Payment request
data.name String Customer name. Same value as Payment request
data.telkomFlag String Telkomflag. Same value as Payment request
data.billStatCode String Bill stat code. Same value as Payment request
data.productIndicator String Product indicator. Same value as Payment request
data.product1 String Detail product 1. Same value as Payment request
data.premiAmount1 String Premi amount product 1. Same value as Payment request
data.product2 String Detail product 2. Same value as Payment request
data.premiAmount2 String Premi amount product 2. Same value as Payment request
data.product3 String Detail product 3. Same value as Payment request
data.premiAmount3 String Premi amount product 3. Same value as Payment request
trxType String Transaction’s type, “52” is for Insurance?BNILife payment
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR463",
   "data":{ 
      "kode_mitra":"BNI",
      "kode_loket":"50299",
      "kode_cabang":"259",
      "clientId":"IBOC",
      "reffNum":"20180118161838150299",
      "providerId":"BNILIFE_PREMI_PERTAMA",
      "amount":"50000",
      "spajNumber":"1114568975",
      "installment":"",
      "dueDate":"",
      "name":"@rillulsyah i8rahim",
      "telkomFlag":"02",
      "billStatCode":"1",
      "productIndicator":"1901",
      "product1":"",
      "premiAmount1":"",
      "product2":"",
      "premiAmount2":"",
      "product3":"",
      "premiAmount3":"",
      "accountNum":115208477,
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"52",
   "status":"success",
   "data":{ 
      "error":false,
      "ket":"BNILIFE_PREMI_PERTAMA",
      "journal":"946470191 ",
      "financialJournal":"624412",
      "reffNum":"20180118161838150299",
      "amount":"50000",
      "spajNumber":"1114568975",
      "name":"@RILLULSYAH I8RAHIM",
      "telkomFlag":"02",
      "billStatCode":"1",
      "productIndicator":"1901",
      "product1":"",
      "premiAmount1":"",
      "product2":"",
      "premiAmount2":"",
      "product3":"",
      "premiAmount3":""
   },
   "result":{ 
      "kode_loket":"BNI25950299",
      "kd_lkt":"50299",
      "nama":"Firda A'gen",
      "kode_cabang":"259",
      "kode_mitra":"BNI",
      "alamat":"01/01 Setiabudi Setia Budi Kota Jakarta Selatan DKI Jakarta 12910"
   },
   "CustomerData":{ 
      "biaya_adm":0,
      "nominal":"50000",
      "time":"2018-01-18T16:47:47+07:00"
   }
}

Response (error)

{ 
   "trxType":"52",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"-2",
      "message":"TRANSAKSI GAGAL : Pin transaksi salah"
   },
   "result":{ 
      "kode_loket":"BNI25950299",
      "kd_lkt":"50299",
      "nama":"Firda A'gen",
      "kode_cabang":"259",
      "kode_mitra":"BNI",
      "alamat":"01/01 Setiabudi Setia Budi Kota Jakarta Selatan DKI Jakarta 12910"
   },
   "CustomerData":{ 
      "biaya_adm":0,
      "nominal":"501000",
      "time":"2018-01-18T16:49:27+07:00"
   }
}
 
28. PLN Postpaid – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.systemId String Yes Default “POSTPAID”
data.channelId String Yes Default “NEWIBANK”
data.clientId String Yes Default “NEWIBANK”
data.feeId String Yes Default “00545300”
data.customerId String Yes Customer Id
Response Definition
Name Type Description
error String Transaction status. If transaction is success, value will be “false” else “true"
ket String Transaction description
clientId String Default “NEWIBANK”
customerId String CustomerID
decimalAmount String Decimal amount
currency String Bill’s currency
flag String Flag
billStatus String Number of monthly bills
billStatOut String Number of bill sheet
serviceUnit String Service unit
customGroup1 String Custom Group 1
customGroup2 String Custom Group 2
categoryUsed String Electric power
adminFee String Administrartion fee
PLNReffNum String PLN refference number
serviceUnitPhone String Service unit phone
billPeriod1 String Bill period 1
dueDate1 String Bill due date 1
meterDate1 String Meter date 1
billAmount1 String Bill amount 1
indicator1 String Indicator 1
billIndicator1 String Bill indicator 1
billTax1 String Bill tax 1
billlPinalty1 String Bill pinalty 1
SLALWBP1 String Stand meter 1 (start)
SAHLWBP1 String Stand meter 1 (end)
SLAWBP1 String SLAWBP1
SAHWBP1 String SAHWBP1
SLAKVARH1 String SLAKVARH1
SAHKVARH1 String SAHKVARH1
billPeriod2 String Bill period 2
dueDate2 String Bill due date 2
meterDate2 String Meter date 2
billAmount2 String Bill amount 2
indicator2 String Indicator 2
billIndicator2 String Bill indicator 2
billTax2 String Bill tax 2
billlPinalty2 String Bill pinalty 2
SLALWBP2 String Stand meter 2 (start)
SAHLWBP2 String Stand meter 2 (end)
SLAWBP2 String SLAWBP2
SAHWBP2 String SAHWBP2
SLAKVARH2 String SLAKVARH2
SAHKVARH2 String SAHKVARH2
billPeriod3 String Bill period 3
dueDate3 String Bill due date 3
meterDate3 String Meter date 3
billAmount3 String Bill amount 3
indicator3 String Indicator 3
billIndicator3 String Bill indicator 3
billTax3 String Bill tax 3
billlPinalty3 String Billl pinalty 3
SLALWBP3 String Stand meter 3 (start)
SAHLWBP3 String Stand meter 3 (end)
SLAWBP3 String SLAWBP3
SAHWBP3 String SAHWBP3
SLAKVARH3 String SLAKVARH3
SAHKVARH3 String SAHKVARH3
billPeriod4 String Bill period 4
dueDate4 String Due date 4
meterDate4 String Meter date 4
billAmount4 String Bill amount 4
indicator4 String Indicator 4
billIndicator4 String Bill indicator 4
billTax4 String Bill tax 4
billlPinalty4 String Bill pinalty 4
SLALWBP4 String Stand meter 4 (start)
SAHLWBP4 String Stand meter 4 (end)
SLAWBP4 String SLAWBP4
SAHWBP4 String SAHWBP4
SLAKVARH4 String SLAKVARH4
SAHKVARH4 String SAHKVARH4
billPeriod5 String Bill period 5
dueDate5 String Due date 5
meterDate5 String Meter date 5
billAmount5 String Bill amount 5
indicator5 String Indicator 5
billIndicator5 String Bill indicator 5
billTax5 String Bill tax 5
billlPinalty5 String Bill pinalty 5
SAHLWBP5 String Stand meter 5 (end)
adminFeeParam String Administration fee parameter
response String SOAP response
Response (error) See Response Code

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR493",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_loket":"100019",
      "kode_cabang":"259",
      "systemId":"POSTPAID",
      "channelId":"NEWIBANK",
      "clientId":"NEWIBANK",
      "feeId":"00545300",
      "customerId":"53111",
      "reffNum":"201705171507500100019",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "error":false,
   "ket":"PLN",
   "clientId":"NEWIBANK",
   "customerId":"5311112",
   "decimalAmount":"0",
   "currency":"360",
   "customerName":"PEL POSTPAID 174193",
   "flag":"02",
   "billStatus":"1",
   "regionCode":"5300",
   "billAmount":"1200000",
   "billStatOut":"1",
   "serviceUnit":"53555",
   "customGroup1":"R1",
   "customGroup2":"",
   "categoryUsed":"1300",
   "adminFee":"3000",
   "PLNRefNum":"XVW1V0XYWZY4Z456789AX3VWW23W1WY3",
   "serviceUnitPhone":"0212337890",
   "billPeriode1":"201605",
   "dueDate1":"25052016",
   "meterDate1":"4052016",
   "billAmount1":"1200000",
   "indicator1":"C",
   "billIndicator1":"0",
   "billTax1":"0",
   "billPinalty1":"0",
   "SLALWBP1":"00000100",
   "SAHLWBP1":"00000100",
   "SLAWBP1":"00000200",
   "SAHWBP1":"00000200",
   "SLAKVARH1":"00000300",
   "SAHKVARH1":"00000300",
   "billPeriode2":"0",
   "dueDate2":"0",
   "meterDate2":"0",
   "billAmount2":"0",
   "indicator2":"",
   "billIndicator2":"0",
   "billTax2":"0",
   "billPinalty2":"0",
   "SLALWBP2":"",
   "SAHLWBP2":"",
   "SLAWBP2":"",
   "SAHWBP2":"",
   "SLAKVARH2":"",
   "SAHKVARH2":"",
   "billPeriode3":"0",
   "dueDate3":"0",
   "billAmount3":"0",
   "indicator3":"",
   "billIndicator3":"0",
   "billTax3":"0",
   "billPinalty3":"0",
   "SLALWBP3":"",
   "SAHLWBP3":"",
   "SLAWBP3":"",
   "SAHWBP3":"",
   "SLAKVARH3":"",
   "SAHKVARH3":"",
   "billPeriode4":"0",
   "dueDate4":"0",
   "meterDate4":"0",
   "billAmount4":"0",
   "indicator4":"",
   "billIndicator4":"0",
   "billTax4":"0",
   "billPinalty4":"0",
   "SLALWBP4":"",
   "SAHLWBP4":"",
   "SLAWBP4":"",
   "SAHWBP4":"",
   "SLAKVARH4":"",
   "SAHKVARH4":"",
   "billPeriode5":"0",
   "dueDate5":"0",
   "meterDate5":"0",
   "billAmount5":"0",
   "indicator5":"",
   "billIndicator5":"0",
   "billTax5":"0",
   "billPinalty5":"0",
   "SAHLWBP5":"",
   "adminFeeParam":"3000",
   "response":"<customerId>5311112</customerId><decimalAmount>0</decimalAmount><currency>360</currency><customerName>PEL POSTPAID 174193</customerName><flag>02</flag><billStatus>1</billStatus><regionCode>5300</regionCode><billAmount>1200000</billAmount><billStatOut>1</billStatOut><serviceUnit>53555</serviceUnit><customGroup1>R1</customGroup1><customGroup2/><categoryUsed>1300</categoryUsed><adminFee>3000</adminFee><PLNRefNum>XVW1V0XYWZY4Z456789AX3VWW23W1WY3</PLNRefNum><serviceUnitPhone>0212337890</serviceUnitPhone><billPeriode1>201605</billPeriode1><dueDate1>25052016</dueDate1><meterDate1>4052016</meterDate1><billAmount1>1200000</billAmount1><indicator1>C</indicator1><billIndicator1>0</billIndicator1><billTax1>0</billTax1><billPinalty1>0</billPinalty1><SLALWBP1>00000100</SLALWBP1><SAHLWBP1>00000100</SAHLWBP1><SLAWBP1>00000200</SLAWBP1><SAHWBP1>00000200</SAHWBP1><SLAKVARH1>00000300</SLAKVARH1><SAHKVARH1>00000300</SAHKVARH1><billPeriode2>0</billPeriode2><dueDate2>0</dueDate2><meterDate2>0</meterDate2><billAmount2>0</billAmount2><indicator2/><billIndicator2>0</billIndicator2><billTax2>0</billTax2><billPinalty2>0</billPinalty2><SLALWBP2/><SAHLWBP2/><SLAWBP2/><SAHWBP2/><SLAKVARH2/><SAHKVARH2/><billPeriode3>0</billPeriode3><dueDate3>0</dueDate3><meterDate3>0</meterDate3><billAmount3>0</billAmount3><indicator3/><billIndicator3>0</billIndicator3><billTax3>0</billTax3><billPinalty3>0</billPinalty3><SLALWBP3/><SAHLWBP3/><SLAWBP3/><SAHWBP3/><SLAKVARH3/><SAHKVARH3/><billPeriode4>0</billPeriode4><dueDate4>0</dueDate4><meterDate4>0</meterDate4><billAmount4>0</billAmount4><indicator4/><billIndicator4>0</billIndicator4><billTax4>0</billTax4><billPinalty4>0</billPinalty4><SLALWBP4/><SAHLWBP4/><SLAWBP4/><SAHWBP4/><SLAKVARH4/><SAHKVARH4/><billPeriode5>0</billPeriode5><dueDate5>0</dueDate5><meterDate5>0</meterDate5><billAmount5>0</billAmount5><indicator5/><billIndicator5>0</billIndicator5><billTax5>0</billTax5><billPinalty5>0</billPinalty5><SLALWBP5/><SAHLWBP5/><SLAWBP5/><SAHWBP5/><SLAKVARH5/><SAHKVARH5/><billReffNum/><cardExpiry>6010040517154647</cardExpiry><adminFeeParam>3000</adminFeeParam><switcherRefName>02</switcherRefName>"
}

Response (error)

{ 
   "error":true,
   "errorNum":"05",
   "message":"Error undefined"
}
 
29. PLN Postpaid – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.systemId String Yes Default “POSTPAID”
data.channelId String Yes Default “NEWIBANK”
data.clientId String Yes Default “NEWIBANK”
data.feeId String Yes Default “00545300”
data.customerId String Yes Customer Id
data.amount String Yes Bill’s amount
data.adminFeeParam String Yes Administration fee parameter
data.response String Yes SOAP response. Same value as Inquiry response.
data.bl_th String Yes Bill periode (*format on Notes, click Show to open Notes)
data.daya String Yes Electric power (*format on Notes, click Show to open Notes)
data.stand_meter String Yes Stand meter (*format on Notes, click Show to open Notes)
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
result.kode_loket String Agent code
result.kd_lkt String Code for counter of MITRA
result.nama String Agent name
result.kode_cabang String BNI branch code
result.kode_mitra String Code for MITRA
result.alamat String Agent address
CustomerData.biaya_adm String Transaction admin fee
data.reffNum String Transaction reference number.Same value as Payment request
status String Transaction’s status
data.error String Transaction status : false : success true : failed
CustomerData.nominal String Bill’s nominal
trxType String Transaction’s type, “90” is for PLN Postpaid payment
data.clientId String Default “NEWIBANK”
data.customerId String Customer ID
data.billStatus String Agent’s account number. Same value as Payment request
data.billStatOut String Transaction’s refference number. Same value as Payment request
data.PLNReffNum String Customer’s fined amount. Same value as Payment request
data.adminFee String Administration fee. Same value as Payment request
data.switcherRefNum String Switcher refference number
data.switcherRefName String Switcher refference name
data.PLNNote String PLN Note
data.unpaidBillNote String Unpaid bill note
data.adminFeeParam String Administration fee parameter
CustomerData.stand_meter String Stand meter
CustomerData.bl_th String Bill periode
CustomerData.daya String Electric power
CustomerData.time String Transaction’s time
CustomerData.accountNum String Agent’s account number
data.customerName String Customer’s name
Response (error) See Response Code

Notes

1. Format for “bl_th”
   FindbillStatus value from inquiry response. This value shows the number of monthly bills. For monthly bills value, fill it with billPeriode from inquiry response.
   Example:
   > If billStatus=2, find the value from fieldbillPeriode1andbillPeriode2
   billPeriode1 = 201705, billPeriode2 = 201706
   “bl_th” : ”MEI17, JUN17”
   The name of months consists of 3 characters, these are: 'JAN', 'PEB', 'MAR', 'APR', 'MEI', 'JUN', 'JUL', 'AGU', 'SEP', 'OKT', 'NOV', 'DES'
2. Format for “daya”
   ‘daya’ : ‘customGroup1’+’customGroup2’+’/’+’categoryUsed’+’VA’
   Example:
   > customGroup1 = “R1”, customGroup2 = “” , categoryUsed = “1300”
   “daya” : “R1/1300VA”
   Note: If categoryUsed has no value, then replace it with “-” character.
3. Format for “stand_meter”
   Take billStatus value as a suffix for SAHLWBP.
   ‘stand_meter’ = 'SLALWBP1'+'-'+'SAHLWBP'
   Example:
   > billStatus=1, SLALWBP1 = "00000100", SAHLWBP1: "00000100"
   Note: ChooseSAHLWBP with suffix“1” (SAHLWBP1).
   “stand_meter” : 00000100-00000100

Request

{ 
   "typereq":"trans",
   "dealerId":"2214860948771287",
   "fiturId":"FTR494",
   "data":{ 
      "kode_mitra":"ARD",
      "kode_loket":"100019",
      "kode_cabang":"259",
      "systemId":"POSTPAID",
      "channelId":"NEWIBANK",
      "feeId":"00545300",
      "clientId":"NEWIBANK",
      "reffNum":"201705171541080100035",
      "amount":"125000",
      "adminFeeParam":"3000",
      "response":"<customerId>5311111</customerId><decimalAmount>0</decimalAmount><currency>360</currency><customerName>PEL POSTPAID 174193</customerName><flag>02</flag><billStatus>1</billStatus><regionCode>5300</regionCode><billAmount>1200000</billAmount><billStatOut>1</billStatOut><serviceUnit>53555</serviceUnit><customGroup1>R1</customGroup1><customGroup2/><categoryUsed>1300</categoryUsed><adminFee>3000</adminFee><PLNRefNum>XVW1V0XYWZY4Z456789AX3VWW23W1WY3</PLNRefNum><serviceUnitPhone>0212337890</serviceUnitPhone><billPeriode1>201605</billPeriode1><dueDate1>25052016</dueDate1><meterDate1>4052016</meterDate1><billAmount1>1200000</billAmount1><indicator1>C</indicator1><billIndicator1>0</billIndicator1><billTax1>0</billTax1><billPinalty1>0</billPinalty1><SLALWBP1>00000100</SLALWBP1><SAHLWBP1>00000100</SAHLWBP1><SLAWBP1>00000200</SLAWBP1><SAHWBP1>00000200</SAHWBP1><SLAKVARH1>00000300</SLAKVARH1><SAHKVARH1>00000300</SAHKVARH1><billPeriode2>0</billPeriode2><dueDate2>0</dueDate2><meterDate2>0</meterDate2><billAmount2>0</billAmount2><indicator2/><billIndicator2>0</billIndicator2><billTax2>0</billTax2><billPinalty2>0</billPinalty2><SLALWBP2/><SAHLWBP2/><SLAWBP2/><SAHWBP2/><SLAKVARH2/><SAHKVARH2/><billPeriode3>0</billPeriode3><dueDate3>0</dueDate3><meterDate3>0</meterDate3><billAmount3>0</billAmount3><indicator3/><billIndicator3>0</billIndicator3><billTax3>0</billTax3><billPinalty3>0</billPinalty3><SLALWBP3/><SAHLWBP3/><SLAWBP3/><SAHWBP3/><SLAKVARH3/><SAHKVARH3/><billPeriode4>0</billPeriode4><dueDate4>0</dueDate4><meterDate4>0</meterDate4><billAmount4>0</billAmount4><indicator4/><billIndicator4>0</billIndicator4><billTax4>0</billTax4><billPinalty4>0</billPinalty4><SLALWBP4/><SAHLWBP4/><SLAWBP4/><SAHWBP4/><SLAKVARH4/><SAHKVARH4/><billPeriode5>0</billPeriode5><dueDate5>0</dueDate5><meterDate5>0</meterDate5><billAmount5>0</billAmount5><indicator5/><billIndicator5>0</billIndicator5><billTax5>0</billTax5><billPinalty5>0</billPinalty5><SLALWBP5/><SAHLWBP5/><SLAWBP5/><SAHWBP5/><SLAKVARH5/><SAHKVARH5/><billReffNum/><cardExpiry>6010040517153934</cardExpiry><adminFeeParam>3000</adminFeeParam><switcherRefName>02</switcherRefName>",
      "customerId":"5311111",
      "bl_th":"MEI16",
      "daya":"R1/1300VA",
      "stand_meter":"00000100?00000100",
      "accountNum":"115258134",
      "pin_transaksi":"12345"
   }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{ 
   "trxType":"90",
   "status":"success",
   "data":{ 
      "error":false,
      "ket":"PLN",
      "clientId":"NEWIBANK",
      "reffNum":"201705171541080100035",
      "amount":"125000",
      "journal":"951290451 ",
      "financialJournal":"311791",
      "customerId":"5311111",
      "customerName":"PEL POSTPAID 174193",
      "billStatus":"1",
      "billStatOut":"1",
      "PLNRefNum":"XVW1V0XYWZY4Z456789AX3VWW23W1WY3",
      "adminFee":"3000",
      "switcherRefNum":"000911V00094459200456GN723503056",
      "switcherRefName":"02",
      "PLNNote":"Informasi Hubungi Call Center 789 etau Hub. PLN Terdekat:999",
      "unpaidBillNote":"Terima kasih",
      "adminFeeParam":"3000"
   },
   "result":{ 
      "kode_loket":"ARD259100019",
      "kd_lkt":"100019",
      "nama":"LALA",
      "kode_cabang":"259",
      "kode_mitra":"ARD",
      "alamat":"002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
   },
   "CustomerData":{ 
      "biaya_adm":null,
      "nominal":"125000",
      "stand_meter":"00000100?00000100",
      "bl_th":"MEI16",
      "daya":"R1/1300VA",
      "time":"2017?05?17T15:52:52+07:00",
      "accountNum":"115258134"
   }
}

Response (error)

{ 
   "trxType":"90",
   "status":"success",
   "data":{ 
      "error":true,
      "errorNum":"PLNJABAR30",
      "message":"TRANSAKSI GAGAL"
   },
   "result":{ 
      "kode_loket":"ALC999100059",
      "kd_lkt":"100059",
      "nama":"Dian Noviani",
      "kode_cabang":"999",
      "kode_mitra":"ALC",
      "alamat":"04/01 Balongdowo Candi Kab|Sidoarjo Jawa Timur 61271"
   },
   "CustomerData":{ 
      "biaya_adm":null,
      "nominal":"0",
      "stand_meter":"00000100-00000100",
      "bl_th":"MEI16",
      "daya":"R1/1300VA",
      "time":"2017-11-30T10:19:21+07:00",
      "accountNum":"4447"
   }
}
 
30. PLN Nontaglis - Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
dealerId String Yes MITRA dealer Id. Shared by BNI after MITRA registration done.
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.accountNum String Yes BNI Agent account number
typereq String Yes Request type. Default “trans”
data.systemId String Yes Default “POSTPAID”
data.channelId String Yes Default “NEWIBANK”
data.clientId String Yes Default “NEWIBANK”
data.amount String Yes Bill’s amount
data.response String Yes SOAP response. Same value as Inquiry response.
data.feeId String Yes Default “01070000”
data.registrationNum String Yes Customer’s registration number
data.tgl_reg String Yes Registration date (*format below)
data.transactionName String Yes Transaction’s name
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
data.financialJournal String Transaction financial journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
data.reffNum String Transaction reference number.Same value as Payment request
status String Transaction’s status
data.error String Transaction status : false : success true : failed
CustomerData.nominal String Bill’s nominal
data.clientId String Default “NEWIBANK”
CustomerData.time String Transaction’s time
CustomerData.accountNum String Agent’s account number
data.customerName String Customer’s name
trxType String Transaction’s type, “91” is for PLN Nontaglis payment
data.amount String Bill’s amount
data.registrationNum String Customer’s registration number
data.customerNumber String Customer’s number
data.PLNreffNum String PLN refference number
data.switcherReffNum String Switcher refference number
data.switcherCode String Switcher code
data.fee String Administration fee
data.receiptNote1 String Receipt note 1
data.receiptNote2 String Receipt note 2
data.receiptNote3 String Receipt note 3
data.receiptNote String Receipt note
data.errorNum String Error number
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
CustomerData.biaya_adm String Administration fee
CustomerData.transactionName String Transaction’s name
CustomerData.tgl_reg String Registration date
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2214860948771287",
    "fiturId": "FTR496",
    "data": {
        "kode_mitra": "ARD",
        "kode_loket": "100019",
        "kode_cabang": "259",
        "systemId": "POSTPAID",
        "channelId": "NEWIBANK",
        "feeId": "01070000",
        "clientId": "NEWIBANK",
        "reffNum": "201705171511310100040",
        "response": "<amount>500000</amount><registrationNum>531112</registrationNum><areaCode/><transactionCode/><bankAdmin> 00003000</bankAdmin><languageCode>0</languageCode><transactionName>PERUBAHAN DAYA1234567890A</transactionName><registrationDate>20111208</registrationDate><expiryDate>31122011</expiryDate><customerNumber>537123456789</customerNumber><customerName>JACKY CHAN123456789012345</customerName><PLNreffNum>REFRENCE CODE4567890123456789012</PLNreffNum><switcherReffNum>NOMOR RECEIPT4567890123456789012</switcherReffNum><serviceUnit>12345</serviceUnit><serviceUnitAddress>JALAN MULYA PURI BLOK BEKASI TIMUR</serviceUnitAddress><servicePhone>081287589625412</servicePhone><transactionAmountMinor>2</transactionAmountMinor><transactionAmount>502000</transactionAmount><billMinorUnit>2</billMinorUnit><billValue>500000</billValue><adminChargeMinor>0</adminChargeMinor><adminCharge>0</adminCharge><mutationNum>MUTASI NOMOR45678901234567890120</mutationNum><segmentation>SEGM</segmentation><usedCategory>123456789</usedCategory><switcherCode>02</switcherCode><receiptNote1/><receiptNote2/><receiptNote3/><fee>3000</fee>",
        "amount": "50000",
        "registrationNum": "531112",
        "transactionName": "PERUBAHAN DAYA1234567890A",
        "tgl_reg": "08DES11",
        "pin_transaksi": "12345",
        "accountNum": 115258134
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "91",
    "status": "success",
    "data": {
        "error": false,
        "ket": "PLN Non Taglis",
        "clientId": "NEWIBANK",
        "reffNum": "201705171511310100040",
        "journal": "917170442 ",
        "financialJournal": "311274",
        "amount": "500000",
        "registrationNum": "531112",
        "customerNumber": "537123456789",
        "customerName": "JACKY CHAN123456789012345",
        "PLNreffNum": "REFRENCE CODE4567890123456789012",
        "switcherReffNum": "NOMOR RECEIPT4567890123456789012",
        "accountNum": "115258134",
        "switcherCode": "02",
        "fee": "3000",
        "receiptNote1": "SILAHKAN HUBUNGI CALL CENTER 111",
        "receiptNote2": "ATAU",
        "receiptNote3": "HUB. PLN TERDEKAT :115",
        "receiptNote": "SILAHKAN HUBUNGI CALL CENTER 111ATAUHUB. PLN TERDEKAT :115",
        "errorNum": ""
    },
    "result": {
        "kode_loket": "ARD259100019",
        "kd_lkt": "100019",
        "nama": "LALA",
        "kode_cabang": "259",
        "kode_mitra": "ARD",
        "alamat": "002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
    },
    "CustomerData": {
        "biaya_adm": null,
        "nominal": "50000",
        "time": "2017-05-17T15:18:40+07:00",
        "transactionName": "PERUBAHAN DAYA1234567890A",
        "tgl_reg": "08DES11"
    }
}

Response (error)

{
    "trxType": "91",
    "status": "success",
    "data": {
        "error": true,
        "errorNum": "30",
        "message": "NOMINAL TIDAK BOLEH 0.",
        "ori_errorNum": "30",
        "ori_message": "Message format error"
    },
    "result": {
        "kode_loket": "ALC999100059",
        "kd_lkt": "100059",
        "nama": "Dian Noviani",
        "kode_cabang": "999",
        "kode_mitra": "ALC",
        "alamat": "04/01 Balongdowo Candi Kab|Sidoarjo Jawa Timur 61271"
    },
    "CustomerData": {
        "biaya_adm": null,
        "nominal": "0",
        "time": "2017-11-30T13:10:51+07:00",
        "transactionName": "PERUBAHAN DAYA1234567890A",
        "tgl_reg": "08DES11"
    }
}
 
31. Insurance – Prudential - Initial Premium
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.amount String Yes Customer bill amount
data.billingId String Yes Customer billing id
data.accountNum String Yes Agent’s account number
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
trxType String Transaction’s type, “61” is for Prudential
data.financialJurnal String Transaction’s financial journal
data.billingId String Customer billing id. Same value as request
data.accountNum String Agent’s account number. Same value as request
CustomerData.biaya_adm String Admin fee
CustomerData.nominal String Customer’s bill amount
data.amount String Customer bill amount. Same value as request
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR415",
    "data": {
        "kode_mitra": "IPY",
        "kode_loket": "00005",
        "kode_cabang": "014",
        "pin_transaksi": "12345",
        "clientId": "IBOC",
        "reffNum": "20171123111111121135",
        "amount": "150000",
        "billingId": "12100100",
        "accountNum": "115233516"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=
154/475
XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "61",
    "status": "success",
    "data": {
        "error": false,
        "ket": "PRUDENTIAL_PREMI_PERTAMA",
        "journal": "913453792 ",
        "financialJournal": "575628",
        "amount": "150000",
        "billingId": "12100100",
        "accountNum": "115233516",
        "reffNum": "20171123111111121135",
        "errorNum": ""
    },
    "result": {
        "kode_loket": "IPY01400005",
        "kd_lkt": "00005",
        "nama": "Agung",
        "kode_cabang": "014",
        "kode_mitra": "IPY",
        "alamat": "06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
    },
    "CustomerData": {
        "biaya_adm": 0,
        "nominal": "150000",
        "time": "2017-11-23T14:14:52+07:00"
    }
}

Response (error)

{
    "trxType": "61",
    "status": "success",
    "data": {
        "error": true,
        "message": "TRANSAKSI GAGAL : Pin transaksi salah",
        "errorNum": "-2"
    },
    "result": {
        "kode_loket": "IPY01400005",
        "kd_lkt": "00005",
        "nama": "Agung",
        "kode_cabang": "014",
        "kode_mitra": "IPY",
        "alamat": "06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
    },
    "CustomerData": {
        "biaya_adm": 0,
        "nominal": "150000",
        "time": "2017-11-23T14:14:52+07:00"
    }
}
 
32. Insurance – Prudential – Continuation Premium - Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.billingId String Yes Customer billing id
data.providerId String Yes Default “PRUDENTIAL”
data.paramsId String Yes Default “2”
Response Definition
Name Type Description
ket String Transaction description
data.error String Transaction status : false : success true : failed
amount String Payment amount/bill amount
productIndicator String Product indicator
flag String Flag
billingId String Customer billing id. Same value as Inquiry request
customeName String Customer’s name
maxAmount String Maximal amount
billStatOut String Polis status Note : 01 = active, else = not active
customerGroup String Customer group
adm String Frequency
reffNum1 String Transaction refference number
amount1 String Payment amount/bill amount
billIndicator1 String Bill indicator
minAmount String Minimal amount
standMeter String Premium period
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR416",
    "data": {
        "kode_mitra": "BNI",
        "kode_loket": "50309",
        "kode_cabang": "225",
        "clientId": "IBOC",
        "reffNum": "20171123152413051309",
        "providerId": "PRUDENTIAL",
        "billingId": "12100100",
        "paramsId": "2"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "ket": "Prudential - Premi Lanjutan - Inquiry",
    "amount": "145000",
    "billingId": "12100100",
    "customeName": "The Lich King",
    "flag": "02",
    "productIndicator": "7251",
    "maxAmount": "",
    "billStatOut": "01",
    "customeGroup": "IDR",
    "adm": "BULANAN",
    "reffNum1": "NOREFF12345678901234",
    "amount1": "000000145000",
    "billIndicator1": "123456654321",
    "minAmount": "000000050000",
    "standMeter": "10/06/12 s/d 10/07/12"
}

Response (error)

{
    "error": true,
    "errorNum": "0108",
    "message": "NO SUCH ACCOUNT"
}
 
33. PLN Nontaglis – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.systemId String Yes Default “POSTPAID”
data.channelId String Yes Default “NEWIBANK”
data.clientId String Yes Default “NEWIBANK”
data.feeId String Yes Default “01070000”
data.registrationNum String Yes Customer’s registration number
dealerId String Yes Dealer id for each BNI’s Mitra
data.providerId String Yes Default “PLN_NONTAGLIS”
Response Definition
Name Type Description
customerName String Customer Name
ket String Transaction description
transactionName String Transaction’s name
data.error String Transaction status : false : success true : failed
serviceUnit String Service unit
PLNReffNum String PLN refference number
response String SOAP response
amount String Bill’s amount
registrationNum String Customer’s registration number
areaCode String Area code
transactionCode String Transaction code
registrationDate String Registration date
expiryDate String Expiry date
customerNumber String Customer’s number
switcherReffNum String Switcher refference number
serviceUnitAddress String Service unit address
servicePhone String Service phone
transactionAmountMinor String Transaction amount minor
transactionAmount String Transaction amount
billMinorUnit String Bill minor unit
billValue String Bill value
adminChargeMinor String Admin charge minor
adminCharge String Admin charge
mutationNum String Mutation number
segmentation String Segmentation
usedCategory String Used category
switcherCode String Switcher code
receiptNote1 String Receipt note 1
receiptNote2 String Receipt note 2
receiptNote3 String Receipt note 3
fee String Administration fee
bankAdmin String Bank’s administration fee
languageCode String Language code
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2214860948771287",
    "fiturId": "FTR495",
    "data": {
        "kode_mitra": "ARD",
        "kode_loket": "100019",
        "kode_cabang": "259",
        "systemId": "POSTPAID",
        "channelId": "NEWIBANK",
        "feeId": "01070000",
        "clientId": "NEWIBANK",
        "reffNum": "201705171511240100030",
        "providerId": "PLN_NONTAGLIS",
        "registrationNum": "531113",
        "pin_transaksi": "12345"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "ket": "PLN Non Taglis",
    "amount": "500000",
    "registrationNum": "531113",
    "areaCode": "",
    "transactionCode": "",
    "bankAdmin": " 00003000",
    "languageCode": "0",
    "transactionName": "PERUBAHAN DAYA1234567890A",
    "registrationDate": "20111208",
    "expiryDate": "31122011",
    "customerNumber": "537123456789",
    "customerName": "JACKY CHAN123456789012345",
    "PLNreffNum": "REFRENCE CODE4567890123456789012",
    "switcherReffNum": "NOMOR RECEIPT4567890123456789012",
    "serviceUnit": "12345",
    "serviceUnitAddress": "JALAN MULYA PURI BLOK BEKASI TIMUR",
    "servicePhone": "081287589625412",
    "transactionAmountMinor": "2",
    "transactionAmount": "502000",
    "billMinorUnit": "2",
    "billValue": "500000",
    "adminChargeMinor": "0",
    "adminCharge": "0",
    "mutationNum": "MUTASI NOMOR45678901234567890120",
    "segmentation": "SEGM",
    "usedCategory": "123456789",
    "switcherCode": "02",
    "receiptNote1": "",
    "receiptNote2": "",
    "receiptNote3": "",
    "fee": "3000",
    "response": "<amount>500000</amount><registrationNum>531113</registrationNum><areaCode/><transactionCode/><bankAdmin>00003000</bankAdmin><languageCode>0</languageCode><transactionName>PERUBAHANDAYA1234567890A</transactionName><registrationDate>20111208</registrationDate><expiryDate>31122011</expiryDate><customerNumber>537123456789</customerNumber><customerName>JACKY CHAN123456789012345</customerName><PLNreffNum>REFRENCECODE4567890123456789012</PLNreffNum><switcherReffNum>NOMORRECEIPT4567890123456789012</switcherReffNum><serviceUnit>12345</serviceUnit><serviceUnitAddress>JALAN MULYA PURI BLOK BEKASI TIMUR</serviceUnitAddress><servicePhone>081287589625412</servicePhone><transactionAmountMinor>2</transactionAmountMinor><transactionAmount>502000</transactionAmount><billMinorUnit>2</billMinorUnit><billValue>500000</billValue><adminChargeMinor>0</adminChargeMinor><adminCharge>0</adminCharge><mutationNum>MUTASINOMOR45678901234567890120</mutationNum><segmentation>SEGM</segmentation><usedCategory>123456789</usedCategory><switcherCode>02</switcherCode><receiptNote1/><receiptNote2/><receiptNote3/><fee>3000</fee>"
}

Response (error)

{
    "error": true,
    "errorNum": "86",
    "message": "Error undefined"
}
 
34. Insurance – Prudential – Continuation Premium – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.amount String Yes Payment amount/bill amount. Same value as Inquiry response
data.productIndicator String Yes Product indicator. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.providerId String Yes Default “PRUDENTIAL”
data.paramsId String Yes Default “2”
data.customName String Yes Customer’s name. Same value as Inquiry response field customeName
data.flag String Yes Flag. Same value as Inquiry response
data.billStatCode String Yes Default “1”
data.maxAmount String Yes Maximal amount. Same value as Inquiry response
data.billStatOut String Yes Polis status. Same value as Inquiry response
data.customGroup String Yes Customer group. Same value as Inquiry response field customeGroup
data.adm String Yes Frequency. Same value as Inquiry response
data.reffNum1 String Yes Transaction refference number. Same value as Inquiry response
data.amount1 String Yes Payment amount/bill amount. Same value as Inquiry response
data.billIndicator1 String Yes Bill indicator. Same value as Inquiry response
data.minAmount String Yes Minimal amount. Same value as Inquiry response
data.standMeter1 String Yes Premium period. Same value as Inquiry response field standMeter
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.accountNum String Agent’s account number. Same value as Payment request
data.amount String Payment amount/bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
trxType String Transaction’s type, “61” is for Prudential
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
data.billingId String Customer billing id. Same value as Payment request
data.reffNum String Transaction reference number
CustomerData.customName String Customer’s name. Same value as Payment request
CustomerData.paramsId String Default “2” . Same value as Payment request
CustomerData.nominal String Payment amount/bill amount
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114701225459638",
    "fiturId": "FTR417",
    "data": {
        "kode_mitra": "BNI",
        "kode_loket": "50309",
        "kode_cabang": "225",
        "clientId": "IBOC",
        "reffNum": "20171123152433051309",
        "providerId": "PRUDENTIAL",
        "paramsId": "2",
        "amount": "10000",
        "billingId": "12100100",
        "customName": "The Lich King",
        "flag": "02",
        "billStatCode": "1",
        "productIndicator": "7251",
        "maxAmount": "",
        "billStatOut": "01",
        "customGroup": "IDR",
        "adm": "BULANAN",
        "reffNum1": "NOREFF12345678901234",
        "amount1": "000000145000",
        "billIndikator1": "123456654321",
        "minAmount": "000000050000",
        "standMeter1": "10/06/12 s/d 10/07/12",
        "accountNum": 115208477,
        "pin_transaksi": "12345"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "61",
    "status": "success",
    "data": {
        "error": false,
        "ket": "PRUDENTIAL",
        "journal": "927583852 ",
        "financialJournal": "575851",
        "amount": "10000",
        "billingId": "12100100",
        "accountNum": "115208477",
        "reffNum": "NOREFF12345678901234TNDBKT12345678907251",
        "errorNum": ""
    },
    "result": {
        "kode_loket": "BNI22550309",
        "kd_lkt": "50309",
        "nama": "BNI BANSOS",
        "kode_cabang": "225",
        "kode_mitra": "BNI",
        "alamat": "3/4 Jatikalang Sawahan Kab Sidoarjo JAWA TIMUR 60252"
    },
    "CustomerData": {
        "customName": "The Lich King",
        "biaya_adm": null,
        "paramsId": "2",
        "nominal": "10000",
        "time": "2017-11-23T15:29:07+07:00"
    }
}

Response (error)

{
    "data": {
        "error": true,
        "message": "TRANSAKSI GAGAL : Pin transaksi salah",
        "errorNum": "-2"
    },
    "result": {
        "kode_loket": "BNI22550309",
        "kd_lkt": "50309",
        "nama": "BNI BANSOS",
        "kode_cabang": "225",
        "kode_mitra": "BNI",
        "alamat": "3/4 Jatikalang Sawahan Kab Sidoarjo JAWA TIMUR 60252"
    },
    "CustomerData": {
        "customName": "The Lich King",
        "biaya_adm": null,
        "paramsId": "2",
        "nominal": "10000",
        "time": "2017-11-23T15:29:07+07:00"
    }
}
 
35. Insurance – Prudential–Premium TopUp – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.providerId String Yes Default “PRUDENTIAL”
data.paramsId String Yes Default “3”
data.billingId String Yes Billing id of Prudential next premi
Response Definition
Name Type Description
error String Transaction status. If transaction is success, value will be “false” else “true"
amount String Payment amount/bill amount
productIndicator String Product indicator
flag String Flag
customeName String Customer’s name
maxAmount String Maximal amount
billStatOut String Polis status Note : 01 = active, else = not active
customerGroup String Customer group
adm String Frequency
reffNum1 String Transaction refference number
amount1 String Payment amount/bill amount
billIndicator1 String Bill indicator
minAmount String Minimal amount
standMeter String Premium period
BillingId String Customer billing id
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR418",
    "data": {
        "kode_mitra": "BNI",
        "kode_loket": "50309",
        "kode_cabang": "225",
        "clientId": "IBOC",
        "reffNum": "20171123163317050309",
        "providerId": "PRUDENTIAL",
        "billingId": "12100100",
        "paramsId": "3"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "amount": "0",
    "billingId": "12100100",
    "customeName": "7252-Bane Elemental",
    "flag": "02",
    "productIndicator": "7252",
    "billStatOut": "01",
    "customeGroup": "",
    "adm": "",
    "maxAmount": "000000150000",
    "reffNum1": "NOREFF12345678901234",
    "amount1": "",
    "billIndicator1": "",
    "minAmount": "000000045000",
    "standMeter": ""
}

Response (error)

{
    "error": true,
    "errorNum": "0108",
    "message": "NO SUCH ACCOUNT"
}
 
36. Insurance – Prudential – Premium TopUp – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.productIndicator String Yes Product indicator. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.providerId String Yes Default “PRUDENTIAL”
data.customName String Yes Customer’s name. Same value as Inquiry response field customeName
data.flag String Yes Flag. Same value as Inquiry response
data.billStatCode String Yes Default “1”
data.maxAmount String Yes Maximal amount. Same value as Inquiry response
data.billStatOut String Yes Polis status. Same value as Inquiry response
data.customGroup String Yes Customer group. Same value as Inquiry response field customeGroup
data.adm String Yes Frequency. Same value as Inquiry response
data.reffNum1 String Yes Transaction refference number. Same value as Inquiry response
data.billIndicator1 String Yes Bill indicator. Same value as Inquiry response
data.minAmount String Yes Minimal amount. Same value as Inquiry response
data.standMeter1 String Yes Premium period. Same value as Inquiry response field standMeter
data.paramsId String Yes Default “3”
data.amount String Yes Customer’s bill amount, input on screen by Customer
data.amount1 String Yes Payment amount/bill amount 1. Same value as Inquiry response
Response Definition
Name Type Description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.accountNum String Agent’s account number. Same value as Payment request
data.amount String Payment amount/bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
trxType String Transaction’s type, “61” is for Prudential
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
data.billingId String Customer billing id. Same value as Payment request
data.reffNum String Transaction reference number
CustomerData.customName String Customer’s name. Same value as Payment request
CustomerData.nominal String Payment amount/bill amount
data.ket String Default “PRUDENTIAL”
CustomerData.paramsId String Default “3” . Same value as Payment request
Response (error) See Response Code

Request Example

{  "typereq": "trans",  "dealerId": "2114701225459638",  "fiturId": "FTR419",  "data": {   "kode_mitra": "BNI",   "kode_loket": "50309",   "kode_cabang": "225",   "pin_transaksi": "12345",   "clientId": "IBOC",   "reffNum": "20171123202427166245",   "providerId": "PRUDENTIAL",   "paramsId": "3",   "amount": "45000",   "billingId": "12100100",   "customName": "7252-Bane Elemental",   "flag": "2",   "billStatCode": "1",   "billStatOut": "01",   "reffNum1": "NOREFF12345678901234",   "productIndicator": "7252",   "accountNum": "115208477",   "adm": "",   "billIndikator1": "",   "amount1": "",   "minAmount": "000000045000",   "maxAmount": "000000150000",   "standMeter1": "",   "customGroup": ""  } }

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response Success Example

{  "trxType": "61",  "status": "success",  "data": {   "error": false,   "ket": "PRUDENTIAL",   "paramsId": "3",   "journal": "923150209   ",   "financialJournal": "768170",   "amount": "20000",   "billingId": "12100100",   "accountNum": "315629103",   "reffNum": "NOREFF12345678901234TNDBKT12345678907252",   "errorNum": ""  },  "result": {   "kode_loket": "BSK25950279",   "kd_lkt": 50279,   "nama": "Kis'Bu xxx",   "kode_cabang": "259", 
171/475 
  "kode_mitra": "BSK",   "alamat": "RT 2 Jatikalang Krian sidoarjo Jawa Timur 60252"  },  "CustomerData": {   "customName": "7252-Bane Elemental",   "biaya_adm": null,   "paramsId": "3",   "nominal": "20000",   "time": "2016-08-08T20:25:40+07:00"  } }

Response Error Example

{  "data": {   "error": true,   "message": "TRANSAKSI GAGAL : Pin transaksi salah",   "errorNum": "-2"  },  "result": {   "kode_loket": "BSK25950279",   "kd_lkt": 50279,   "nama": "Kis'Bu xxx",   "kode_cabang": "259",   "kode_mitra": "BSK",   "alamat": "RT 2 Jatikalang Krian sidoarjo Jawa Timur 60252"  },  "CustomerData": {   "customName": "7252-Bane Elemental",   "biaya_adm": null,   "paramsId": "3",   "nominal": "20000",   "time": "2016-08-08T20:25:40+07:00"  } }
 
37. Insurance – Prudential – Policy Re-print – Inquiry
Hostname https://apidevbni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
debitAccountNo String Yes Nomor rekening 3rd Party yang telah terdaftar di BNI
creditAccountNo String Yes Nomor rekening tujuan (BNI / Non BNI)
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.billingId String Yes Customer billing id
data.providerId String Yes Default “PRUDENTIAL”
data.paramsId String Yes Default “4”
Response Definition
Name Type Description
data.error String Transaction status : false : success true : failed
amount String Payment amount/bill amount
productIndicator String Product indicator
flag String Flag
customeName String Customer’s name
maxAmount String Maximal amount
billStatOut String Polis status Note : 01 = active, else = not active
adm String Frequency
amount1 String Payment amount/bill amount
billIndicator1 String Bill indicator
minAmount String Minimal amount
standMeter String Premium period
BillingId String Customer billing id
customeGroup String Customer group
reffNum1 String Polis Reference number
Response (error) See Response Code

Request Example

{  "typereq": "trans",  "dealerId": "2114534465611173",  "fiturId": "FTR420",  "data": {   "kode_mitra": "BNI",   "kode_loket": "50309",   "kode_cabang": "225",   "clientId": "IBOC",   "reffNum": "20151130111111111177",   "providerId": "PRUDENTIAL",   "paramsId": "4",   "billingId": "14"  } }

Exp full url

 https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QU

Response Success Example

{  "error": false,  "amount": "0",  "billingId": "12100100",  "customeName": "7253-Jahrakal",  "flag": "02",  "productIndicator": "7253",  "maxAmount": "",  "billStatOut": "01",  "customeGroup": "",  "adm": "",  "reffNum1": "NOREFF12345678901234",  "amount1": "",  "billIndicator1": "",  "minAmount": "000000045000",  "standMeter": "" }

Response Error Example

{  "error":true,  "errorNum":"0108",  "message":"NO SUCH ACCOUNT" }
 
38. Insurance – Prudential – Policy Re-print – Payment
Hostname https://apidevbni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.productIndicator String Yes Product indicator. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.providerId String Yes Default “PRUDENTIAL”
data.billingId String Yes Customer billing id. Same value as Inquiry response
data.customName String Yes Customer’s name. Same value as Inquiry response field customeName
data.flag String Yes Flag. Same value as Inquiry response
data.billStatCode String Yes Default “1”
data.maxAmount String Yes Maximal amount. Same value as Inquiry response
data.billStatOut String Yes Polis status. Same value as Inquiry response
data.customGroup String Yes Customer group. Same value as Inquiry response field customeGroup
data.adm String Yes Frequency. Same value as Inquiry response
data.reffNum1 String Yes Transaction refference number. Same value as Inquiry response
data.billIndicator1 String Yes Bill indicator. Same value as Inquiry response
data.minAmount String Yes Minimal amount. Same value as Inquiry response
data.standMeter1 String Yes Premium period. Same value as Inquiry response field standMeter
data.amount String Yes Customer’s bill amount, input on screen by Customer
data.amount1 String Yes Payment amount/bill amount 1. Same value as Inquiry response
data.paramsId String Yes Default “4”
Response Definition
Name Type Description
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.amount String Customer’s bill amount. Same value as Payment request
data.accountNum String Agent’s account number. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
trxType String Transaction’s type, “61” is for Prudential
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
data.reffNum String Transaction reference number
CustomerData.customName String Customer’s name. Same value as Payment request
CustomerData.nominal String Payment amount/bill amount
data.ket String Default “PRUDENTIAL”
data.billingId String Transaction’s journal
data.message String Transaction’s error message
CustomerData.paramsId String Default “4” . Same value as Payment request
Response (error) See Response Code

Request Example

{  "typereq": "trans",  "dealerId": "2114701225459638",  "fiturId": "FTR421",  "data": {   "kode_mitra": "BSK",   "kode_loket": "50279",   "kode_cabang": "259", 
177/475 
  "pin_transaksi": "12345",   "clientId": "IBOC",   "reffNum1": "NOREFF12345678901234",   "reffNum": "20160808204610066251",   "providerId": "PRUDENTIAL",   "paramsId": "4",   "amount": "20000",   "billingId": "12100100",   "customName": "7253-Jahrakal",   "flag": "02",   "billStatCode": "1",   "billStatOut": "01",   "productIndicator": "7253",   "maxAmount": "",   "accountNum": "315629103 ",   "adm": "",   "billIndikator1": "",   "amount1": "",   "minAmount": "000000045000",   "standMeter1": "",   "customGroup": ""  } }

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response Success Example

{  "trxType": "61",  "status": "success",  "data": {   "error": false,   "ket": "PRUDENTIAL",   "journal": "944580214   ",   "financialJournal": "768171",   "amount": "20000",   "billingId": "12100100",   "accountNum": "315629103",   "reffNum": "NOREFF12345678901234TNDBKT12345678907253",   "errorNum": ""  },  "result": {   "kode_loket": "BSK25950279",   "kd_lkt": 50279,   "nama": "Kis'Bu xxx",   "kode_cabang": "259",   "kode_mitra": "BSK",   "alamat": "RT 2 Jatikalang Krian sidoarjo Jawa Timur 60252"  },  "CustomerData": {   "customName": "7253-Jahrakal",   "biaya_adm": null,   "paramsId": "4",   "nominal": "20000",   "time": "2016-08-08T20:47:23+07:00"  } }

Response Error Example

{  "data": {   "error": true,   "message": "TRANSAKSI GAGAL : Pin transaksi salah",   "errorNum": "-2"  },  "result": { 
179/475 
  "kode_loket": "BSK25950279",   "kd_lkt": 50279,   "nama": "Kis'Bu xxx",   "kode_cabang": "259",   "kode_mitra": "BSK",   "alamat": "RT 2 Jatikalang Krian sidoarjo Jawa Timur 60252"  },  "CustomerData": {   "customName": "7252-Bane Elemental",   "biaya_adm": null,   "paramsId": "4",   "nominal": "20000",   "time": "2016-08-08T20:25:40+07:00"  } }
 
39. Insurance – Prudential – Policy Adjustment – Inquiry
Hostname https://apidevbni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.billingId String Yes Customer billing id
data.providerId String Yes Default “PRUDENTIAL”
data.paramsId String Yes Default “5”
Response Definition
Name Type Description
amount String Payment amount/bill amount
productIndicator String Product indicator
flag String Flag
customeName String Customer’s name
maxAmount String Maximal amount
billStatOut String Polis status Note : 01 = active, else = not active
adm String Frequency
reffNum1 String Transaction refference number
billIndicator1 String Bill indicator
minAmount String Minimal amount
standMeter String Premium period
customeGroup String Customer group
error String Transaction status : false : success true : failed
amount1 String Payment amount/bill amount 1
billingId String Customer billing id
Response (error) See Response Code

Request Example

{  "typereq": "trans",  "dealerId": "2114534465611173",  "fiturId": "FTR422",  "data": {   "kode_mitra": "BSK",   "kode_loket": "50279",   "kode_cabang": "259",   "clientId": "IBOC", 
181/475 
  "reffNum": "20151130111111111181",   "providerId": "PRUDENTIAL",   "paramsId": "5",   "billingId": "11"  } }

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response Success Example

{  "error": false,  "amount": "0",  "billingId": "12100100",  "customeName": "7254-Pandaren The Brewmaster",  "flag": "02",  "productIndicator": "7254",  "maxAmount": "",  "billStatOut": "01",  "customeGroup": "",  "adm": "",  "reffNum1": "NOREFF12345678901234",  "amount1": "",  "billIndicator1": "",  "minAmount": "000000045000",  "standMeter": "" }

Response Error Example

{  "error":true,  "errorNum":"0108",  "message":"NO SUCH ACCOUNT" }
 
40. Insurance – Prudential – Policy Adjustment – Payment
Hostname https://apidevbni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.productIndicator String Yes Product indicator. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.providerId String Yes Default “PRUDENTIAL”
data.billingId String Yes Customer billing id. Same value as Inquiry response
data.customName String Yes Customer’s name. Same value as Inquiry response field customeName
data.flag String Yes Flag. Same value as Inquiry response
data.billStatCode String Yes Default “1”
data.maxAmount String Yes Maximal amount. Same value as Inquiry response
data.billStatOut String Yes Polis status. Same value as Inquiry response
data.customGroup String Yes Customer group. Same value as Inquiry response field customeGroup
data.adm String Yes Frequency. Same value as Inquiry response
data.reffNum1 String Yes Transaction refference number. Same value as Inquiry response
data.billIndicator1 String Yes Bill indicator. Same value as Inquiry response
data.minAmount String Yes Minimal amount. Same value as Inquiry response
data.standMeter1 String Yes Premium period. Same value as Inquiry response field standMeter
data.amount String Yes Customer’s bill amount, input on screen by Customer
data.amount1 String Yes Payment amount/bill amount 1. Same value as Inquiry response
data.paramsId String Yes Default “5”
Response Definition
Name Type Description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.accountNum String Agent’s account number. Same value as Payment request
data.amount String Payment amount/bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
trxType String Transaction’s type, “61” is for Prudential
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
data.billingId String Customer billing id. Same value as Payment request
data.reffNum String Transaction reference number
CustomerData.customName String Customer’s name. Same value as Payment request
CustomerData.nominal String Payment amount/bill amount
data.ket String Default “PRUDENTIAL”
data.billingId String Transaction’s journal
CustomerData.paramsId String Default “5” . Same value as Payment request
Response (error) See Response Code

Request Example

{  "typereq": "trans",  "dealerId": "2114701225459638",  "fiturId": "FTR423",  "data": {   "kode_mitra": "BSK",   "kode_loket": "50279",   "kode_cabang": "259",   "pin_transaksi": "12345",   "clientId": "IBOC",   "reffNum": "20160808210426066254",   "reffNum1": "NOREFF12345678901234",   "providerId": "PRUDENTIAL",   "paramsId": "5",   "amount": "20000",   "billingId": "12100100",   "customName": "7254-Pandaren The Brewmaster",   "flag": "02",   "billStatCode": "1",   "billStatOut": "01",   "productIndicator": "7254",   "maxAmount": "",   "accountNum": "315629103 ",   "adm": "",   "billIndikator1": "",   "amount1": "000000000000",   "minAmount": "000000045000",   "standMeter1": "",   "customGroup": ""  } }

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response Success Example

{  "trxType": "61",  "status": "success",  "data": {   "error": false,   "ket": "PRUDENTIAL",   "journal": "903140217   ",   "financialJournal": "768174",   "amount": "20000",   "billingId": "12100100",   "accountNum": "315629103", 
186/475 
  "reffNum": "NOREFF12345678901234TNDBKT12345678907254",   "errorNum": ""  },  "result": {   "kode_loket": "BSK25950279",   "kd_lkt": 50279,   "nama": "Kis'Bu xxx",   "kode_cabang": "259",   "kode_mitra": "BSK",   "alamat": "RT 2 Jatikalang Krian sidoarjo Jawa Timur 60252"  },  "CustomerData": {   "customName": "7254-Pandaren The Brewmaster",   "biaya_adm": null,   "paramsId": "5",   "nominal": "20000",   "time": "2016-08-08T21:05:39+07:00"  } }

Response Error Example

{  "data": {   "error": true,   "message": "TRANSAKSI GAGAL : Pin transaksi salah",   "errorNum": "-2"  },  "result": {   "kode_loket": "BSK25950279",   "kd_lkt": 50279,   "nama": "Kis'Bu xxx",   "kode_cabang": "259",   "kode_mitra": "BSK",   "alamat": "RT 2 Jatikalang Krian sidoarjo Jawa Timur 60252"  },  "CustomerData": {   "customName": "7254-Pandaren The Brewmaster",   "biaya_adm": null,   "paramsId": "5",   "nominal": "20000",   "time": "2016-08-08T21:05:39+07:00"  } }
 
41. Insurance – Prudential – Card Printing – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.billingId String Yes Customer billing id
data.providerId String Yes Default “PRUDENTIAL”
data.paramsId String Yes Default “6”
Response Definition
Name Type Description
amount String Payment amount/bill amount
productIndicator String Product indicator
flag String Flag
customeName String Customer’s name
maxAmount String Maximal amount
billStatOut String Polis status Note : 01 = active, else = not active
adm String Frequency
reffNum1 String Transaction refference number
billIndicator1 String Bill indicator
minAmount String Minimal amount
standMeter String Premium period
customeGroup String Customer group
error String Transaction status : false : success true : failed
amount1 String Payment amount/bill amount 1
billingId String Customer billing id
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR424",
    "data": {
        "kode_mitra": "BSK",
        "kode_loket": "50279",
        "kode_cabang": "259",
        "clientId": "IBOC",
        "reffNum": "20151130111111111183",
        "providerId": "PRUDENTIAL",
        "paramsId": "6",
        "billingId": "11"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "amount": "0",
    "billingId": "12100100",
    "customeName": "7255-Lina Inverse",
    "flag": "02",
    "productIndicator": "7255",
    "maxAmount": "",
    "billStatOut": "01",
    "customeGroup": "",
    "adm": "",
    "reffNum1": "NOREFF12345678901234",
    "amount1": "",
    "billIndicator1": "",
    "minAmount": "000000045000",
    "standMeter": ""
}

Response (error)

{
    "error": true,
    "errorNum": "0108",
    "message": "NO SUCH ACCOUNT"
}
 
42. Insurance – Prudential – Card Printing – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.productIndicator String Yes Product indicator. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.providerId String Yes Default “PRUDENTIAL”
data.billingId String Yes Customer billing id. Same value as Inquiry response
data.customName String Yes Customer’s name. Same value as Inquiry response field customeName
data.flag String Yes Flag. Same value as Inquiry response
data.billStatCode String Yes Default “1”
data.maxAmount String Yes Maximal amount. Same value as Inquiry response
data.billStatOut String Yes Polis status. Same value as Inquiry response
data.customGroup String Yes Customer group. Same value as Inquiry response field customeGroup
data.adm String Yes Frequency. Same value as Inquiry response
data.reffNum1 String Yes Transaction refference number. Same value as Inquiry response
data.billIndicator1 String Yes Bill indicator. Same value as Inquiry response
data.minAmount String Yes Minimal amount. Same value as Inquiry response
data.standMeter1 String Yes Premium period. Same value as Inquiry response field standMeter
data.amount String Yes Customer’s bill amount, input on screen by Customer
data.amount1 String Yes Payment amount/bill amount 1. Same value as Inquiry response
data.paramsId String Yes Default “6”
Response Definition
Name Type Description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.accountNum String Agent’s account number. Same value as Payment request
data.amount String Payment amount/bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
trxType String Transaction’s type, “61” is for Prudential
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
data.billingId String Customer billing id. Same value as Payment request
data.reffNum String Transaction reference number
CustomerData.customName String Customer’s name. Same value as Payment request
CustomerData.nominal String Payment amount/bill amount
data.ket String Default “PRUDENTIAL”
data.paramsId String Default “6” . Same value as Payment request
CustomerData.paramsId String Default “6” . Same value as Payment request
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114701225459638",
    "fiturId": "FTR425",
    "data": {
        "kode_mitra": "BSK",
        "kode_loket": "50279",
        "kode_cabang": "259",
        "pin_transaksi": "12345",
        "clientId": "IBOC",
        "reffNum1": "NOREFF12345678901234",
        "reffNum": "20160808213608066270",
        "providerId": "PRUDENTIAL",
        "paramsId": "6",
        "amount": "20000",
        "billingId": "12100100",
        "customName": "7255-Lina Inverse",
        "flag": "2",
        "billStatOut": "01",
        "billStatCode": "1",
        "productIndicator": "7255",
        "maxAmount": "",
        "accountNum": "315629103 ",
        "adm": "",
        "billIndikator1": "",
        "amount1": "",
        "minAmount": "000000045000",
        "standMeter1": "",
        "customGroup": ""
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "61",
    "status": "success",
    "data": {
        "error": false,
        "ket": "PRUDENTIAL",
        "journal": "934550230 ",
        "financialJournal": "768183",
        "amount": "20000",
        "billingId": "12100100",
        "accountNum": "315629103",
        "reffNum": "NOREFF12345678901234TNDBKT12345678907255",
        "errorNum": ""
    },
    "result": {
        "kode_loket": "BSK25950279",
        "kd_lkt": 50279,
        "nama": "Kis'Bu xxx",
        "kode_cabang": "259",
        "kode_mitra": "BSK",
        "alamat": "RT 2 Jatikalang Krian sidoarjo Jawa Timur 60252"
    },
    "CustomerData": {
        "customName": "7255-Lina Inverse",
        "biaya_adm": null,
        "paramsId": "6",
        "nominal": "20000",
        "time": "2016-08-08T21:37:21+07:00"
    }
}

Response (error)

{
    "data": {
        "error": true,
        "message": "TRANSAKSI GAGAL : Pin transaksi salah",
        "errorNum": "-2"
    },
    "result": {
        "kode_loket": "BSK25950279",
        "kd_lkt": 50279,
        "nama": "Kis'Bu xxx",
        "kode_cabang": "259",
        "kode_mitra": "BSK",
        "alamat": "RT 2 Jatikalang Krian sidoarjo Jawa Timur 60252"
    },
    "CustomerData": {
        "customName": "7255-Lina Inverse",
        "biaya_adm": null,
        "paramsId": "6",
        "nominal": "20000",
        "time": "2016-08-08T21:37:21+07:00"
    }
}
 
43. Credit Card – BNI – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.cardNum String Yes Customer BNI credit card number
Response Definition
Name Type Description
ket String Transaction description
dueDate String Bill’s due date
minPayment String Minimum payment
cardNum String Customer BNI credit card number
statementDate String Bill statement date
cardHolder String Card holder
cardlinkFlag String Cardlink flag
lastBillAmountSign String Bill amount sign
lastBillAmount String Bill amount
minPayment1 String Minimum payment 1
minPayment2 String Minimum payment 2
status String Bill status
error String Transaction status : false : success true : failed
Response (error) See Response Code

Request Example

{  "typereq": "trans",  "dealerId": "2114534465611173",  "fiturId": "FTR430",  "data": {   "clientId": "IBOC",   "reffNum": "20151201091320000125",   "cardNum": "4665730000000117"  } }

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response Success Example

{  "error": false,  "ket": "Credit Card BNI Inquiry",  "cardNum": "4665730000000117",  "statementDate": "11102012",  "dueDate": "12102012",  "cardHolder": "GA SIGN 2",  "cardlinkFlag": "02",  "lastBillAmountSign": "+",  "lastBillAmount": "261553126",  "minPayment": "261553126",  "minPayment1": "00000261",  "minPayment2": "553126",  "status": "2" }

Response Error Example

{     "error": true,     "errorNum": "9990",     "message": "Duplicate Refference Number"
 
44. Credit Card – BNI – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.cardNum String Yes Customer BNI credit card number
data.amount String Yes Payment amount/bill amount, input on screen by Customer
Response Definition
Name Type Description
ket String Transaction description
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.accountNum String Agent’s account number. Same value as Payment request
data.amount String Payment amount/bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
CustomerData.nominal String Payment amount/bill amount
data.billingId String Transaction’s journal
trxType String Transaction’s type, “41” is for CC BNI Payment
data.cardNum String Customer BNI credit card number. Same value as Payment request
Response (error) See Response Code

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc
 
45. Credit Card – Non BNI – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.amount String Yes Payment amount/bill amount, input on screen by Customer
data.bankCode String Yes Bank code of customer credit card. Note : Possibility value are : > CITIBANK > BRI > BUKOPIN > MEGA > DANAMON > NIAGA > AMEX > HSBC > SCB > GE > ANZ > PANIN
data.cardNum String Yes Customer credit card number
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.amount String Payment amount/bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
CustomerData.nominal String Payment amount/bill amount
trxType String Transaction’s type, “42” is for CC Non BNI Payment
data.reffNum String Reference number. Same value as Payment request
CustomerData.cardNum String Customer credit card number. Same value as Payment request
CustomerData.bankCode String Bank code of customer credit card. Same value as Payment request
CustomerData.biaya_adm String Admin fee. Note : BRI = Rp 7.500, else Rp 0
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR432",
    "data": {
        "kode_mitra": "IPY",
        "kode_loket": "00005",
        "kode_cabang": "014",
        "pin_transaksi": "12345",
        "clientId": "IBOC",
        "reffNum": "20170811153652020990",
        "bankCode": "BRI",
        "cardNum": "4365020922600613",
        "amount": "250000",
        "accountNum": "113020167"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "42",
    "status": "success",
    "data": {
        "error": false,
        "ket": "BRI",
        "financialJournal": "455151",
        "journal": "915260645 ",
        "reffNum": "20170811153652020990"
    },
    "result": {
        "kode_loket": "IPY01400005",
        "kd_lkt": "00005",
        "nama": "Agung",
        "kode_cabang": "014",
        "kode_mitra": "IPY",
        "alamat": "06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
    },
    "CustomerData": {
        "cardNum": "4365020922600613",
        "bankCode": "BRI",
        "biaya_adm": "7500",
        "nominal": "250010",
        "time": "2017-08-11T09:17:07+07:00"
    }
}

Response (error)

{
    "trxType": "42",
    "status": "success",
    "data": {
        "error": true,
        "errorNum": "9990",
        "message": "Duplicate Refference Number"
    },
    "result": {
        "kode_loket": "IPY01400005",
        "kd_lkt": "00005",
        "nama": "Agung",
        "kode_cabang": "014",
        "kode_mitra": "IPY",
        "alamat": "06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
    },
    "CustomerData": {
        "cardNum": "4365020922600613",
        "bankCode": "BRI",
        "biaya_adm": "7500",
        "nominal": "250000",
        "time": "2018-01-22T19:06:22+07:00"
    }
}
 
46. Personal Loan
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.amount String Yes Payment amount/bill amount, input on screen by Customer
data.bankCode String Yes Bank code of customer personal loan. Note : Possibility value are : > ANZ_PL > CITIBANK_PL > SCB_PL > HSBC_PL
data.cardNum String Yes Customer personal loan number
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
data.reffNum String Reference number. Same value as Payment request
trxType String Transaction’s type, “43” is for Personal Loan Payment
CustomerData.cardNum String Customer personal loan number. Same value as Payment request
CustomerData.nominal String Payment amount/bill amount. Same value as Payment request
CustomerData.bankCode String Bank code of customer personal loan. Same value as Payment request
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR433",
    "data": {
        "kode_mitra": "IPY",
        "kode_loket": "00005",
        "kode_cabang": "014",
        "pin_transaksi": "12345",
        "clientId": "IBOC",
        "reffNum": "20171205153652000991",
        "bankCode": "ANZ_PL",
        "cardNum": "3611824048",
        "amount": "50000",
        "accountNum": "115208670"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "43",
    "status": "success",
    "data": {
        "error": false,
        "ket": "ANZ_PL",
        "financialJournal": "593206",
        "journal": "925150628 ",
        "reffNum": "20171205153652000991"
    },
    "result": {
        "kode_loket": "IPY01400005",
        "kd_lkt": "00005",
        "nama": "Agung",
        "kode_cabang": "014",
        "kode_mitra": "IPY",
        "alamat": "06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
    },
    "CustomerData": {
        "bankCode": "ANZ_PL",
        "biaya_adm": 0,
        "cardNum": "3611824048",
        "nominal": "50000",
        "time": "2017-12-05T16:26:51+07:00"
    }
}

Response (error)

{
    "trxType": "43",
    "status": "success",
    "data": {
        "error": true,
        "errorNum": "9990",
        "message": "Duplicate Refference Number"
    },
    "result": {
        "kode_loket": "IPY01400005",
        "kd_lkt": "00005",
        "nama": "Agung",
        "kode_cabang": "014",
        "kode_mitra": "IPY",
        "alamat": "06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
    },
    "CustomerData": {
        "bankCode": "ANZ_PL",
        "biaya_adm": 0,
        "cardNum": "3611824048",
        "nominal": "50000",
        "time": "2018-01-22T19:22:04+07:00"
    }
}
 
47. Charity
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.amount String Yes Payment amount/bill amount, input on screen by Customer
data.providerId String Yes Provider Id. Note : Possibility value are : > ZAKAT_DOMPET_DHUAFA > ZAKAT_BAZNAS > ZAKAT_PKPU > ZAKAT_DPU_DAARUT_TAUHID > ZAKAT_PPSDMS > ZAKAT_BAMUIS > ZAKAT_RUMAH_ZAKAT > INFAQ_DOMPET_DHUAFA > INFAQ_BAZNAS > INFAQ_PKPU > INFAQ_DPU_DAARUT_TAUHID > INFAQ_PPSDMS > INFAQ_BAMUIS > INFAQ_RUMAH_ZAKAT > QURBAN_DOMPET_DHUAFA > QURBAN_BAZNAS > QURBAN_PKPU > QURBAN_DPU_DAARUT_TAUHID > QURBAN_RUMAH_ZAKAT > WAKAF_DOMPET_DHUAFA
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.amount String Payment amount/bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
data.accountNum String Agent’s account number. Same value as request
CustomerData.nominal String Payment amount/bill amount
data.reffNum String Reference number. Same value as Payment request
CustomerData.biaya_adm String Admin fee. Note : BRI = Rp 7.500, else Rp 0
trxType String Transaction’s type, “30” is for Charity Payment
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR426",
    "data": {
        "kode_mitra": "IPY",
        "kode_loket": "00005",
        "kode_cabang": "014",
        "pin_transaksi": "12345",
        "clientId": "IBOC",
        "reffNum": "20151130111111111208",
        "providerId": "ZAKAT_DOMPET_DHUAFA",
        "amount": "1500000",
        "accountNum": "115245726"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "30",
    "status": "success",
    "data": {
        "error": false,
        "ket": "INFAQ_DOMPET_DHUAFA",
        "journal": "908180152 ",
        "financialJournal": "142015",
        "reffNum": "20151230070757050001",
        "amount": "5000",
        "accountNum": "0224089576"
    },
    "result": {
        "kode_loket": "BNI02250001",
        "kd_lkt": 50001,
        "nama": "Ryan Ditya Permadi",
        "kode_cabang": "022",
        "kode_mitra": "BNI",
        "alamat": "1/1 Jatikarya Jati Sampurna Kota Bekasi Jawa Barat 17435"
    },
    "CustomerData": {
        "biaya_adm": null,
        "nominal": "5000",
        "time": "2015-12-30T00:08:42.931Z"
    }
}

Response (error)

{
    "trxType": "30",
    "status": "success",
    "data": {
        "error": true,
        "errorNum": "9990",
        "message": "Duplicate Refference Number"
    },
    "result": {
        "kode_loket": "IPY01400005",
        "kd_lkt": "00005",
        "nama": "Agung",
        "kode_cabang": "014",
        "kode_mitra": "IPY",
        "alamat": "06/28 Ngadirgo Krian Sidoarjo Jawa Timur 50213"
    },
    "CustomerData": {
        "biaya_adm": 0,
        "nominal": "1500000",
        "time": "2018-01-22T19:20:58+07:00"
    }
}
 
48. Mobile Postpaid – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.providerId String Yes Note providerId : PROVIDER => FIELD VALUE Providerld : HALO => HALO, INDOSAT MATRIX => INDOSAT_POSTPAID, SMARTFREN => FREN_POSTPAID, TRI => THREE_POSTPAID, XL XPLOR/AXIS => XPLOR
data.phoneNum String Yes Customer’s Mobile Phone Number
Response Definition
Name Type Description
customerName String Customer Name
ket String Transaction description
NPWP String Customer's NPWP
amount String Customer’s bill amount
flag String Flag
error String Transaction status : false : success true : failed
clientId String Default “IBOC”. Same value as Inquiry request
reffNum String Reference Number. Same value as Inquiry request
phoneNum String Customer’s Mobile Phone Number. Same value as Inquiry request
customerNum String Customer’s number
billStatCode String Bill Status Code
kandatelNum String Kandatel Number
billingReff3 String Billing Reference 3
billingAmount3 String Billing Amount 3
billingReff2 String Billing Reference 2
billingAmount2 String Billing Amount 2
billingReff1 String Billing Reference 1
billingAmount1 String Billing Amount 1
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR411",
    "data": {
        "clientId": "IBOC",
        "providerId": "HALO",
        "reffNum": "20151201010101901037",
        "phoneNum": "0811252222"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "ket": "Halo Inquiry : 0811252222",
    "clientId": "IBOC",
    "reffNum": "20151201010101901037",
    "amount": "230000",
    "phoneNum": "0811252222",
    "customerNum": "",
    "NPWP": "",
    "customerName": "WARREN CUCURULLO_694",
    "flag": "00",
    "billStatCode": "0",
    "kandatelNum": "0100",
    "billingReff3": "00000062001",
    "billingAmount3": "587579",
    "billingReff2": " 02",
    "billingAmount2": "0",
    "billingReff1": "",
    "billingAmount1": "0"
}

Response (error)

{
    "error": true,
    "errorNum": "12",
    "message": "Invalid transaction"
}
 
49. Mobile Postpaid– Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
data.customerName String Yes Customer Name. Same value as Inquiry response
typereq String Yes Request type. Default “trans”
data.amount String Yes Customer’s bill amount. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.flag String Yes Flag. Same value as Inquiry response
data.providerId String Yes Note providerId : PROVIDER => FIELD VALUE Providerld : HALO => HALO, INDOSAT MATRIX => INDOSAT_POSTPAID, SMARTFREN => FREN_POSTPAID, TRI => THREE_POSTPAID, XL XPLOR/AXIS => XPLOR
data.phoneNum String Yes Customer’s Mobile Phone number. Same value as Inquiry response
customerNum String Yes Customer’s number. Same value as Inquiry response
NPWP String Yes Customer’s NPWP. Same value as Inquiry response
data.kandatelNum String Yes Kandatel Number. Same value as Inquiry response
data.billingReff3 String Yes Billing Reference 3. Same value as Inquiry response
data.billingAmount3 String Yes Billing Amount 3. Same value as Inquiry response
data.billingReff2 String Yes Billing Reference 2. Same value as Inquiry response
data.billingAmount2 String Yes Billing Amount 2. Same value as Inquiry response
data.billingReff1 String Yes Billing Reference 1. Same value as Inquiry response
data.billingAmount1 String Yes Billing Amount 1. Same value as Inquiry response
data.billStatCode String Yes bill status code. Same value as Inquiry response
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.amount String Customer’s bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
CustomerData.nominal String Customer’s bill amount
data.reffNum String Reference number. Same value as Payment request
trxType String Transaction’s type, “22” is for Postpaid
CustomerData.customName String Customer’s name. Same value as Payment request field customerName
CustomerData.no_telp String Customer’s Mobile Phone number
data.accountNumber String Agent’s account number. Same value as Payment request
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR412",
    "data": {
        "kode_mitra": "BNI",
        "kode_loket": "100021",
        "kode_cabang": "259",
        "pin_transaksi": "12345",
        "clientId": "IBOC",
        "reffNum": "201704261323120100021",
        "providerId": "HALO",
        "amount": "525000",
        "phoneNum": "081392007040",
        "customerNum": "",
        "NPWP": "",
        "customerName": "DWI YUDDYONO-DEPOK MAHARAJA",
        "flag": "00",
        "billStatCode": "0",
        "kandatelNum": "02",
        "billingReff3": "10443430008",
        "billingAmount3": "500000",
        "billingReff2": "",
        "billingAmount2": "25000",
        "billingReff1": "",
        "billingAmount1": "0",
        "accountNum": 115258134
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "22",
    "status": "success",
    "data": {
        "error": false,
        "ket": "HALO",
        "financialJournal": "278157",
        "journal": "934120070 ",
        "amount": "515100",
        "reffNum": "201704261323120110021",
        "accountNum": "115258134"
    },
    "result": {
        "kode_loket": "BNI259100021",
        "kd_lkt": "100021",
        "nama": "v agen",
        "kode_cabang": "259",
        "kode_mitra": "BNI",
        "alamat": "001 Menteng Menteng Kota Jakarta Pusat DKI Jakarta 10310"
    },
    "CustomerData": {
        "customerName": "DWI YUDDYONO-DEPOK MAHARAJA",
        "biaya_adm": null,
        "no_tel": "081392007040",
        "nominal": "515100",
        "time": "2017-04-26T13:35:23+07:00"
    }
}

Response (error)

{
    "trxType": "22",
    "status": "success",
    "data": {
        "error": true,
        "errorNum": "9990",
        "message": "Duplicate Refference Number"
    },
    "result": {
        "kode_loket": "BNI259100021",
        "kd_lkt": "100021",
        "nama": "v agen",
        "kode_cabang": "259",
        "kode_mitra": "BNI",
        "alamat": "001 Menteng Menteng Kota Jakarta Pusat DKI Jakarta 10310"
    },
    "CustomerData": {
        "customerName": "DWI YUDDYONO-DEPOK MAHARAJA",
        "biaya_adm": null,
        "no_tel": "081392007040",
        "nominal": "525000",
        "time": "2018-01-24T18:20:06+07:00"
    }
}
 
50. BPJS TK BPU & TKI – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.payment_type String Yes Payment Type : > BPJS TK BPU : BPJS_TKBPU > BPJS TK TKI : BPJS_TKTKI
data.billingId1 String Yes Customer’s billing Id
data.numberOfMonthOfBills String Yes Number of months of bills, with options 1, 3, 6, and 12
Response Definition
Name Type Description
ket String Transaction description
biaya_loket String Counter Fee
error String Transaction status : false : success true : failed
h_billingNum String BPJS participant number
h_requestId String Request Id
h_expiredDate String Expired Date
h_effectiveDate String Effective Date
h_activeDate String Active Date
h_countBillCode String Count bill code
h_contributionCode String Contribution Code
h_amountJKM String Amount JKM
h_amountJHT String Amount JHT
h_amountJKK String Amount JKK
h_totalBPJSTK String Total contributions amount
h_regFeeBPJSTK String Regular Fee BPJS TK
h_trxFeeBPJSTK String Trx Fee BPJS TK
h_program String BPJS TK Program
h_companyName String Company Name
c_fee String Transaction fee
h_companyId String Company Id
h_billingPeriod String Billing Period
c_totalPay String Total Payment, including h_totalBPJSTK and c_fee
total_amount String Total Payment, including h_totalBPJSTK, c_fee, and Counter fee
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR444",
    "data": {
        "kode_mitra": "KSN",
        "kode_loket": "50312",
        "kode_cabang": "259",
        "payment_type": "BPJS_TKBPU",
        "reffNum": "20171005160237050369",
        "billingId1": "3314104809910008",
        "numberOfMonthsOfBills": "1"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "ket": "Pembayaran BPJS TK Individu (BPU)",
    "h_billingNum": "3314104809910008",
    "h_requestId": "API125848000001034",
    "h_expiredDate": "07-10-2016",
    "h_effectiveDate": "13-10-2015",
    "h_activeDate": "13-06-2015",
    "h_countBillCode": "",
    "h_contributionCode": "900000054765",
    "h_amountJKM": "745200",
    "h_amountJHT": "0",
    "h_amountJKK": "2484000",
    "h_totalBPJSTK": "3229200",
    "h_regFeeBPJSTK": ".00",
    "h_trxFeeBPJSTK": ".00",
    "h_program": "JKK,JKM",
    "h_companyName": "TEGUH PRASETYO UTOMO",
    "c_fee": "0",
    "h_companyId": "J00",
    "h_billingPeriod": "12",
    "biaya_loket": "2500",
    "c_totalPay": 3229200,
    "total_amount": 3231700
}

Response (error)

{
    "error": true,
    "errorNum": "9805",
    "message": "(SOA) FAILED TO PARSE SOAP MESSAGE"
}
 
51. BPJS TK BPU & TKI – Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.biaya_loket String Yes Counter Fee. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.payment_type String Yes Payment Type : > BPJS TK BPU : BPJS_TKBPU > BPJS TK TKI : BPJS_TKTKI
data.h_billingNum String Yes BPJS participant number. Same value as Inquiry response
data.h_requestId String Yes Request Id. Same value as Inquiry response
data.h_expiredDate String Yes Expired Date. Same value as Inquiry response
data.h_effectiveDate String Yes Effective Date. Same value as Inquiry response
data.h_activeDate String Yes Active Date. Same value as Inquiry response
data.h_countBillCode String Yes Count bill code. Same value as Inquiry response
data.h_contributionCode String Yes Contribution Code. Same value as Inquiry response
data.h_amountJKM String Yes Amount JKM. Same value as Inquiry response
data.h_amountJHT String Yes Amount JHT. Same value as Inquiry response
data.h_amountJKK String Yes Amount JKK. Same value as Inquiry response
data.h_totalBPJSTK String Yes Total contributions amount. Same value as Inquiry response
data.h_regFeeBPJSTK String Yes Regular Fee BPJS TK. Same value as Inquiry response
data.h_trxFeeBPJSTK String Yes Trx Fee BPJS TK. Same value as Inquiry response
data.h_program String Yes BPJS Program. Same value as Inquiry response
data.h_companyName String Yes Company Name. Same value as Inquiry response
data.c_fee String Yes Transaction fee. Same value as Inquiry response
data.h_companyId String Yes Company Id. Same value as Inquiry response
data.h_billingPeriod String Yes Billing Period. Same value as Inquiry response
data.c_totalPay String Yes Total Payment, including h_totalBPJSTK and c_fee. Same value as Inquiry response
data.total_Amount String Yes Total Payment, including h_totalBPJSTK, c_fee, and Counter fee. Same value as Inquiry response
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
data.biaya_loket String Counter fee. Same value as Payment request
status String Transaction’s status
data.error String Transaction status : false : success true : failed
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
CustomerData.biaya_adm String Admin fee
data.reffNum String Reference number. Same value as Payment request
trxType String Transaction’s type, “114” is for BPJS TK BPU
data.h_billingNum String BPJS participant number. Same value as Payment request
data.h_requestId String Request Id. Same value as Payment request
data.h_expiredDate String Expired Date. Same value as Payment request
data.h_effectiveDate String Effective Date. Same value as Payment request
data.h_countBillCode String Count bill code. Same value as Payment request
data.h_contributionCode String Contribution Code. Same value as Payment request
data.h_amountJKM String Amount JKM. Same value as Payment request
data.h_amountJHT String Amount JHT. Same value as Payment request
data.h_amountJKK String Amount JKK. Same value as Payment request
data.h_totalBPJSTK String Total contributions amount. Same value as Payment request
data.h_regFeeBPJSTK String Regular Fee BPJS TK. Same value as Payment request
data.h_trxFeeBPJSTK String Trx Fee BPJS TK. Same value as Payment request
data.h_program String BPJS Program. Same value as Payment request
data.h_companyName String Company Name. Same value as Payment request
data.c_payMethod String Default “2"
data.c_dbNomorRek String Agent’s account number. Same value as Payment request field “data.accountNum”
data.c_description String Description. Same value as Payment request
data.c_fee String Transaction fee. Same value as Payment request
data.h_institutionId String Default "BPJS KETENAGAKERJAAN INDIVIDU (BPU)"
data.h_billingPeriod String Billing Period. Same value as Payment request
data.transactionDateTime String Transaction’s time
data.accountNumber String Agent’s account number. Same value as Payment request
data.c_totalPay String Total Payment, including h_totalBPJSTK and c_fee. Same value as Payment request
data.total_Amount String Total Payment, including h_totalBPJSTK, c_fee and counter fee. Same value as Payment request
CustomerData.noRek String Agent’s account number
CustomerData.nominal String Total Payment, including h_totalBPJSTK and c_fee
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR445",
    "data": {
        "kode_mitra": "KSN",
        "kode_loket": "50312",
        "kode_cabang": "259",
        "payment_type": "BPJS_TKBPU",
        "pin_transaksi": "12345",
        "reffNum": "20171005160237050439",
        "h_billingNum": "3314104809910008",
        "h_requestId": "API120320000144676",
        "h_expiredDate": "07-10-2016",
        "h_effectiveDate": "13-10-2015",
        "h_activeDate": "13-06-2015",
        "h_countBillCode": "",
        "h_contributionCode": "900000054765",
        "h_amountJKM": "745200",
        "h_amountJHT": "0",
        "h_amountJKK": "2484000",
        "h_totalBPJSTK": "3229200",
        "h_regFeeBPJSTK": ".00",
        "h_trxFeeBPJSTK": ".00",
        "h_program": "JKK,JKM",
        "h_companyName": "TEGUH PRASETYO UTOMO",
        "c_fee": "0",
        "h_companyId": "J00",
        "h_billingPeriod": "12",
        "accountNum": "116908716",
        "biaya_loket": "2500",
        "c_totalPay": 3229200,
        "total_amount": 3231700
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "114",
    "status": "success",
    "data": {
        "error": false,
        "ket": "Pembayaran BPJS TK Individu (BPU)",
        "h_billingNum": "3314104809910008",
        "h_requestId": "API120320000144676",
        "h_expiredDate": "07-10-2016",
        "h_effectiveDate": "13-10-2015",
        "h_countBillCode": "",
        "h_contributionCode": "900000013621",
        "h_amountJKM": "745200",
        "h_amountJHT": "0",
        "h_amountJKK": "2484000",
        "h_totalBPJSTK": "3229200",
        "h_regFeeBPJSTK": ".00",
        "h_trxFeeBPJSTK": ".00",
        "h_program": "JKK,JKM",
        "h_companyName": "TEGUH PRASETYO UTOMO",
        "c_payMethod": "2",
        "c_dbNomorRek": "116908716",
        "c_description": "",
        "c_fee": "0",
        "journal": "521339",
        "h_institutionId": "BPJS KETENAGAKERJAAN INDIVIDU (BPU)",
        "h_billingPeriod": "12",
        "transactionDateTime": "05-10-2017 13:03:54",
        "accountNumber": "116908716",
        "reffNum": "20171005160237050439",
        "biaya_loket": "2500",
        "c_totalPay": 3229200,
        "total_amount": 3231700,
        "errorNum": ""
    },
    "result": {
        "kode_loket": "KSN25950312",
        "kd_lkt": "50312",
        "nama": "KIOSON",
        "kode_cabang": "259",
        "kode_mitra": "KSN",
        "alamat": "RT 4 Tangsel Setiabudi Jakarta Selatan DKI JAKARTA 12910"
    },
    "CustomerData": {
        "biaya_adm": "0",
        "noRek": "116908716",
        "nominal": 3229200,
        "time": "2017-10-05T13:02:41+07:00"
    }
}

Response (error)

{
    "data": {
        "error": true,
        "message": "TRANSAKSI GAGAL : Pin transaksi salah",
        "errorNum": "-2"
    },
    "result": {
        "kode_loket": "KSN25950312",
        "kd_lkt": "50312",
        "nama": "KIOSON",
        "kode_cabang": "259",
        "kode_mitra": "KSN",
        "alamat": "RT 4 Tangsel Setiabudi Jakarta Selatan DKI JAKARTA 12910"
    },
    "CustomerData": {
        "biaya_adm": "0",
        "noRek": "116908716",
        "nominal": 3229200,
        "time": "2017-10-05T13:02:41+07:00"
    }
}
 
52. Airline Ticketing– Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.providerId String Yes List of providerId : 1. AIRASIA 2. CITILINK 3. GARUDA 4. LIONAIR 5. SRIWIJAYA
data.billingId String Yes Billing id
Response Definition
Name Type Description
ket String Transaction description
billerCode String Biller code
telkomFlag String Telkom flag
error String Transaction status : false : success true : failed
reffNum String Reference number which is combination of [transaction date] . [random number] . [agen’s counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : agen’s counter code Example : reffNum = 20170607110019123450100021
billingId String Billing id. Same value as inquiry request
pnrCode String Pnr Code
passangerName String Passanger Name
flightAmount String Number of flight on a billing id
flightInfo1 String Flight info 1
flightInfoExtended1 String Flight info extended 1
flightInfo2 String Flight info 1
flightInfoExtended2 String Flight info extended 1
flightInfo3 String Flight info 1
flightInfoExtended3 String Flight info extended 1
amount String Bill Amount
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR434",
    "data": {
        "clientId": "IBOC",
        "reffNum": "20151201171818000732",
        "providerId": "AIRASIA",
        "billingId": "2222"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "ket": "Ticket Airlane Inquiry",
    "reffNum": "20151201171818000732",
    "billingId": "2222",
    "pnrCode": "111112222233333",
    "passangerName": "CONAN AIR ASIA 2008 MELAYANG F",
    "telkomFlag": "02",
    "flightAmount": "2",
    "billerCode": "",
    "flightInfo1": "77AA1008CKG",
    "flightInfoExtended1": "DPS912061115",
    "flightInfo2": " 011508DPS",
    "flightInfoExtended2": "NYK212061615",
    "flightInfo3": "",
    "flightInfoExtended3": "",
    "amount": "200000"
}

Response (error)

{
    "error": true,
    "errorNum": "12",
    "message": "Invalid transaction"
}
 
53. Airline Ticketing– Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.telkomFlag String Yes Telkom flag. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.providerId String Yes Provider id. Same value as inquiry request
data.billingId String Yes Billing id. Same value as inquiry response
data.pnrCode String Yes Pnr Code. Same value as inquiry response
data.passangerName String Yes Passanger Name. Same value as inquiry response
data.flightAmount String Yes Number of flight on a billing id. Same value as inquiry response
billerCode String Yes Biller code. Same value as inquiry response
data.flightInfo1 String Yes Flight info 1. Same value as inquiry response
data.flightInfoExtended1 String Yes Flight info extended 1. Same value as inquiry response
data.flightInfo2 String Yes Flight info 1. Same value as inquiry response
data.flightInfoExtended2 String Yes Flight info extended 1. Same value as inquiry response
data.flightInfo3 String Yes Flight info 1. Same value as inquiry response
data.flightInfoExtended3 String Yes Flight info extended 1
data.amount String Yes Bill Amount. Same value as inquiry response
Response Definition
Name Type Description
data.ket String Transaction description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
status String Transaction’s status
data.error String Transaction status : false : success true : failed
CustomerData.nominal String Bill’s nominal
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
trxType String Transaction’s type, “50” is for Airline Ticketing
data.billingId String Billing id. Same value as Payment request
data.passangerName String Passanger Name. Same value as Payment request
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR435",
    "data": {
        "kode_mitra": "IPY",
        "kode_loket": "00005",
        "kode_cabang": "014",
        "pin_transaksi": "12345",
        "clientId": "IBOC",
        "reffNum": "20151201171218000733",
        "providerId": "AIRASIA",
        "billingId": "2222",
        "pnrCode": "111112222233333",
        "passangerName": "CONAN AIR ASIA 2008 MELAYANG F",
        "telkomFlag": "02",
        "flightAmount": "2",
        "billerCode": "",
        "flightInfo1": "77AA1008CKG",
        "flightInfoExtended1": "DPS912061115",
        "flightInfo2": "011508DPS",
        "flightInfoExtended2": "011508DPS",
        "flightInfo3": "",
        "flightInfoExtended3": "",
        "amount": "200000",
        "accountNum": "115258134"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "50",
    "status": "success",
    "data": {
        "error": false,
        "ket": "Ticket Airlane 2222",
        "journal": "936070796 ",
        "financialJournal": "192319",
        "billingId": "2222",
        "passangerName": "CONAN AIR ASIA 2008 MELAYANG F"
    },
    "result": {
        "kode_loket": "BNI02250001",
        "kd_lkt": 50001,
        "nama": "Ryan Ditya Permadi",
        "kode_cabang": "022",
        "kode_mitra": "BNI",
        "alamat": "1/1 Jatikarya Jati Sampurna Kota Bekasi Jawa Barat 17435"
    },
    "CustomerData": {
        "biaya_adm": null,
        "nominal": "200000",
        "time": "2015-12-30T00:08:42.931Z"
    }
}

Response (error)

{
    "data": {
        "error": true,
        "message": "TRANSAKSI GAGAL : Pin transaksi salah",
        "errorNum": "-2"
    },
    "result": {
        "kode_loket": "BNI02250001",
        "kd_lkt": 50001,
        "nama": "Ryan Ditya Permadi",
        "kode_cabang": "022",
        "kode_mitra": "BNI",
        "alamat": "1/1 Jatikarya Jati Sampurna Kota Bekasi Jawa Barat 17435"
    },
    "CustomerData": {
        "biaya_adm": null,
        "nominal": "5000",
        "time": "2015-12-30T00:08:42.931Z"
    }
}
 
54. Train Ticketing– Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.billingId String Yes Billing id
data.providerId String Yes Default “KAI”
Response Definition
Name Type Description
adminFee String Admin fee
telkomFlag String Telkom flag
productIndicator String Product indicator
billValue String Bill value
error String Transaction status : false : success true : failed
reffNum String Reference Number. Same value as Inquiry request
billingId String Billing id. Same value as inquiry request
passangerName String Passanger Name
amount String Passanger’s Bill Amount
formatVersion String Format Version
bookingCode String Booking Code
trainName String Train Name
kandNum String Kandatel Number
stationFrom String Station Form
stationTo String Station To
langCode String Lang Code
totalPassanger String Total Passanger
depatureDate String Depature Date
totalBilling String Total nominal billing
depatureTime String Depature Time
class String Train’s Class
seatNo String Train’s Seat Number
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2214860948771287",
    "fiturId": "FTR473",
    "data": {
        "kode_mitra": "ARD",
        "kode_loket": "100019",
        "kode_cabang": "259",
        "reffNum": "201705171021230100021",
        "clientId": "IBOC",
        "providerId": "KAI",
        "billingId": "0812457451",
        "pin_transaksi": "12345"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "reffNum": "201705171021230100021",
    "amount": "0",
    "billingId": "0812457451",
    "formatVersion": "0",
    "productIndicator": "8150",
    "bookingCode": "3XUQA7",
    "trainName": "ARGO BIMA 12345",
    "passengerName": "ARI BHAKTI 1234567891234567891",
    "telkomFlag": "02",
    "kandNum": "0",
    "stationFrom": "BDNG",
    "stationTo": "GMBR",
    "langCode": "0",
    "billValue": "1",
    "totalPassenger": "4",
    "depatureDate": "29-JUL-11",
    "totalBilling": "1000000",
    "depatureTime": "19.05",
    "adminFee": "7500",
    "class": "EKSA-1",
    "seatNo": "13A_13B_13C_13D"
}

Response (error)

{
    "error": true,
    "errorNum": "91",
    "message": "Transaksi tidak dapat dilakukan. Tidak ada balasan dari database provider/biller. (RC 91)"
}
 
55. Train Ticketing– Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
data.langCode String Yes Language code. Same value as Inquiry response
data.telkomFlag String Yes Telkom flag. Same value as Inquiry response
data.productIndicator String Yes Product indicator. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.billingId String Yes Billing id. Same value as inquiry response
data.passangerName String Yes Passanger Name. Same value as inquiry response
data.providerId String Yes Default “KAI”
data.amount String Yes Total Billing. Same value as inquiry response
data.formatVersion String Yes Format Version. Same value as inquiry response
data.bookingCode String Yes Booking Code. Same value as inquiry response
data.trainName String Yes Train Name. Same value as inquiry response
data.kandNum String Yes Kandatel Number. Same value as inquiry response
data.stationFrom String Yes Station Form. Same value as inquiry response
data.stationTo String Yes Station To. Same value as inquiry response
data.billValue String Yes Bill Value. Same value as inquiry response
data.totalPassanger String Yes Total Passanger. Same value as inquiry response
data.depatureDate String Yes Depature Date. Same value as inquiry response
data.totalBilling String Yes Total nominal billing. Same value as inquiry response
data.depatureTime String Yes Depature Time. Same value as inquiry response
data.adminFee String Yes Admin Fee. Same value as inquiry response
data.class String Yes Train’s Class. Same value as inquiry response
data.seatNo String Yes Train’s Seat Number. Same value as inquiry response
Response Definition
Name Type Description
data.journal String Transaction's journal
result.kode_loket String Agent code
result.nama String Agent name
result.alamat String Agent address
data.amount String Total payment. Same value as Payment request
status String Transaction’s status
data.error String Transaction status : false : success true : failed
CustomerData.nominal String Bill’s nominal
data.adminFee String Administration fee. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
data.accountNumber String Agent’s account number. Same value as Payment request
data.billingId String Billing id. Same value as Payment request
data.passangerName String Passanger Name. Same value as Payment request
trxType String Transaction’s type, “110” is for Train Ticketing
data.bookingCode String Booking Code. Same value as Payment request
data.trainName String Train Name. Same value as Payment request
data.stationFrom String Station Form. Same value as Payment request
data.stationTo String Station To. Same value as Payment request
data.totalPassanger String Total Passanger. Same value as Payment request
data.depatureDate String Depature Date. Same value as Payment request
data.totalBilling String Total nominal billing. Same value as Payment request
data.depatureTime String Depature Time. Same value as Payment request
data.class String Train’s Class. Same value as Payment request
data.seatNo String Train’s Seat Number. Same value as Payment request
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2214860948771287",
    "fiturId": "FTR474",
    "data": {
        "kode_mitra": "ARD",
        "kode_loket": "100019",
        "kode_cabang": "259",
        "clientId": "IBOC",
        "reffNum": "201705171054230100020",
        "amount": "100000",
        "providerId": "KAI",
        "billingId": "0812457451",
        "formatVersion": "0",
        "productIndicator": "8150",
        "bookingCode": "3XUQA7",
        "trainName": "ARGO BIMA 12345",
        "passengerName": "ARI BHAKTI 1234567891234567891",
        "telkomFlag": "02",
        "kandNum": "0",
        "stationFrom": "BDNG",
        "stationTo": "GMBR",
        "langCode": "0",
        "billValue": "1",
        "totalPassenger": "4",
        "depatureDate": "29-JUL-11",
        "totalBilling": "1000000",
        "depatureTime": "19.05",
        "adminFee": "7500",
        "classInfo": "EKSA-1",
        "seatNo": "13A_13B_13C_13D",
        "pin_transaksi": "12345",
        "accountNum": "115258134"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "trxType": "110",
    "status": "success",
    "data": {
        "error": false,
        "journal": "959280339 ",
        "financialJournal": "310846",
        "amount": "100000",
        "billingId": "0812457451",
        "bookingCode": "3XUQA7",
        "trainName": "ARGO BIMA 12345",
        "passengerName": "ARI BHAKTI 1234567891234567891",
        "stationFrom": "BDNG",
        "stationTo": "GMBR",
        "totalPassenger": "4",
        "depatureDate": "29-JUL-11",
        "totalBilling": "1000000",
        "depatureTime": "19.05",
        "adminFee": "7500",
        "class": "EKSA-1",
        "seatNo": "13A_13B_13C_13D",
        "accountNum": "115258134",
        "errorNum": ""
    },
    "result": {
        "kode_loket": "ARD259100019",
        "kd_lkt": "100019",
        "nama": "LALA",
        "kode_cabang": "259",
        "kode_mitra": "ARD",
        "alamat": "002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
    },
    "CustomerData": {
        "biaya_adm": null,
        "nominal": "100000",
        "time": "2017-05-17T11:00:52+07:00"
    }
}

Response (error)

{
    "data": {
        "error": true,
        "message": "TRANSAKSI GAGAL : Pin transaksi salah",
        "errorNum": "-2"
    },
    "result": {
        "kode_loket": "ARD259100019",
        "kd_lkt": "100019",
        "nama": "LALA",
        "kode_cabang": "259",
        "kode_mitra": "ARD",
        "alamat": "002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
    },
    "CustomerData": {
        "biaya_adm": null,
        "nominal": "100000",
        "time": "2017-05-17T11:00:52+07:00"
    }
}
 
56. Insurance – Bumiputera – Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format JSON
Authentication OAuth 2.0 (client credential)
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.pin_transaksi String Yes Agent PIN transaction
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.billingId String Yes Billing id
data.providerId String Yes List of ProviderId : Type of Payment FIELD Value ProviderId Initial Premium BUMIPUTERA_PERTAMA Continuation Premium BUMIPUTERA_LANJUTAN Top Up Premium BUMIPUTERA_TOPUP
Response Definition
Name Type Description
amount String Customer’s bill amount
error String Transaction status : false : success true : failed
reffNum String Reference Number. Same value as Inquiry request
billingId String Billing id. Same value as inquiry request
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2214860948771287",
    "fiturId": "FTR481",
    "data": {
        "kode_mitra": "ARD",
        "kode_loket": "100019",
        "kode_cabang": "259",
        "reffNum": "201705171021230100020",
        "providerId": "BUMIPUTERA_PERTAMA",
        "billingId": "457894",
        "pin_transaksi": "12345"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token=XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response (Success)

{
    "error": false,
    "reffNum": "201705171021230100020",
    "amount": "0",
    "billingId": "1234567890123456789",
    "currCode": "360",
    "frequency": "BULANAN",
    "customerName": "ALESSANDRO FLORENZI",
    "billInfo": "0",
    "prodCode": "0001",
    "dueDateMonth": "12 JANUARI",
    "billAmount": "123400",
    "billPremi": "123400",
    "billPremiPolis": "100000",
    "dueDateYear": "2016",
    "minValue": "12340",
    "polisStatus": "BELUM LUNAS",
    "payProof": "ABCDEFGHIJKLMNOPQRST",
    "errorNum": "",
    "fee": "0",
    "total_amount": 123400
}

Response (error)

{
    "error": true,
    "errorNum": "91",
    "message": "Transaksi tidak dapat dilakukan. Tidak ada balasan dari database provider/biller. (RC 91)"
}
 
57. Insurance – Bumiputera– Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.customerName String Yes Customer Name. Same value as Inquiry response
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.providerId String Yes Provider id. Same value as inquiry request
data.amount String Yes Total Billing. Same value as inquiry response
data.currCode String Yes Currency Code. Same value as inquiry response
data.frequency String Yes Frequency. Same value as inquiry response
data.billInfo String Yes Bill Info. Same value as inquiry response
data.prodCode String Yes Product Code. Same value as inquiry response
data.dueDateMonth String Yes Due Date month. Same value as inquiry response
data.billAmount String Yes Bill Amount. Same value as inquiry response
data.polisStatus String Yes Polis Status. Same value as inquiry response
data.fee String Yes Admin Fee. Same value as inquiry response
data.billingId String Yes Billing id of. Same value as inquiry response
data.billPremi String Yes Bill Premium. Same value as inquiry response
data.billPremiPolis String Yes Bill Premium Polis. Same value as inquiry response
data.dueDateYear String Yes Due Date Year. Same value as inquiry response
data.minValue String Yes Minimal Value. Same value as inquiry response
data.pin_transaksi String Yes Agent’s transaction pin
Response Definition
Name Type Description
data.journal String Transaction's journal
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.amount String Customer’s bill amount. Same value as Payment request
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
CustomerData.nominal String Customer’s bill amount
data.reffNum String Reference number. Same value as Payment request
CustomerData.noRek String Agent’s account number
data.billingId String Billing id. Same value as Payment request
trxType String Transaction’s type, “70” is for Bumiputera
data.currCode String Currency Code. Same value as Payment request
data.frequency String Frequency. Same value as Payment request
data.customerName String Customer Name. Same value as inquiry response
data.billInfo String Bill Info. Same value as Payment request
data.prodCode String Product Code. Same value as Payment request
data.dueDateMonth String Due Date month. Same value as Payment request
data.billAmount String Bill Amount. Same value as Payment request
data.billPremi String Bill Premium. Same value as Payment request
data.billPremiPolis String Bill Premium Polis. Same value as Payment request
data.dueDateYear String Due Date Year. Same value as Payment request
data.minValue String Minimal Value. Same value as Payment request
data.polisStatus String Polis Status. Same value as Payment request
data.payProff String Payment Proff. Same value as Payment request
result.kode_loket String Agent’s code
result.nama String Agent’s name
result.alamat String Agent’s address
data.providerId String Provider id. Same value as Payment request
CustomerData.total_amount String Total Amount, including billAmount and fee
data.errorNum String Transaction’s error number
data.accountNum String Agent’s account number
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2214860948771287",
    "fiturId": "FTR482",
    "data": {
        "kode_mitra": "ARD",
        "kode_loket": "100019",
        "kode_cabang": "259",
        "reffNum": "201705171021330100026",
        "amount": "121400",
        "providerId": "BUMIPUTERA_PERTAMA",
        "billingId": "1234567890123456789",
        "currCode": "360",
        "frequency": "BULANAN",
        "customerName": "ALESSANDRO FLORENZI",
        "billInfo": "0",
        "prodCode": "0001",
        "dueDateMonth": "12 JANUARI",
        "billAmount": "123400",
        "billPremi": "123400",
        "billPremiPolis": "100000",
        "dueDateYear": "2016",
        "minValue": "12340",
        "polisStatus": "BELUM LUNAS",
        "payProof": "ABCDEFGHIJKLMNOPQRST",
        "accountNum": "151219780",
        "fee": "0",
        "pin_transaksi": "12345"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response Example ( Success )

{
    "trxType": "70",
    "status": "success",
    "data": {
        "error": false,
        "reffNum": "201705171021330100026",
        "journal": "933110325 ",
        "financialJournal": "310702",
        "amount": "121400",
        "billingId": "1234567890123456789",
        "currCode": "360",
        "frequency": "BULANAN",
        "customerName": "ALESSANDRO FLORENZI",
        "billInfo": "0",
        "prodCode": "0001",
        "dueDateMonth": "12 JANUARI",
        "billAmount": "123400",
        "billPremi": "123400",
        "billPremiPolis": "100000",
        "dueDateYear": "2016",
        "minValue": "12340",
        "polisStatus": "BELUM LUNAS",
        "payProof": "ABCDEFGHIJKLMNOPQRST",
        "accountNum": "151219780",
        "providerId": "BUMIPUTERA_PERTAMA",
        "errorNum": ""
    },
    "result": {
        "kode_loket": "ARD259100019",
        "kd_lkt": "100019",
        "nama": "LALA",
        "kode_cabang": "259",
        "kode_mitra": "ARD",
        "alamat": "002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
    },
    "CustomerData": {
        "biaya_adm": "0",
        "total_amount": 123400,
        "noRek": "151219780",
        "nominal": "121400",
        "time": "2017-05-17T10:34:35+07:00"
    }
}

Response Example ( Error )

{
    "data": {
        "error": true,
        "message": "TRANSAKSI GAGAL : Pin transaksi salah",
        "errorNum": "-2"
    },
    "result": {
        "kode_loket": "ARD259100019",
        "kd_lkt": "100019",
        "nama": "LALA",
        "kode_cabang": "259",
        "kode_mitra": "ARD",
        "alamat": "002/003 GANDARIA SELATAN CILANDAK JAKARTA SELATAN DKI JAKARTA 15415"
    },
    "CustomerData": {
        "biaya_adm": "0",
        "total_amount": 123400,
        "noRek": "151219780",
        "nominal": "121400",
        "time": "2017-05-17T10:34:35+07:00"
    }
}
 
58. Internet Telkom– Inquiry
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
typereq String Yes Request type. Default “trans”
dealerId String Yes Dealer id for each BNI’s Mitra
data.providerId String Yes Default “SPEEDY”
data.billNo String Yes Billing number
Response Definition
Name Type Description
customerName String Customer Name
NPWP String Customer's NPWP
paymentFlag String Payment flag
billRef1 String Reference number of billing 1
amount String Customer’s bill amount
billAmount1 String Bill amount 1
billAmount2 String Bill amount 2
billAmount3 String Bill amount 3
error String Transaction status : false : success true : failed
billNo String Billing number. Same value as inquiry request
divreCode String Divre Code
datelCode String Datel code
amountBill String Number of billing
biaya_adm String Admin fee
total_amount String Total Amount, including amount and biaya_adm
billRef2 String Billing Reference 2
billRef3 String Billing Reference 3
Response (error) See Response Code

Request Example

{
    "typereq": "trans",
    "dealerId": "2114534465611173",
    "fiturId": "FTR413",
    "data": {
        "clientId": "IBOC",
        "providerId": "SPEEDY",
        "billNo": "02145456312",
        "reffNum": "20171121145415054300"
    }
}

Exp full url

https://{BNIServer}:{port}/keagenan/transaction?access_token= XUVAtlHXbjJZE69AJQXwjTzuNlYR1otNm2xLxFpcYZQiQp0Sbr5QUc

Response Example ( Success )

{
    "error": false,
    "amount": "65000",
    "billNo": "02145456312",
    "divreCode": "020201",
    "npwp": "123456789012345",
    "customerName": "JACO VAN NISTELROOY",
    "paymentFlag": "02",
    "datelCode": "0201",
    "amountBill": "2",
    "billAmount1": "",
    "billAmount2": "30000",
    "billAmount3": "35000",
    "billRef1": "",
    "billRef2": "209A238010",
    "billRef3": "208A837050",
    "biaya_adm": "2500",
    "total_amount": 67500
}

Response Example ( Error )

{
    "error": true,
    "errorNum": "05",
    "message": "General error"
}
 
59. Internet Telkom– Payment
Hostname https://apidev.bni.co.id
Port 8066
HTTP Method POST
Path /keagenan/transaction
HTTP Headers
Name Format Mandatory Description
Content-Type application/json Yes
X-Auth base64(username:password) Yes Username and password are set by MITRA username and MITRA password respectively
Query string parameters
Name Format Mandatory Description
access_token String Yes Token provided from gettoken request
Format Json
Authentication Oauth 2.0 ( client credential )
Request Definition
Field Data Type Mandatory Description
fiturId String Yes Feature Id, refer to Appendix 2.5.1
data.clientId String Yes Default “IBOC”
data.reffNum String Yes Reference number which is combination of [transaction date] . [random number] . [agen counter code] Note : 1. transaction date • Format : date('yyyymmddhhmmsszzzzz ') • Length : 19 digit 2. random number : random 0-9 • length : 1 digit 3. agen’s counter code : code for counter of MITRA Example : reffNum =20170607110019123450100021
data.kode_mitra String Yes Code for MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_mitra is “ABC”
data.kode_loket String Yes Code for counter of MITRA which is registered in BNI H2H system. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_loket is “1234567”
data.kode_cabang String Yes BNI branch code. This code is part of the agent code. Example : Agen Code : ABC9991234567 kode_cabang is “999”
data.NPWP String Yes Customer NPWP. Same value as Inquiry response
data.customerName String Yes Customer Name. Same value as Inquiry response
data.paymentFlag String Yes Payment flag. Same value as Inquiry response
typereq String Yes Request type. Default “trans”
data.billingId String Yes Customer’s billing number. Same value as Inquiry response
data.amount String Yes Customer’s bill amount. Same value as Inquiry response
dealerId String Yes Dealer id for each BNI’s Mitra
data.accountNum String Yes Agent’s account number
data.providerId String Yes Default “SPEEDY”
data.billNo String Yes Billing number. Same value as inquiry response
data.divreCode String Yes divreCode. Same value as inquiry response
data.datelCode String Yes Datel code. Same value as inquiry response
data.amountBill String Yes Number of billing. Same value as inquiry response
data.billAmount1 String Yes Billing Amount 1. Same value as inquiry response
data.billAmount2 String Yes Billing Amount 2. Same value as inquiry response
data.billAmount3 String Yes Billing Amount 3. Same value as inquiry response
data.billRef1 String Yes Billing Reference 1. Same value as inquiry response
data.billRef2 String Yes Billing Reference 2. Same value as inquiry response
data.billRef3 String Yes Billing Reference 3. Same value as inquiry response
data.biaya_adm String Yes Admin fee. Same value as inquiry response
data.pin_transaksi String Yes Agent’s transaction pin
Response Definition
Name Type Description
data.journal String Transaction's journal
data.customerName String Customer name.Same value as Payment request
data.billAmount1 String Amount payment of billing 1. Same value as Payment request
data.billAmount2 String Amount payment of billing 2. Same value as Payment request
data.billAmount3 String Amount payment of billing 3. Same value as Payment request
status String Transaction’s status
data.error String Transaction status : false : success true : failed
data.amount String Customer’s bill amount. Same value as Payment request
CustomerData.time String Transaction’s time
result.kd_lkt String Agent’s counter code
result.kode_cabang String Agent’s branch code
result.kode_mitra String Agent’s mitra code
data.financialJurnal String Transaction’s financial journal
CustomerData.biaya_adm String Admin fee
data.reffNum String Reference number. Same value as Payment request
result.kode_loket String Agent’s code
result.nama String Agent’s name
result.alamat String Agent’s address
trxType String Transaction&rs