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.
XML
JSON
Environment | URL |
---|---|
Production | |
Development |
Environment | URL |
Production | |
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"
}
Last modified 30d ago