# 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.

<table><thead><tr><th width="114">Type</th><th width="139">Environment</th><th>URL</th></tr></thead><tbody><tr><td><strong>XML</strong></td><td>Development</td><td><a href="https://debit-sandbox.faspay.co.id/pws/300011/183xx00010100000">https://debit-sandbox.faspay.co.id/pws/300011/183xx00010100000</a></td></tr><tr><td><strong>JSON</strong></td><td>Development</td><td><a href="https://debit-sandbox.faspay.co.id/cvr/300011/10">https://debit-sandbox.faspay.co.id/cvr/300011/10</a></td></tr></tbody></table>

**Request Parameter Post Data Transaction**

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

{% tabs %}
{% tab title="Request" %}

<table><thead><tr><th width="312">Parameter</th><th width="174">Data Type</th><th width="87">M/O/C</th><th width="234">Description</th></tr></thead><tbody><tr><td>request</td><td>Alphanumeric (50)</td><td>M</td><td>Request Description</td></tr><tr><td>merchant_id</td><td>Numeric (5)</td><td>M</td><td>Merchant Code From Faspay = BOI</td></tr><tr><td>merchant</td><td>Alphanumeric (32)</td><td>M</td><td>Merchant Name</td></tr><tr><td>bill_no</td><td>Alphanumeric (32)</td><td>M</td><td>Order Number</td></tr><tr><td>bill_reff</td><td>Alphanumeric (32)</td><td>O</td><td>Booking Number/reference (can fill same with order no)</td></tr><tr><td>bill_date</td><td>Datetime YYYY-MM-DD HH:MM:SS (19)</td><td>M</td><td>Transaction/ Order Date</td></tr><tr><td>bill_expired</td><td>Datetime YYYY-MM-DD HH:MM:SS (19)</td><td>M</td><td>Payment Expiring Date (max 30 days)</td></tr><tr><td>bill_desc</td><td>Alphanumeric (128)</td><td>M</td><td>Transaction Description</td></tr><tr><td>bill_currency</td><td>Alphanumeric (3)</td><td>M</td><td>Currency, Must be 'IDR'</td></tr><tr><td>bill_gross</td><td>Numeric (15)</td><td>O</td><td>Order Nominal </td></tr><tr><td>bill_miscfee</td><td>Numeric (15)</td><td>O</td><td>Miscellaneous fee</td></tr><tr><td>bill_total</td><td>Numeric (15)</td><td>M</td><td>Total Nominal</td></tr><tr><td>payment_channel</td><td>Numeric (32)</td><td>M</td><td>Payment Channel Code<br><br>Refers to <a href="https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/reference/payment-channel-code">here</a>.</td></tr><tr><td>pay_type</td><td>Alphanumeric (1)</td><td>M</td><td><p>Payment type : </p><p>1: Full Settlement </p><p>2: Installment  </p><p>3: Mixed 1 &#x26; 2 </p><p>Pay Type 2 &#x26; 3 only implement on BCA KlikPay channel</p></td></tr><tr><td>cust_no</td><td>Alphanumeric (32)</td><td>M</td><td>Customer Number</td></tr><tr><td>cust_name</td><td>Alphanumeric (128)</td><td>M</td><td>Customer Name</td></tr><tr><td>bank_user_id</td><td>Alphanumeric (128)</td><td>O</td><td>Customer User ID on bank’s services (ex : KlikBCA User Id)</td></tr><tr><td>msisdn</td><td>Numeric (64)</td><td>M</td><td>Customer Mobile Phone</td></tr><tr><td>email</td><td>Alphanumeric (128)</td><td>M</td><td>Customer Email</td></tr><tr><td>terminal</td><td>Numeric (16)</td><td>M</td><td>Always use 10 for Terminal</td></tr><tr><td>billing_name</td><td>Alphanumeric</td><td>C</td><td>Billing name  for OVO </td></tr><tr><td>billing_lastname</td><td>Billing name</td><td>O</td><td>biling last name</td></tr><tr><td>billing_address</td><td>Alphanumeric (200)</td><td>O</td><td>billing_address</td></tr><tr><td>billing_address_city</td><td>Alphanumeric (50)</td><td>O</td><td>Billing City</td></tr><tr><td>billing_address_region</td><td>Alphanumeric (100)</td><td>O</td><td>Billing Addres Region</td></tr><tr><td>billing_address_state</td><td>Alphanumeric (100)</td><td>O</td><td>Billing Address State</td></tr><tr><td>billing_address_poscode</td><td>Alphanumeric (10)</td><td>O</td><td>Billing Address Pos Code</td></tr><tr><td>billing_address_country_code</td><td>Alphanumeric (10)</td><td>O</td><td>Billing Address Country Code</td></tr><tr><td>receiver_name_for_shipping</td><td>Alphanumeric (100)</td><td>C</td><td>Receiver Name</td></tr><tr><td>shipping_lastname</td><td>Alphanumeric</td><td>O</td><td>Receiver last name</td></tr><tr><td>shipping_address</td><td>Alphanumeric (200)</td><td>O</td><td>Shipping Address</td></tr><tr><td>shipping_address_city</td><td>Alphanumeric (50)</td><td>O</td><td>Shipping Address City</td></tr><tr><td>shipping_address_region</td><td>Alphanumeric (100)</td><td>O</td><td>Shipping Address Region</td></tr><tr><td>shipping_address_state</td><td>Alphanumeric (100)</td><td>O</td><td>Shipping Address State</td></tr><tr><td>shipping_address_poscode</td><td>Alphanumeric (10)</td><td>O</td><td>Shipping Address Pos Code</td></tr><tr><td>shipping_address_country_code</td><td>Alphanumeric (10)</td><td>O</td><td>Shipping Address Country Code</td></tr><tr><td>shipping_msisdn</td><td>Numeric</td><td>C</td><td>Shipping phone number</td></tr><tr><td>item</td><td>Array of Object</td><td>C</td><td><p>Item details</p><p></p><p><strong>Notes:</strong></p><ul><li>Variable that contains in this parameter are <strong>customizeable</strong>, <strong>except Amount</strong></li><li>This parameter is <strong>Mandatory</strong> <strong>for</strong> payment channel <strong>Akulaku, DanaSubs, Kredivo</strong> and <strong>BRICeria</strong></li></ul></td></tr><tr><td>    product</td><td>Alphanumeric (50)</td><td>M</td><td>Item Name</td></tr><tr><td>    amount</td><td>Numeric</td><td>M</td><td>Item Price</td></tr><tr><td>    qty</td><td>Numeric (32)</td><td>M</td><td>Item Quantity</td></tr><tr><td>    payment_plan</td><td>Numeric (1)</td><td>M</td><td><p>Payment plan </p><p>1: Full Settlement </p><p>2: Installement</p></td></tr><tr><td>    tenor</td><td>Numeric (2)</td><td>M</td><td><p>Installment Tenor </p><p>00: Full Payment </p><p>03: 3 months </p><p>06: 6 months </p><p>12: 12 months </p><p>Tenor 03,06,12 only use on BCA KlikPay channel</p></td></tr><tr><td>    merchant_id</td><td>Numeric (5)</td><td>M</td><td>Merchant Id From Payment Channel ex : MID from BCA KlikPay</td></tr><tr><td>reserve1</td><td>Alphanumeric (50)</td><td>O</td><td></td></tr><tr><td>reserve2</td><td>Alphanumeric (50)</td><td>C</td><td></td></tr><tr><td>signature</td><td>Alphanumeric (100)</td><td>M</td><td>sha1(md5(user_id merchant + password merchant + bill_no))</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample XML Request" %}

