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

XML

Environment	URL
Development	https://debit-sandbox.faspay.co.id/pws/300011/183xx00010100000

JSON

Environment	URL
Development	https://debit-sandbox.faspay.co.id/cvr/300011/10

Method: HTTP POST

Request Parameter POST Data

Request

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
email	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)

Sample XML Request

<faspay>    
    <request>Post Data Transaction</request>
    <merchant_id>99999</merchant_id>
    <merchant>Sophia Store</merchant>
    <bill_no>9881236312345697</bill_no>
    <bill_reff>9881236312345697</bill_reff>
    <bill_date>2021-10-28 00:19:00</bill_date>
    <bill_expired>2021-10-29 00:19:00</bill_expired>
    <bill_desc>BNI Virtual Account Method</bill_desc>
    <bill_currency>IDR</bill_currency>
    <bill_gross>0</bill_gross>
    <bill_tax>0</bill_tax>
    <bill_miscfee>0</bill_miscfee>
    <bill_total>1000000</bill_total>
    <cust_no>5002</cust_no>
    <cust_name>John Doe</cust_name>
    <cust_lastname>Doe/cust_lastname>
    <payment_channel>801</payment_channel>
    <pay_type>1</pay_type>
    <bank_userid/>
    <msisdn/>
    <email>[e-mail]</email>
    <terminal>10</terminal>
    <billing_name>John Doe</billing_name>
    <billing_lastname>Doe</billing_lastname>
    <billing_address>jalan pintu air raya</billing_address>
    <billing_address_city>Jakarta Pusat</billing_address_city>
    <billing_address_region>DKI Jakarta</billing_address_region>
    <billing_address_state>Indonesia</billing_address_state>
    <billing_address_poscode>10710</billing_address_poscode>
    <billing_msisdn>0856123456789</billing_msisdn>
    <billing_address_country_code>ID</billing_address_country_code>
    <receiver_name_for_shipping>John Doe</receiver_name_for_shipping>
    <shipping_lastname>Doe</shipping_lastname>
    <shipping_address>jalan pintu air raya</shipping_address>
    <shipping_address_city>Jakarta Pusat</shipping_address_city>
    <shipping_address_region>DKI Jakarta</shipping_address_region>
    <shipping_address_state></shipping_address_state>
    <shipping_address_poscode>10710</shipping_address_poscode>
    <shipping_msisdn>0856123456789</shipping_msisdn>
    <shipping_address_country_code>ID</shipping_address_country_code>
    <item>
        <qty>8</qty>
        <amount>500000</amount>
        <type>Smartphone</type>
    </item>
    <item>
        <qty>1</qty>
        <amount>500000</amount>
        <type>Smartphone</type>
    </item>
    <reserve1/>
    <reserve2/>
    <signature>d848063d9836c20cf0055d70bd7e862e5f991688</signature>
</faspay>

Sample JSON Request

{
  "request": "Post Data Transaction",
  "merchant_id": 99999,
  "merchant": "Sophia Store",
  "bill_no": "9881236312345696",
  "bill_reff": "9881236312345696",
  "bill_date": "2021-10-28 00:19:00",
  "bill_expired": "2021-10-29 00:19:00",
  "bill_desc": "BNI Virtual Account Method",
  "bill_currency": "IDR",
  "bill_gross": "0",
  "bill_tax": "0",
  "bill_miscfee": "0",
  "bill_total": 1000000,
  "cust_no": "5002",
  "cust_name": "John Doe",
  "cust_lastname": "Doe",
  "payment_channel": "801",
  "pay_type": "1",
  "bank_userid": "",
  "msisdn": ""
  "email": "[e-mail]",
  "terminal": "10",
  "billing_name": "John Doe",
  "billing_lastname": "Doe",
  "billing_address": "jalan pintu air raya",
  "billing_address_city": "Jakarta Pusat",
  "billing_address_region": "DKI Jakarta"
   "billing_address_state": "Indonesia",
  "billing_address_poscode": "10710",
  "billing_msisdn": "856123456789",
  "billing_address_country_code": "ID",
  "receiver_name_for_shipping": "Andreas Wira",
  "shipping_lastname": "Wira",
  "shipping_address": "jalan pintu air raya",
  "shipping_address_city": "Jakarta Pusat",
  "shipping_address_region": "DKI Jakarta",
  "shipping_address_state": "",
  "shipping_address_poscode": "10710",
  "shipping_msisdn": "856123456789",
  "shipping_address_country_code": "ID"
  "item": [
    {
     "qty": "8",
     "amount": "500000",
      "type": "Smartphone"
    },
    {		     
      "qty": "1",
      "amount": "500000",
      "type": "Smartphone"
    }
  ],
  "reserve1": "",
  "reserve2": "",
  "signature": "d848063d9836c20cf0055d70bd7e862e5f991688"
},
}

Response Parameter POST Data

Response

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

Sample XML Response

