BNI VA Static Integration
POST Data
The services API is the same as the existing post-data API in Debit Integration. However, there are differences in the bill_expired parameter.
Endpoint URL Post Data
Development
Method: HTTP POST
Request Parameter POST Data
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
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, 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
Development
Inquiry Payment Status Request
The parameters that the merchant system must provide to be able to integrate with the Faspay system are as follows:
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
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
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
Development
Update Transaction Request
the merchant system must provide the parameters that must be provided by the merchant system to be able to integrate with the Faspay system are as follows:
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
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 the Merchant backend will also be triggered in the event of transaction status getting updated, to ensure the merchant is securely informed. Please provide the URL and make sure it's already registered on the Faspay system.
Last updated