BNC VA Static Integration

API Service

POST Data Static Transaction

POST data service in the static transaction is the same as dynamic Post-Data. However, there are differences in bill_no parameter.

If the static transaction, Faspay will generate a Virtual Account number when sending POST data to the BNC System.

EndPoint URL Post-Data

Type	Development
XML	https://debit-sandbox.faspay.co.id/pws/300011/183xx00010100000
JSON	https://debit-sandbox.faspay.co.id/cvr/300011/10

Static Transaction Request

Request Parameter

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 (19)	M	VA format: Prefix from Faspay (11 digits) + free digits (8 digits)
bill_reff	Alphanumeric (32)	O	Booking Number/reference (can fill same with order no)
bill_date	Datetime YYYY-MM-DD HH:MM:SS	M	Transaction/ Order Date
bill_expired	Datetime YYYY-MM-DD HH:MM:SS	M	Payment Expiring Date (max 30 days)
bill_desc	Alphanumeric (128)	M	Transaction Description
bill_currency	Char (3)	M	Currency, Must be 'IDR'
bill_gross	Numeric (15)	O	Order Nominal without tax
bill_tax	Numeric (15)	O	Tax (IDR)
bill_miscfee	Numeric (15)	O	Miscellaneous fee
bill_total	Numeric (15)	M	Total Nominal. If transaction is Open Amount, will be set to 0
cust_no	Alphanumeric (32)	M	Customer Number
cust_name	Alphanumeric (128)	M	Customer Name
cust_lastname	Alphanumeric (128)	M	Customer Last Name
payment_channel	Numeric (3)	M	Payment Channel Code
pay_type	Alphanumeric (1)	M	Payment code: 1: Full Settlement 2: Installment 3: Mixed 1 & 2
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	Email
terminal	Numeric (2)	M	Terminal Origin 10. Web 20. MobApp Blackberry 21. MobApp Android 22. MobAppiOS 23. MobApp Windows 24. MobApp Symbian 30. TabApp BlackBerry 31. TabApp Android 32. TabAppiOS 33. TabApp Windows
billing_name	Alphanumeric	C	Billing name
billing_lastname	Alphanumeric	C	Billing 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_msisdn	Alphanumeric (10)	O	Billing number phone
billing_address_country_code	Alphanumeric (10)	O	Billing Address Country Code
receiver_name_for_shipping	Alphanumeric (100)	O	Receiver Name
shipping_lastname	Alphanumeric (100)	O	Shipping 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_msisdn	Numeric	O	Shipping number phone
shipping_address_country_code	Alphanumeric (10)	O	Shipping Address Country Code
reserve1	Alphanumeric (50)	O
reserve2	Alphanumeric (50)	C
signature	Alphanumeric (100)	M	sha1(md5(user_id merchant + password merchant + bill_no))

Sample Code XML Request

<faspay>
  <request>Transmission of Purchase Detail Info</request>
  <merchant_id>99999</merchant_id>
  <merchant>Sophia Store</merchant>
  <bill_no>9022222298758909234</bill_no>
  <bill_reff>fspytrx</bill_reff>
  <bill_date>2022-07-01 10:00:00</bill_date>
  <bill_expired>2022-07-21 06:04:10</bill_expired>
  <bill_desc>Payment #12345678</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>1</cust_no>
  <cust_name>John Doe</cust_name>
  <cust_lastname>Doe</cust_lastname>
  <payment_channel>718</payment_channel>
  <pay_type>1</pay_type>
  <bank_userid></bank_userid>
  <msisdn></msisdn>
  <email></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>08766688686</billing_msisdn>
  <billing_address_country_code>ID</billing_address_country_code>
  <receiver_name_for_shipping>John Doe</receiver_name_for_shipping>
  <shipping_lastname></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>Indonesia</shipping_address_state>
  <shipping_address_poscode>10710</shipping_address_poscode>
  <shipping_msisdn>08766688686</shipping_msisdn>
  <shipping_address_country_code>ID</shipping_address_country_code>
  <reserve1>0</reserve1>
  <reserve2></reserve2>
  <signature>053c77aa2341feb7df385b0efdde1e7a42a5a238</signature>
</faspay>

Sample Code JSON Request

{
   "faspay": {
      "request": "Transmission of Purchase Detail Info",
      "merchant_id": "99999",
      "merchant": "Sophia Store",
      "bill_no": "9022222298758909234",
      "bill_reff": "fspytrx",
      "bill_date": "2022-07-01 10:00:00",
      "bill_expired": "2022-07-21 06:04:10",
      "bill_desc": "Payment #12345678",
      "bill_currency": "IDR",
      "bill_gross": "0",
      "bill_tax": "0",
      "bill_miscfee": "0",
      "bill_total": "1000000",
      "cust_no": "1",
      "cust_name": "John Doe",
      "cust_lastname": "Doe",
      "payment_channel": "718",
      "pay_type": "1",
      "bank_userid": "",
      "msisdn": "",
      "email": "",
      "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": "08766688686",
      "billing_address_country_code": "ID",
      "receiver_name_for_shipping": "John Doe",
      "shipping_lastname": "",
      "shipping_address": "jalan pintu air raya",
      "shipping_address_city": "Jakarta Pusat",
      "shipping_address_region": "DKI Jakarta",
      "shipping_address_state": "Indonesia",
      "shipping_address_poscode": "10710",
      "shipping_msisdn": "08766688686",
      "shipping_address_country_code": "ID",
      "reserve1": "0",
      "reserve2": "",
      "signature": "053c77aa2341feb7df385b0efdde1e7a42a5a238"
   }
}

Static Transaction Response

Response Parameter

Parameter	Data Type	M/O/C	Description
response	Alphanumeric (50)	O	Response description
trx_id	Numeric (16)	M	Transaction ID (generated by Faspay)
merchant_id	Numeric (5)	M	Merchant Code From Faspay = BOI
merchant	Alphanumeric (32)	M	Merchant’s name
bill_no	Numeric (19)	M	Virtual account number
bill_items	Object	O	Billing items / purchase items
product	Alphanumeric (50)	M	Item Name
amount	Numeric	M	Item Price
qty	Numeric	M	Item Quantity
response_code	Numeric (2)	M	Response code 00 : Success 01 : Failed
response_desc	Alphanumeric (32)	M	Response decription of code
redirect_url	Alphanumeric	M	Direct to BNC's Payment Page

Sample Code XML Response

<faspay>
	<response>Transmission of Purchase Detail Info</response>
	<trx_id>9999971887488335</trx_id>
	<merchant_id>99999</merchant_id>
	<merchant>Sophia Store</merchant>
	<bill_no>9022222298758909234</bill_no>
	<bill_items></bill_items>
	<response_code>00</response_code>
	<response_desc> Success</response_desc>
</faspay>

Sample Code JSON Response

{
    "response": "Transmission of Purchase Detail Info",
    "trx_id": "9999971887488335",
    "merchant_id": "99999",
    "merchant": "Sophia Store",
    "bill_no": "9022222298758909234",
    "bill_items": [
        {
            "product": "Cooking Oil",
            "amount": "5000000",
            "qty": "1"
        },

        {
            "product": "Children's Books",
            "amount": "5000000",
            "qty": "1"
        }
    ],
    "response_code": "00",
    "response_desc": "Success",
    "redirect_url": "https://debit-dev.faspay.co.id/pws/100003/0830000010100000/09b2a8ed8e6bfe936cd24e69c12f675779ea240d?trx_id=9999972133133756&merchant_id=99999&bill_no=84938942"
}