SANDBOX
Logo

Sandbox Fintech SBU Digital Platform

Berikut Overview dari Fintech SBU Giro MPospay Sandbox APIs:


Method EndPoint Usage
POST http://103.123.39.238:7879/finsbu/h2h API B2B Messaging
POST http://103.123.39.238:8772/finsbu/h2h API B2B Messaging

Silahkan coba APIs kami menggunakan Sandbox. Kami menyediakan sandbox dengan data dummy dan static.

HTTP Method

  • HTTP Method yang digunakan adalah POST.
  • HTTP Method harus dikirim dengan huruf capital.

User Agent

Settingan USER AGENT untuk client yang mengakses APIs webservice di set (case sensitive) : FinSBUGiroMPospay-B2B

Headers

Agar komunikasi berhasil dengan APIs Fintech SBU Giro MPospay, anda harus mengirim beberapa headers di setiap request API :


Name Type Description
Authorization Alphanumeric Basic Base64(client_id:client_secret)
Content-Type Alphanumeric (application/json)
Origin Url Origin domain e.g. yourdomain.com)

Signature

Signature digunakan oleh APIs Fintech SBU Giro MPospay untuk menjamin bahwa pesan yang ada kirim tidak diubah oleh yang tidak berhak. Pembuatan signature menggunakan enkripsi hashing MD5. Garis besar proses pembuatan Signature adalah sebagai berikut:

  1. Ambil nilai dari field type (ex : inquiry, payment, purchase etc..).
  2. Ambil nilai dari field account (ex : 0000000018).
  3. Ambil nilai dari field institutionCode (ex : 180309000002).
  4. Ambil nilai dari field product (ex : 2042).
  5. Ambil nilai dari field billNumber (ex : AF085713323054).
  6. Ambil nilai dari field trxId (ex : 00000001).
  7. Ambil parameter password APIs yang dibarikan oleh Fintech SBU Giro MPospay (ex : aad16aabac2b3d4e17f04a95e2a2372f).
  8. Ambil nilai current date, dengan format : yyyy-mm-dd (ex : 2018-03-22').
  9. Ambil parameter KEY APIs yang dibarikan oleh Fintech SBU Giro MPospay (ex : f1ntechSBU@2018#).
  10. Gabungkan semua parameter diatas kemudian lakukan enkripsi dengan hashing MD5.

Contoh Message :

{
	"type":"inquiry",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"2042", 
	"billNumber":"AF085713323054",
	"trxId":"00000001",
	"retrieval":"20180125003025879",
	"sign":"b3847e3a099979c1d96e3d186e0e05fa"
}

Formula = md5(type+account+institutionCode+product+billNumber+trxId+password+current_date+key)
StringToSign = inquiry+0000000018+180309000002+2042+AF085713323054+00000001+aad16aabac2b3d4e17f04a95e2a2372f+2018-03-22+f1ntechSBU@2018#
StringToSign = MD5(inquiry00000000181803090000022042AF08571332305400000001aad16aabac2b3d4e17f04a95e2a2372f2018-03-22f1ntechSBU@2018#)
Hasil = b3847e3a099979c1d96e3d186e0e05fa

Berikut beberapa parameter yang harus anda kirim untuk API B2B :

Request

Field Data Field Mandatory Description
Type String(12) Y Tipe API Service
accountType String(6) Y Tipe Account. Default B2B
account String(10) Y Account Giro Mpospay. Format : Number, 10
institutionCode String(12) Y Account
product String(5) Y Account Giro Mpospay. Format : Number, 4
billNumber String(1500) Y Nomor pelanggan, nomor handphone atau nomor billing
trxId String(8) Y Nomor urut trasnaksi. Format : Number, 8
retrieval String(17) Y Waktu transaksi, format : yyyymmddhhiisszzz
sign String(32) Y Signature, MD5(type+account+institutionCode+product+billNumber+trxId+password+current_date+key)

Respon

Field Data Field Mandatory Description
Type String(12) Y Tipe API Service
accountType String(6) Y Tipe Account. Default B2B
account String(10) Y Account Giro Mpospay. Format : Number, 10
institutionCode String(12) Y Account
product String(5) Y Account Giro Mpospay. Format : Number, 4
billNumber String(1500) Y Nomor pelanggan, nomor handphone atau nomor billing
trxId String(8) Y Nomor urut trasnaksi. Format : Number, 8
retrieval String(17) Y Waktu transaksi, format : yyyymmddhhiisszzz
sign String(32) Y Signature, MD5(type+account+institutionCode+product+billNumber+trxId+password+current_date+key)
resultCode String(3) Y Kode respon dari web service. Format, Number 3
resultDesc String(1000) Y Keterangan respon dari web service
nominal String(12) Y Nominal tagihan, format Number : 12
admin String(8) Y Nominal bea admin B2B, format Number : 8
info1 String(1000) Y Informasi Resi
info2 String(1000) Y Informasi Konten Produk
info3 String(1000) Y Informasi tambahan
jmlLembar String(1) Y Jumlah lembar transaksi
saldo String(12) Y Jumlah sisa saldo, format Number : 12

Berikut daftar API Services B2B Messaging :

POST /finsbu/h2h

Request :

POST http://103.123.39.238:7879/finsbu/h2h HTTP/1.1
Authorization: Basic Base64(client_id:client_secret)
Content-Type: application/json
Origin: [yourdomain.com]

{
	"type":"inquiry",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"2042",
	"billNumber":"AF085713323054",
	"trxId":"00000001",
	"retrieval":"20180125003025879",
	"sign":"b3847e3a099979c1d96e3d186e0e05fa"
}

Response :

{
	"type":"inquiry",
	"service":"responseInquiry",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"2042",
	"billNumber":"AF085713323054",
	"resultCode":"000",
	"resultDesc":"SUKSES",
	"nominal":"304000",
	"admin":"1550",
	"trxId":"00000001",
	"retrieval":"20180125003025879",
	"paymentCode":"21b555433f8de4b86144642d29d56839",
	"info1":"Kode Bayar : AF085713323054|Kode Reff : 900017|ID Transaksi: TKP154821699|Nama: Eduard Budiharto|Desk.Order : Pembelian dari Tokopedia|Jml Tagihan : Rp.304.000|",
	"info2":"TAGIHAN TOKOPEDIA|##1",
	"info3":"",
	"jmlLembar":"1",
	"saldo":"",
	"signature":"b3847e3a099979c1d96e3d186e0e05fa"
}

POST /finsbu/h2h

Request :

POST http://103.123.39.238:7879/finsbu/h2h HTTP/1.1
Authorization: Basic Base64(client_id:client_secret)
Content-Type: application/json
Origin: [yourdomain.com]

{
	"type":"payment",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"2042",
	"billNumber":"AF085713323054",
	"trxId":"00000002",
	"retrieval":"20180125003025879",
	"paymentCode":"21b555433f8de4b86144642d29d56839",
	"sign":"1a3a62586844e13ca9bb64d0056d7d7c"
}

Response :

{
	"type":"payment",
	"service":"responsePayment",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"2042",
	"billNumber":"AF085713323054",
	"resultCode":"000",
	"resultDesc":"SUKSES",
	"nominal":"304000",
	"admin":"1550",
	"trxId":"00000001",
	"retrieval":"20180125003025879",
	"paymentCode":"21b555433f8de4b86144642d29d56839",
	"info1":"Kode Bayar : AF085713323054|Kode Reff : 900017|ID Transaksi: TKP154821699|Nama: Eduard Budiharto|Desk.Order : Pembelian dari Tokopedia|Jml Tagihan : Rp.304.000|",
	"info2":"TAGIHAN TOKOPEDIA|##1",
	"info3":"",
	"jmlLembar":"1",
	"saldo":"11500000",
	"signature":"1a3a62586844e13ca9bb64d0056d7d7c"
}

POST /finsbu/h2h

Request :

POST http://103.123.39.238:7879/finsbu/h2h HTTP/1.1
Authorization: Basic Base64(client_id:client_secret)
Content-Type: application/json
Origin: [yourdomain.com]

{
	"type":"purchase",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"3100",
	"billNumber":"08132259999",
	"trxId":"00000004",
	"retrieval":"20180222161223123",
	"sign":"85afd2485c7f91177d006c51ff771f8c"
}

Response :

{
	"type":"purchase",
	"service":"responsePayment",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"3100",
	"billNumber":"08132259999",
	"resultCode":"000",
	"resultDesc":"SUKSES",
	"nominal":"10050",
	"admin":"0",
	"trxId":"00000004",
	"retrieval":"20180222161223123",
	"paymentCode":"21b555433f8de4b86144642d29d56839",
	"info1":"NO. HANDPHONE : 0081291887774|NILAI VOUCHER : 100000|NO.REF :0041002220476240|",
	"info2":"PEMBELIAN PULSA TELKOMSEL|##Untukkeluhan Hub.133|Npwp TSEL:01.718.327.8.093.000",
	"info3":"",
	"jmlLembar":"1",
	"saldo":"11500000",
	"signature":"85afd2485c7f91177d006c51ff771f8c"
}

POST /finsbu/h2h

Request :

POST http://103.123.39.238:7879/finsbu/h2h HTTP/1.1
Authorization: Basic Base64(client_id:client_secret)
Content-Type: application/json
Origin: [yourdomain.com]

{
	"type":"advice",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"2042",
	"billNumber":"AF085713323054",
	"trxId":"00000002",
	"retrieval":"20180125003025879",
	"paymentCode":"21b555433f8de4b86144642d29d56839",
	"sign":"e88ab993f7a9ce1a9e2b78e15a485ccf"
}

Response :

{
	"type":"advice",
	"service":"responsePayment",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"2042",
	"billNumber":"AF085713323054",
	"resultCode":"000",
	"resultDesc":"SUKSES",
	"nominal":"304000",
	"admin":"1550",
	"trxId":"00000001",
	"retrieval":"20180125003025879",
	"paymentCode":"21b555433f8de4b86144642d29d56839",
	"info1":"Kode Bayar : AF085713323054|Kode Reff : 900017|ID Transaksi: TKP154821699|Nama : Eduard Budiharto|Desk.Order : Pembelian dari Tokopedia|Jml Tagihan : Rp.304.000|",
	"info2":"TAGIHAN TOKOPEDIA|##1",
	"info3":"",
	"jmlLembar":"1",
	"saldo":"11500000",
	"signature":"e88ab993f7a9ce1a9e2b78e15a485ccf"
}

POST /finsbu/h2h

Request :

POST http://103.123.39.238:7879/finsbu/h2h HTTP/1.1
Authorization: Basic Base64(client_id:client_secret)
Content-Type: application/json
Origin: [yourdomain.com]

{
	"type":"balanceInquiry",
	"accountType":"B2B",
	"account":"0000000018",
	"institutionCode":"180309000002",
	"product":"CBS",
	"billNumber":"0000000018",
	"trxId":"00000006",
	"retrieval":"20180125003025879",
	"sign":"2855d3b6a6eda783ab5a91b115b59186"
}

Response :

{
	"type":"balanceInquiry",
	"service":"responseBalanceInquiry",
	"accountType":"B2B",
	"account":"0000000018",
	"product":"CBS",
	"billNumber":"0000000018",
	"resultCode":"00",
	"resultDesc":"success",
	"nominal":"0",
	"admin":"0",
	"trxId":"00000006",
	"retrieval":"20180125003025879",
	"paymentCode":"",
	"info1":"Customer Name : WISNU|Product Code : WADIAH|Balance :2451000|",
	"info2":"01000021",
	"info3":"WISNU|WADIAH|2451000|",
	"jmlLembar":"0",
	"saldo":"2451000",
	"signature":"2855d3b6a6eda783ab5a91b115b59186"
}

ErrorsAPI Fintech SBU Giro MPospay menggunakan skema error berikut :

{ 
	"resultCode":"00",
	"resultDesc":"success"
}
Kode Respon Pesan Respon
000 Sukses
301 Parameter kosong (tidak valid)
102 Mohon maaf, System dalam maintenance. Mohon coba kembali 3 menit kedepan
103 Mohon maaf, Transaksi tidak bisa dilakukan di atas cutt of time
104 Kode Produk tidak valid
105 Mohon maaf, Transaksi tidak bisa dilakukan di atas cutt of time
106 Mandatory field tidak valid (tidak boleh kosong)
107 Panjang trxId tidak valid
108 Content message dari database kosong
109 Gagal proses database
198 Gagal proses message
998 Mohon maaf, service B2B sedang maintenance
997 Parameter tidak valid
Request Inquiry / Purchase
996 Kode institution tidak valid atau tidak ditemukan
995 Produk tidak valid atau tidak aktif
994 Signature is not match
993 Service (Produk) belum memiliki routing host
992 Account anda terblokir. Mohon hubungi adminstrator
991 Member belum memiliki harga referensi untuk produk ini
Request Payment
996 paymentCode tidak ditemukan (reqPayment)
995 paymentCode ini sudah di-payment. Lakukan cek status (reqPayment)
994 Signature is not match (reqPay)
993 Service (Produk) belum memiliki routing host (reqPay)

Development Test API

DATA
Post
REQUEST
RESPONSE