<?xml version="1.0" encoding="UTF-8"?>
<faspay>
	<response>Transmission of Purchase Detail Info </response>
	<trx_id>1635384937045906</trx_id>
	<merchant_id>99999</merchant_id>
	<merchant>Sophia Store</merchant>
	<bill_no>9881236312345697</bill_no>
	<bill_items>
		<id>101</id>
		<qty>8</qty>
		<amount>500000</amount>
		<type>Smartphone</type>
	</bill_items>
	<bill_items>
		<id>102</id>
		<qty>1</qty>
		<amount>500000</amount>
		<type>Smartphone</type>
	</bill_items>
	<response_code>00</response_code>
	<response_desc>Success</response_desc>
</faspay>

Sample JSON reponse

{
  "response": "Transmission of Purchase Detail Info ",
  "trx_id": 1635384937045906,
  "merchant_id": 99999,
  "merchant": "Sophia Store",
  "bill_no": 9881236312345696,
  "bill_items": [
    {
    	 "qty": 8,
   	  "amount": 500000,
    	  "type": "Smartphone"
    },
    {
    	  "qty": 1,
    	  "amount": 500000,
     	 "type": "Smartphone"
    }
  ],
  "response_code": 00,
  "response_desc": "Success"
}

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

XML

Environment	URL
Development	https://debit-sandbox.faspay.co.id/pws/100004/183xx00010100000

JSON

Environment	URL
Development	https://debit-sandbox.faspay.co.id/cvr/100004/10

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

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))

Sample XML Request

<faspay>
<request>Inquiry Status Payment</request>
<trx_id>1634624112045887</trx_id>
<bill_no>9881236312345694</bill_no>
<merchant_id>99999</merchant_id>
<signature>c71c38790836479377713395117bbc9e70dadd17</signature>
</faspay>

Sample JSON Request

{
"request": "Inquiry Status Payment",
"trx_id": "1634624112045887",
"bill_no": "9881236312345694",
"merchant_id": "99999",
"signature": "c71c38790836479377713395117bbc9e70dadd17"
}

Inquiry Payment Status Response

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		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

Sample XML Response

<?xml version="1.0" encoding="UTF-8"?>
<faspay>
	<response>Inquiry Payment Status</response>
	<merchant_id>99999</merchant_id>
	<merchant>Sophia Store</merchant>
	<bill_no>9881236312345600</bill_no>
	<transaction>
		<transaction_1>
			<trx_id>1634091930000913</trx_id>
			<payment_reff>377798</payment_reff>
			<payment_date>2021-10-13 09:26:16</payment_date>
			<payment_status_code>2</payment_status_code>
			<payment_status_desc>Payment Success</payment_status_desc>
		</transaction_1>
		<transaction_2>
			<trx_id>1634091930000914</trx_id>
			<payment_reff>715524</payment_reff>
			<payment_date>2021-10-13 16:08:31</payment_date>
			<payment_status_code>8</payment_status_code>
			<payment_status_desc>Payment Cancelled</payment_status_desc>
		</transaction_2>
	</transaction>
	<response_code>00</response_code>
	<response_desc>Success</response_desc>
</faspay>

Sample JSON Response

{
  "faspay": {
    "response": "Inquiry Payment Status",
    "merchant_id": 99999,
    "merchant": "Sophia Store",
    "bill_no": 9881236312345600,
    "transaction": {
      "transaction_1": {
        "trx_id": 1634091930000913,
        "payment_reff": 377798,
        "payment_date": "2021-10-13 09:26:16",
        "payment_status_code": 2,
        "payment_status_desc": "Payment Success"
      },
      "transaction_2": {
        "trx_id": 1634091930000914,
        "payment_reff": 715524,
        "payment_date": "2021-10-13 16:08:31",
        "payment_status_code": 8,
        "payment_status_desc": "Payment Cancelled"
      }
    },
    "response_code": 0,
    "response_desc": "Success"
  }
}

Update Transaction

This service aims to update static transactions, transaction updates can be done before or after making payments.

Endpoint URL Inquiry Update Transaction

XML

Environment	URL
Development	https://debit-sandbox.faspay.co.id/pws/100036/183xx00010100000

JSON

Environment	URL
Development	https://debit-sandbox.faspay.co.id/cvr/100036/10

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

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))

Sample XML request

<faspay>
<request>Update Transaction BNI VA Static</request>
<bill_no>9881236398989898</bill_no>
<merchant_id>99999</merchant_id>
<bill_total>1000000</bill_total>
<cust_name>John Doe</cust_name>
<bill_expired>2021-10-31 15:04:10</bill_expired>
<signature>1ac4d5a611ec5376d8da43bbe33aaea1719076b6</signature>
</faspay>

Sample JSON Request

{
  "request": "Update Transaction BNI VA Static",
  "bill_no": 9881236398989898,
  "merchant_id": 99999,
  "bill_total": 1000000,
  "cust_name": "John Doe",
  "bill_expired": "2021-10-31 15:04:10",
  "signature": "1ac4d5a611ec5376d8da43bbe33aaea1719076b6"
}

Update Transaction Response

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)

Sample XML Response

<?xml version="1.0" encoding="UTF-8"?>
<faspay>
    <response_code>00</response_code>
    <response_desc>Successfully updated transaction</response_desc>
    <bill_no>9881236312345697</bill_no>
</faspay>

Sample JSON response

{
  "response_code": “00”,
  "response_desc": "Successfully updated transaction",
  "bill_no": “9881236312345696”
}

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.

The detailed API reference can be found here