Post Data Transaction

This process is used to transmit transaction data from a merchant to Faspay. This process is done when the merchant requests get a response from Faspay.

URL Endpoint Post Data

The endpoint URL is a feedback URL that will process the data in the post from the merchant system. For the implementation of the testing, UAT can use URL development.

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

Request Parameter Post Data Transaction

Request parameters are parameters that the merchant system must provide to post the data with system integration Faspay.

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 Refers to here.
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))

Sample XML Request

<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>[e-mail]</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>

Sample JSON Request

{
  "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":"[e-mail]",
  "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

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

Sample XML Response

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

Sample JSON Response

{
    "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"
}