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

JSON

Development

Request Parameter Post Data Transaction

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

Parameter

Data Type

M/O/C

Description

request

Alphanumeric (50)

Request Description

merchant_id

Numeric (5)

Merchant Code From Faspay = BOI

merchant

Alphanumeric (32)

Merchant Name

bill_no

Alphanumeric (32)

Order Number

bill_reff

Alphanumeric (32)

Booking Number/reference (can fill same with order no)

bill_date

Datetime YYYY-MM-DD HH:MM:SS (19)

Transaction/ Order Date

bill_expired

Datetime YYYY-MM-DD HH:MM:SS (19)

Payment Expiring Date (max 30 days)

bill_desc

Alphanumeric (128)

Transaction Description

bill_currency

Alphanumeric (3)

Currency, Must be 'IDR'

bill_gross

Numeric (15)

Order Nominal

bill_miscfee

Numeric (15)

Miscellaneous fee

bill_total

Numeric (15)

Total Nominal

payment_channel

Numeric (32)

Payment Channel Code Refers to .

pay_type

Alphanumeric (1)

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)

Customer Number

cust_name

Alphanumeric (128)

Customer Name

bank_user_id

Alphanumeric (128)

Customer User ID on bank’s services (ex : KlikBCA User Id)

msisdn

Numeric (64)

Customer Mobile Phone

Alphanumeric (128)

Customer Email

terminal

Numeric (16)

Always use 10 for Terminal

billing_name

Alphanumeric

Billing name for OVO

billing_lastname

Billing name

biling last name

billing_address

Alphanumeric (200)

billing_address

billing_address_city

Alphanumeric (50)

Billing City

billing_address_region

Alphanumeric (100)

Billing Addres Region

billing_address_state

Alphanumeric (100)

Billing Address State

billing_address_poscode

Alphanumeric (10)

Billing Address Pos Code

billing_address_country_code

Alphanumeric (10)

Billing Address Country Code

receiver_name_for_shipping

Alphanumeric (100)

Receiver Name

shipping_lastname

Alphanumeric

Receiver last name

shipping_address

Alphanumeric (200)

Shipping Address

shipping_address_city

Alphanumeric (50)

Shipping Address City

shipping_address_region

Alphanumeric (100)

Shipping Address Region

shipping_address_state

Alphanumeric (100)

Shipping Address State

shipping_address_poscode

Alphanumeric (10)

Shipping Address Pos Code

shipping_address_country_code

Alphanumeric (10)

Shipping Address Country Code

shipping_msisdn

Numeric

Shipping phone number

item

Array of Object

Item details

Notes:

Variable that contains in this parameter are customizeable, except Amount
This parameter is Mandatory for payment channel Akulaku, DanaSubs, Kredivo and BRICeria

product

Alphanumeric (50)

Item Name

amount

Numeric

Item Price

qty

Numeric (32)

Item Quantity

payment_plan

Numeric (1)

Payment plan

1: Full Settlement

2: Installement

tenor

Numeric (2)

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)

Merchant Id From Payment Channel ex : MID from BCA KlikPay

reserve1

Alphanumeric (50)

reserve2

Alphanumeric (50)

signature

Alphanumeric (100)

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>john@gmail.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>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":"john@gmail.com",
  "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

Parameter

Data Type

M/O/C

Description

response

Alphanumeric (50)

Response Name

trx_id

Numeric (16)

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)

Merchant Code

merchant

Alphanumeric (32)

Merchant Name

bill_no

Alphanumeric (32)

Order No

response_code

Numeric (2)

Response Code 00 Success

response_desc

Alphanumeric (32)

Response Code Description

redirect_url

Alphanumeric

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

PreviousPayment Channel Inquiry NextRedirect Process

Last updated 1 month ago