```xml
<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>
```

{% endtab %}

{% tab title="Sample JSON Request" %}

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

{% endtab %}
{% endtabs %}

{% hint style="danger" %}

* Writing without separators. **Example:** Rp. 10.000,00 Written 1000000
* **Signature for Post Data :**&#x20;

  $signature = sha1(md5(($user\_id.$pass.$bill\_no)));\
  **Sample signature:** sha1(md5("bot310001p\@ssw0rd310001zx")) = e0ba1b2dc29ab4cb4221df092f44b1c4e6f45c63
  {% endhint %}

**Response Parameter Post Data Transaction**

{% tabs %}
{% tab title="Response" %}

<table><thead><tr><th width="164">Parameter</th><th width="173">Data Type</th><th width="86">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>response</td><td>Alphanumeric (50)</td><td>O</td><td>Response Name</td></tr><tr><td>trx_id</td><td>Numeric (16)</td><td>M</td><td>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</td></tr><tr><td>merchant_id</td><td>Numeric (5)</td><td>M</td><td>Merchant Code</td></tr><tr><td>merchant</td><td>Alphanumeric (32)</td><td>M</td><td>Merchant Name</td></tr><tr><td>bill_no</td><td>Alphanumeric (32)</td><td>M</td><td>Order No</td></tr><tr><td>response_code</td><td>Numeric (2)</td><td>M</td><td>Response Code 00 Success</td></tr><tr><td>response_desc</td><td>Alphanumeric (32)</td><td>M</td><td>Response Code Description</td></tr><tr><td>redirect_url</td><td>Alphanumeric</td><td>O</td><td>the redirect url for the next process, available only on JSON format</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample XML Response" %}

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

{% endtab %}

{% tab title="Sample JSON Response" %}

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

{% endtab %}
{% endtabs %}