BNI VA Static Integration
Post Data
The services API is basically the same as the existing Post data API in Debit Integration. However, there are differences in the bill_expired parameter.
Endpoint URL Post Data
Environment | URL |
---|---|
Production | |
Development |
Method: HTTP POST
Request Parameter Post Data
Parameter | Data Type | M/O/C | Description |
---|---|---|---|
request | Alphanumeric (50) | M | Request Description |
merchant_id | Numeric (5) | M | Merchant Code From Faspay = BOI |
merchant | Alphanumeric (32) | M | Merchant Name |
bill_no | Numeric (16) | M | Virtual Account Number from channel (BNI VA). (prefix 3 + client id 5+ faspay id 2 + 6 free digits) |
bill_reff | Alphanumeric (32) | O | Booking Number/reffrence (can fill same with order no) |
bill_date | Datetime YYYY-MM-DD HH:MM:SS (6) | M | Transaction/ Order Date |
bill_expired | Datetime YYYY-MM-DD HH:MM:SS (6) | M | Payment Expired Date (Merchant can set > 30 days or less, except past date). |
bill_desc | Alfanumeric (128) | M | Transaction Description |
bill_currency | Alphanumeric (3) | M | Currency, Must be 'IDR' |
bill_gross | Numeric (15) | O | Order Nominal |
bill_miscfee | Numeric (15) | O | Miscellaneous fee |
bill_total | Numeric (15) | M | Open maximum amount. Amount maximum per transaction. |
payment_channel | Numeric (32) | M | Payment Channel Code |
pay_type | Alphanumeric (1) | M | Payment type : 1: Full Settlement 2: Installment 3: Mixed 1 & 2 Pay Type 2 & 3 only implement on BCA KlikPay channel |
cust_no | Alphanumeric (32) | M | Customer Number |
cust_name | Alphanumeric (128) | M | Customer Name |
bank_user_id | Alphanumeric (128) | O | Customer User ID on bank’s services (ex : KlikBCA User Id) |
msisdn | Numeric (64) | M | Customer Mobile Phone |
Alphanumeric (128) | M | Customer Email | |
terminal | Numeric (16) | M | Always use 10 for Terminal |
billing_name | Alphanumeric | C | Billing name for OVO |
billing_lastname | Billing name | O | biling last name |
billing_address | Alphanumeric (200) | O | billing_address |
billing_address_city | Alphanumeric (50) | O | Billing City |
billing_address_region | Alphanumeric (100) | O | Billing Addres Region |
billing_address_state | Alphanumeric (100) | O | Billing Address State |
billing_address_poscode | Alphanumeric (10) | O | Billing Address Pos Code |
billing_address_country_code | Alphanumeric (10) | O | Billing Address Country Code |
receiver_name_for_shipping | Alphanumeric (100) | C | Receiver Name |
shipping_lastname | Alphanumeric | O | Receiver last name |
shipping_address | Alphanumeric (200) | O | Shipping Address |
shipping_address_city | Alphanumeric (50) | O | Shipping Address City |
shipping_address_region | Alphanumeric (100) | O | Shipping Address Region |
shipping_address_state | Alphanumeric (100) | O | Shipping Address State |
shipping_address_poscode | Alphanumeric (10) | O | Shipping Address Pos Code |
shipping_address_country_code | Alphanumeric (10) | O | Shipping Address Country Code |
shipping_msisdn | Numeric | C | Shipping phone number |
product | Alphanumeric (50) | M | Item Name |
amount | Numeric | M | Item Price |
qty | Numeric (32) | M | Item Quantity |
payment_plan | Numeric (1) | M | Payment plan 1: Full Settlement 2: Installement |
tenor | Numeric (2) | M | Installment Tenor 00: Full Payment 03: 3 months 06: 6 months 12: 12 months Tenor 03,06,12 only use on BCA KlikPay channel |
merchant_id | Numeric (5) | M | Merchant Id From Payment Channel ex : MID from BCA KlikPay |
reserve1 | Alphanumeric (50) | O | |
reserve2 | Alphanumeric (50) | C | |
signature | Alphanumeric (100) | M | sha1(md5(user_id merchant + password merchant + bill_no) |
Response Parameter Post Data
Parameter | Data Type | M/O/C | Description |
---|---|---|---|
response | Alphanumeric (50) | O | Response Name |
trx_id | Numeric (16) | M | Transaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired |
merchant_id | Numeric (5) | M | Merchant Code |
merchant | Alphanumeric (32) | M | Merchant Name |
bill_no | Numeric (16) | M | Virtual Account Number from channel (BNI VA). (prefix 3 + client id 5+ faspay id 2 + 6 free digits) |
response_code | Numeric (2) | M | Response Code 00 Success |
response_desc | Alphanumeric (32) | M | Response Code Description |
redirect_url | Alphanumeric | O | the redirect url for the next process, available only on JSON format |
Inquiry Payment Status Request
In this API service, basically the Inquiry Payment Status parameter is the same as the existing one. The difference is that when hit, the response received is a list of several transactions using that VA number.
Endpoint URL Inquiry Payment Status
Environment | URL |
---|---|
Production | |
Development |
Inquiry Payment Status Request
The parameters that must be provided by the merchant system to be able to integrate with the Faspay system are as follows:
Parameter | Data Type | M/O/C | Description |
---|---|---|---|
request | Alphanumeric | O | Request Description |
trx_id | Numeric | M | Transaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired. |
bill_no | Numeric | M | Virtual Account Number from channel (BNI VA). (prefix 3 + client id 5+ faspay id 2 + 6 free digits) |
merchant_id | Numeric | M | Merchant Code. |
signature | Numeric | M | sha1(md5((user_id + password + bill_no)) |
Inquiry Payment Status Response
Parameter | Data Type | M/O/C | Description | |
---|---|---|---|---|
response |
| Alphanumeric (50) | M | Response description |
merchant_id |
| Numeric (6) | M | Merchant Code |
merchant |
| Alphanumeric (32) | M | Merchant name |
bill_no |
| Numeric (16) | M | Virtual Account Number from channel (BNI VA). (prefix 3 + client id 5+ faspay id 2 + 6 free digits) |
transaction | Transaction data object | M | collection of all transaction data status used | |
| trx_id | Numeric (16) | M | Transaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired |
| Payment_reff | Numeric (16) | M | Payment Reff (from Payment Channel) |
| payment_date | DateTime | M | Payment Date (from Payment Channel) |
| paymnet_status_code | Numeric | M | Status Code 0 Unprocessed 1 In Process 2 Payment Success 4 Payment Reserval 5 No bills found 8 Payment Cancelled 9 Unknown |
| payment_status_desc | Alphanumeric | M | Description status of Payment |
response_code |
| Numeric | M | Response Code 00 Success |
response_desc |
| Alphanumeric | M | Response Description |
Update Transaction
This service aims to update static transactions, transaction updates can be done before or after making payments.
Endpoint URL Inquiry Update Transaction
Environment | URL |
Production | |
Development |
Update Transaction Request
The parameters that must be provided by the merchant system to be able to integrate with the Faspay system are as follows:
Parameter | Data Type | M/O/C | Description |
---|---|---|---|
request | Alphanumeric | M | Request Description |
bill_no | Numeric | M | Virtual Account Number from channel (BNI VA). (prefix 3 + client id 5+ faspay id 2 + 6 free digits) |
merchant_id | Numeric | M | Merchant code |
bill_total | Numeric | M | Open maximum amount. Amount maximum per transaction. |
cust_name | Alphanumeric | M | Custumer name |
bill_expired | DateTime (YYYY:MM:DD HH:MM:SS) | M | Payment Expired Date (Merchant can set > 30 days or less, except past date). |
signature | Alphanumeric | M | sha1(md5((merchant_id + passwd + bill_no)) |
Update Transaction Response
Parameter | Data Type | M/O/C | Description |
---|---|---|---|
response_code | Numeric | M | Response code |
response_desc | Alphanumeric | M | Response description |
bill_no | Numeric | M | Virtual Account Number from channel (BNI VA). (prefix 3 + client id 5+ faspay id 2 + 6 free digits) |
Payment Notification
Payment notification from Faspay to Merchant backend will also be triggered on event of transacion status getting updated, to ensure merchant is securely informed. Please provide the URL and make sure it's already register on Faspay system.
The detail API reference can be find here
Last updated