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
Alphanumeric (50)
M
Request Description
merchant_id
Numeric (5)
M
Merchant Code From Faspay = BOI
merchant
Alphanumeric (32)
M
Merchant Name
bill_no
Alphanumeric (32)
M
Order Number
bill_reff
Alphanumeric (32)
O
Booking Number/reference (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
Alphanumeric (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
Total Nominal
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))
<faspay>
<request>Post Data Transaction</request>
<merchant_id>99999</merchant_id>
<merchant>Sophia 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>John Doe</cust_name>
<payment_channel>402</payment_channel>
<pay_type>1</pay_type>
<bank_userid>bot31160</bank_userid>
<msisdn>628122131187</msisdn>
<email>[email protected]</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>John Doe</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":"Sophia Store",
"bill_no":"98765123456789",
"bill_reff":"12345678",
"bill_date":"2020-09-02 10:48:10",
"bill_expired":"2020-09-03 10:48:10",
"bill_desc":"Payment #12345678",
"bill_currency":"IDR",
"bill_gross":"0",
"bill_miscfee":"0",
"bill_total":"1000000",
"cust_no":"12",
"cust_name":"John Doe",
"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":"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":"",
"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("bot310001p@ssw0rd310001zx")) = e0ba1b2dc29ab4cb4221df092f44b1c4e6f45c63
Response Parameter Post Data Transaction
Response
Sample XML Response
Sample JSON 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
Alphanumeric (32)
M
Order No
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
<?xml version="1.0" encoding="UTF-8"?>
<faspay>
<response>Transmission Detail Info</response>
<trx_id>3100440033666278</trx_id>
<merchant_id>31004</merchant_id>
<merchant>Sophia 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": "Sophia Store",
"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": "Success",
"redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/5807a17ccd950904ec0a303725fa8a4b36c89e2f?trx_id=9876530200004184&merchant_id=98765&bill_no=98765123456789"
}