Generate Widget
Generate widget untuk merchant, rujuk bagian Pembayaran dan Penagihan untuk informasi terperinci. Token dari respons adalah nilai header untuk Auth Bearer guna mengizinkan akses ke API Produk, Penagihan, dan Pembayaran. Batas waktu untuk token adalah data dari permintaan bidang batas waktu.
URL Endpoint
| Environment | Method | URL |
|---|---|---|
| Development | POST | https://devo.finnet.co.id/v1/widget/generate |
| Production | POST | https://live.finnet.co.id/v1/widget/generate |
Generate Request
| No | Name | Type | Mandatory | Min Length | Max Length | Description |
|---|---|---|---|---|---|---|
| 1 | backUrl | String | M | 1 | 100 | URL |
| 2 | trxId | String | M | 1 | 32 | Transaction Id |
| 3 | merchantId | String | M | 1 | 100 | Merchant Id |
| 4 | uniqKey | String | M | 1 | 32 | Unique Key by Merchant |
| 5 | returnUrl | String | M | 1 | 100 | URL |
| 6 | timestamp | String | M | 1 | 19 | YYYY-MM-DD HH:mm:ss |
| 7 | productCodes | Array | M | 1 | 999 | List Of Biller |
| 8 | terminal | String | M | 1 | 8 | Terminal Id |
| 9 | terminalName | String | M | 1 | 20 | Terminal Name |
| 10 | billInfo | Object | O | 1 | 6 | Detail of Bill Info |
| 11 | isNotif | Boolean | M | 1 | 5 | True or False |
| 12 | timeout | String | M | 1 | 10 | Timeout in second |
| 13 | merchantSignature | String | M | 1 | 100 | SHA256 |
Sample Generate Request (with BillInfo)
{
"backUrl": "url",
"trxId": "12315139062851",
"username": "{{username}}",
"uniqKey": "12457365867",
"returnUrl": "url",
"timestamp": "2024-05-30 00:21:12",
"productCodes": [
"080003"
],
"terminal": "48511",
"terminalName": "Loket Bidakara",
"billInfo": {
"billNumber": "8888800393834857",
"amount": "0",
"period": "01",
"customerName": "customer name",
"customerPhone": "1234567890",
"customerEmail": "customer@gmail.com"
},
"isNotif": true,
"timeout": "30",
"merchantSignature": "9f64e59637dc36d5348dbb3cc600a1c2f07c68b513de083790abbf26f2eeee91",
}
Sample Generate Request (without BillInfo)
{
"backUrl": "https://testing.com/back",
"trxId": "12315139062851",
"username": "{{userName}}",
"uniqKey": "12457365867",
"returnUrl": "https://testing.com/return",
"timestamp": "2024-07-19 14:15:20", // YYYY-MM-DD HH:mm:ss
"productCodes": [
"080003"
],
"terminal": "Term0001",
"terminalName": "Terminal Testing",
"isNotif": true,
"timeout": "1800",
"merchantSignature": "55f70ab4b1ebaba89af351885f8a019db4713aaa498642f43f8f9ae1731430e7"
}
Generate Response
| No | Name | Type | Mandatory | Min Length | Max Length | Description |
|---|---|---|---|---|---|---|
| 1 | responseCode | Enum | M | 1 | 7 | Status Code for Generate Widget |
| 2 | responseDesc | String | M | 1 | 100 | Status Description for Generate Widget |
| 3 | redirectURL | String | M | 1 | 100 | URL to Widget App with access token included |
Sample Generate Response (with BillInfo)
{
"data": {
"responseCode": "2000000",
"responseDesc": "Success",
"redirectURL": "http://localhost:3000/19082efe780bfae592fbfabd20bbb19b1746068db1c02a8a359612556f464b8f",
"requestID": "20240601000001",
"responseBill": {
"bit61": "888880039383485701 00488888003938371071005 SUKABUMI AYU RAIS ANSHARI 00000000000000000003500088888003938370391005 SUKABUMI ADAM RAIS ANSHARI 00000000000000000003500088888003938360621005 SUKABUMI SITI SAJAAH 00000000000000000003500088888003938348571005 SUKABUMI AGUS RAIS ANSHARI 000000000000000000035000 000000000000000000000000 000000000000000000000000 000000000000000000000000000000000000000000140000 3B13CC0D7F826938",
"customerData": {
"balanceTotal": "000000000000",
"billInfo1": {
"balance": "000000000000",
"branchCode": "1005",
"branchName": "SUKABUMI",
"customerId": "8888800393837107",
"customerName": "AYU RAIS ANSHARI",
"premiBill": "000000035000"
},
"billInfo2": {
"balance": "000000000000",
"branchCode": "1005",
"branchName": "SUKABUMI",
"customerId": "8888800393837039",
"customerName": "ADAM RAIS ANSHARI",
"premiBill": "000000035000"
},
"billInfo3": {
"balance": "000000000000",
"branchCode": "1005",
"branchName": "SUKABUMI",
"customerId": "8888800393836062",
"customerName": "SITI SAJAAH",
"premiBill": "000000035000"
},
"billInfo4": {
"balance": "000000000000",
"branchCode": "1005",
"branchName": "SUKABUMI",
"customerId": "8888800393834857",
"customerName": "AGUS RAIS ANSHARI",
"premiBill": "000000035000"
},
"billInfo5": {
"balance": "000000000000",
"branchCode": "",
"branchName": "",
"customerId": "",
"customerName": "",
"premiBill": "000000000000"
},
"billInfo6": {
"balance": "000000000000",
"branchCode": "",
"branchName": "",
"customerId": "",
"customerName": "",
"premiBill": "000000000000"
},
"billInfo7": {
"balance": "000000000000",
"branchCode": "",
"branchName": "",
"customerId": "",
"customerName": "",
"premiBill": "000000000000"
},
"customerId": "8888800393834857",
"memberTotal": "004",
"numberOfMonth": "01",
"phoneNumber": "",
"premiTotal": "000000140000",
"reffNo": "3B13CC0D7F826938"
},
"resultCode": "00",
"resultDesc": "Approve",
"sysCode": "556566702543",
"productCode": "080003",
"terminal": "48511",
"transactionType": "38",
"amount": "140000",
"feeAmount": "1000",
"bit48": "null",
"traxId": "20240601000001",
"timeStamp": "2024-06-01 14:15:45",
"timeStampServer": "01-06-2024 14:15:48:000369"
}
},
"pagination": [],
"stat_code": "APP:SUCCESS",
"stat_msg": "Success"
}
Sample Generate Response (without BillInfo)
{
"data": {
"responseCode": "2000000",
"responseDesc": "Success",
"redirectURL": "http://localhost:3000/?token=60f7f579683f8ef6e22e4c0b755364c82a42218236c9dd5519d423590967df2a"
},
"pagination": [],
"stat_code": "APP:SUCCESS",
"stat_msg": "Success"
}