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
​https://web.faspay.co.id/pws/300011/383xx00010100000	​
Development
​https://debit-sandbox.faspay.co.id/pws/300011/183xx00010100000​
​
Environment
URL
Production
​https://web.faspay.co.id/cvr/300011/10​
Development
​https://debit-sandbox.faspay.co.id/cvr/300011/10​
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"
}

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

Payment Channel Inquiry

Redirect Process

Last modified 30d ago

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

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

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