Faspay
Search
⌃K

Post Data Transaction

This process is used to look transmit transaction data from a merchant to Faspay. Post process the data is done when the merchant request parameters and then Faspay will respond to the request.
URL Endpoint Post Data
Endpoint URL is used as a feedback URL that will process the data in the post from the merchant system. There are two URLs that needs to be used, namely Production and Development. For the implementation of the testing or UAT can use the URL development.
Request Parameter Post-Data Transaction
Request parameters are parameters that must be provided by the merchant system to be able to post the data with system integration Faspay.
Request
Sample XML Request
Sample JSON Request
Parameter
Data Type
M/O/C
Description
Request
Alfanumeric (50)
M
Request Description
Merchant_id
Numeric (5)
M
Merchant Code From Faspay = BOI
Merchant
Alfanumeric (32)
M
Merchant Name
bill_no
Alfanumeric (32)
M
Order Number
bill_reff
Alfanumeric (32)
O
Booking Number/reffrence (can fill same with order no)
bill_date
Datetime YYYY-MM-DD HH:MM:SS (19)
M
Transaction/ Order Date
bill_expired
Datetime YYYY-MM-DD HH:MM:SS (19)
M
Payment Expiring Date (max 30 days)
bill_desc
Alfanumeric (128)
M
Transaction Description
bill_currency
Alfanumeric (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
Total Nominal
payment_channel
Numeric (32)
M
Payment Channel Code
pay_type
Alfanumeric (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
Alfanumeric (32)
M
Customer Number
cust_name
Alfanumeric (128)
M
Customer Name
bank_user_id
Alfanumeric (128)
O
Customer User ID on bank’s services (ex : KlikBCA User Id)
Msisdn
Numeric (64)
M
Customer Mobile Phone
Email
Alfanumeric (128)
M
Customer Email
Terminal
Numeric (16)
M
Always use 10 for Terminal
billing_name
Alfanumeric
C
Billing name for OVO
billing_lastname
Billing name
O
biling last name
billing_address
Alfanumeric (200)
O
billing_address
billing_address_city
Alfanumeric (50)
O
Billing City
billing_address_region
Alfanumeric (100)
O
Billing Addres Region
billing_address_state
Alfanumeric (100)
O
Billing Address State
billing_address_poscode
Alfanumeric (10)
O
Billing Address Pos Code
billing_address_country_code
Alfanumeric (10)
O
Billing Address Country Code
receiver_name_for_shipping
Alfanumeric (100)
C
Receiver Name
shipping_lastname
Alfanumeric
O
Receiver last name
shipping_address
Alfanumeric (200)
O
Shipping Address
shipping_address_city
Alfanumeric (50)
O
Shipping Address City
shipping_address_region
Alfanumeric (100)
O
Shipping Address Region
shipping_address_state
Alfanumeric (100)
O
Shipping Address State
shipping_address_poscode
Alfanumeric (10)
O
Shipping Address Pos Code
shipping_address_country_code
Alfanumeric (10)
O
Shipping Address Country Code
shipping_msisdn
Numeric
C
Shipping phone number
Product
Alfanumeric (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
Alfanumeric (50)
O
Reserve2
Alfanumeric (50)
C
Signature
Alfanumeric (100)
M
sha1(md5(user_id merchant + password merchant + bill_no))
<faspay>
<request>Post Data Transaction</request>
<merchant_id>99999</merchant_id>
<merchant>STORE</merchant>
<bill_no>647998170894149</bill_no>
<bill_reff>647998170894149</bill_reff>
<bill_date>2020/9/02 11:25:53 AM</bill_date>
<bill_expired>2017/9/02 3:25:53 PM</bill_expired>
<bill_desc>MIYAKO Stand Water Dispenser - Red Black (Merchant)</bill_desc>
<bill_currency>IDR</bill_currency>
<bill_gross>000</bill_gross>
<bill_tax>000</bill_tax>
<bill_miscfee>000</bill_miscfee>
<bill_total>75600000</bill_total>
<cust_no>USR170709275</cust_no>
<cust_name>Nur Auliya</cust_name>
<payment_channel>402</payment_channel>
<pay_type>1</pay_type>
<bank_userid>bot31160</bank_userid>
<msisdn>628122131187</msisdn>
<email>[email protected].com</email>
<terminal>10</terminal>
<billing_address>Kawasan industri sentul.jl.olympic raya kav.b8 sentul bogor</billing_address>
<billing_address_city>Bogor</billing_address_city>
<billing_address_region>Bogor</billing_address_region>
<billing_address_state>Jawa Barat</billing_address_state>
<billing_address_poscode>16810</billing_address_poscode>
<billing_address_country_code>ID</billing_address_country_code>
<receiver_name_for_shipping>Nur Auliya</receiver_name_for_shipping>
<shipping_address>Kawasan industri sentul.jl.olympic raya kav.b8 sentul bogor</shipping_address>
<shipping_address_city>Bogor</shipping_address_city>
<shipping_address_region>Bogor</shipping_address_region>
<shipping_address_state>Jawa Barat</shipping_address_state>
<shipping_address_poscode>16810</shipping_address_poscode>
<shipping_address_country_code>ID</shipping_address_country_code>
<item>
<product>MIYAKO Stand Water D</product>
<amount>54900000</amount>
<qty>1</qty>
<payment_plan>1</payment_plan>
<tenor>00</tenor>
<merchant_id />
</item>
<item>
<product>Shipping Cost</product>
<amount>20700000</amount>
<qty>1</qty>
<payment_plan>1</payment_plan>
<tenor>00</tenor>
<merchant_id />
</item>
<reserve1 />
<reserve2 />
<signature>be8791ac5f10bb042834896598bfc6bb9aadcbf9</signature>
</faspay>
{
"request":"Post Data Transaction",
"merchant_id":"98765",
"merchant":"FASPAY",
"bill_no":"98765123456789",
"bill_reff":"12345678",
"bill_date":"2020-09-02 10:48:10",
"bill_expired":"2020-09-03 10:48:10",
"bill_desc":"Pembayaran #12345678",
"bill_currency":"IDR",
"bill_gross":"0",
"bill_miscfee":"0",
"bill_total":"1000000",
"cust_no":"12",
"cust_name":"Nur Auliya",
"payment_channel":"302",
"pay_type":"1",
"bank_userid":"",
"msisdn":"628122131187",
"email":"[email protected]",
"terminal":"10",
"billing_name":"0",
"billing_lastname":"0",
"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":"",
"billing_address_country_code":"ID",
"receiver_name_for_shipping":"Nur Auliya",
"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":"",
"shipping_address_country_code":"ID",
"item":[
{
"product":"Invoice No. inv-985/2017-03/1234567891",
"qty":"1",
"amount":"1000000",
"payment_plan":"01",
"merchant_id":"99999",
"tenor":"00"
}
],
"reserve1":"",
"reserve2":"",
"signature":"5807a17ccd950904ec0a303725fa8a4b36c89e2f"
}
  • Writing without separators. Example: Rp. 10.000,00 Written 1000000
  • Signature for Post Data : $signature = sha1(md5(($user_id.$pass.$bill_no))); Sample signature: sha1(md5("[email protected]")) = e0ba1b2dc29ab4cb4221df092f44b1c4e6f45c63
Response Parameter Post Data Transaction
Response
Sample XML Response
Sample JSON Response
Parameter
Data Type
M/O/C
Description
Response
Alfanumeric (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
Alfanumeric (32)
M
Merchant Name
bill_no
Alfanumeric (32)
M
Order No
Response_Code
Numeric (2)
M
Response Code 00 Success
Response_Desc
Alfanumeric (32)
M
Response Code Description
redirect_url
Alfanumeric
O
the redirect url for the next process, available only on JSON format
<?xml version="1.0" encoding="UTF-8"?>
<faspay>
<response>Transmission Detail Info</response>
<trx_id>3100440033666278</trx_id>
<merchant_id>31004</merchant_id>
<merchant>STORE</merchant>
<bill_no>31004001</bill_no>
<bill_items>
<product>Storybook</product>
<qty>2</qty>
<amount>2000000</amount>
<payment_plan>01</payment_plan>
<merchant_id/>
<tenor>00</tenor>
</bill_items>
<bill_items>
<product>Drawingbook</product>
<qty>1</qty>
<amount>1000000</amount>
<payment_plan>02</payment_plan>
<tenor>03</tenor>
<merchant_id/> </bill_items>
<bill_items>
<product>Notebooks</product>
<qty>4</qty>
<amount>1500000</amount>
<payment_plan>01</payment_plan>
<tenor>06</tenor>
<merchant_id/>
</bill_items>
<response_code>00</response_code>
<response_desc>Success</response_desc>
</faspay>
{
"response": "Transmission Detail Info",
"trx_id": "9876530200004184",
"merchant_id": "98765",
"merchant": "Faspay sandbox",
"bill_no": "98765123456789",
"bill_items": [
{
"product": "Invoice No. inv-985/2017-03/1234567891",
"qty": "1",
"amount": "1000000",
"payment_plan": "01",
"merchant_id": "99999",
"tenor": "00"
}
],
"response_code": "00",
"response_desc": "Sukses",
"redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/5807a17ccd950904ec0a303725fa8a4b36c89e2f?trx_id=9876530200004184&merchant_id=98765&bill_no=98765123456789"
}