> For the complete documentation index, see [llms.txt](https://docs.faspay.co.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.faspay.co.id/merchant-integration/api-reference-1/route-payment/post-data-transaction.md).

# Post Data Transaction

#### 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="99">Type</th><th width="139">Environment</th><th>URL</th></tr></thead><tbody><tr><td>XML</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>JSON</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

The parameter that must be provide by the Merchant system to be accessed by the Faspay system are as follows:

<table><thead><tr><th width="350">Parameter</th><th width="203">Data Type</th><th width="83">M/O/C</th><th width="304">Decription</th></tr></thead><tbody><tr><td><p> </p><p>request</p><p> </p></td><td>Alphanumeric (50)</td><td>M</td><td>Request Description</td></tr><tr><td><p> </p><p>merchant_id</p><p> </p></td><td>Numeric (5)</td><td>M</td><td>Merchant Code From Faspay = BOI</td></tr><tr><td><p> </p><p>merchant</p><p> </p></td><td>Alphanumeric (32)</td><td>M</td><td>Merchant Name</td></tr><tr><td><p> </p><p>bill_no</p><p> </p></td><td>Alphanumeric (32)</td><td>M</td><td>Order Number</td></tr><tr><td><p> </p><p>bill_reff</p><p> </p></td><td>Alphanumeric (32)</td><td>O</td><td>Booking Number/reference (can fill same with order no)</td></tr><tr><td><p> </p><p>bill_date</p><p> </p></td><td>Datetime YYYY-MM-DD HH:MM:SS (19)</td><td>M</td><td>Transaction/ Order Date</td></tr><tr><td><p> </p><p>bill_expired</p><p> </p></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><p> </p><p>bill_desc</p><p> </p></td><td>Alphanumeric (128)</td><td>M</td><td>Transaction Description</td></tr><tr><td><p> </p><p>bill_currency</p><p> </p></td><td>Alphanumeric (3)</td><td>M</td><td>Currency, Must be 'IDR'</td></tr><tr><td><p> </p><p>bill_gross</p><p> </p></td><td>Numeric (15)</td><td>O</td><td>Order Nominal</td></tr><tr><td><p> </p><p>bill_tax</p><p> </p></td><td>Numeric (15)</td><td>O</td><td>Billing tax</td></tr><tr><td><p> </p><p>bill_miscfee</p><p> </p></td><td>Numeric (15)</td><td>O</td><td>Miscellaneous fee</td></tr><tr><td><p> </p><p>bill_total</p><p> </p></td><td>Numeric (15)</td><td>M</td><td>Total Nominal</td></tr><tr><td><p> </p><p>cust_no</p><p> </p></td><td>Alphanumeric (32)</td><td>M</td><td>Customer Number</td></tr><tr><td><p> </p><p>cust_name</p><p> </p></td><td>Alphanumeric (128)</td><td>M</td><td>Customer Name</td></tr><tr><td><p> </p><p>cust_lastname</p><p> </p></td><td>Alphanumeric (128)</td><td>O</td><td>Customer Last name</td></tr><tr><td><p> </p><p>payment_channel</p><p> </p></td><td>Numeric (3)</td><td>M</td><td>Payment channel<br>In details <a href="https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/reference/payment-channel-code#list-of-payment-channel-code">here.</a></td></tr><tr><td><p> </p><p>pay_type</p><p> </p></td><td>Alphanumeric (1)</td><td>M</td><td><p>Payment type :</p><ul><li>1: Full Settlement</li><li>2: Installment</li><li>3: Mixed 1 &#x26; 2</li></ul><p>Pay Type 2 &#x26; 3 only implement on BCA KlikPay channel</p><p> </p></td></tr><tr><td><p> </p><p>bank_userid</p><p> </p></td><td>Alphanumeric (128)</td><td>O</td><td>Customer User ID on bank’s services</td></tr><tr><td><p> </p><p>msisdn</p><p> </p></td><td>Numeric (64)</td><td>M</td><td>Customer Mobile Phone</td></tr><tr><td><p> </p><p>email</p><p> </p></td><td>Alphanumeric (128)</td><td>M</td><td>Customer Email</td></tr><tr><td><p> </p><p>terminal</p><p> </p></td><td>Numeric (16)</td><td>M</td><td>Always use 10 for Terminal</td></tr><tr><td><p> </p><p>billing_name</p><p> </p></td><td>Alphanumeric</td><td>C</td><td>Billing name for OVO</td></tr><tr><td><p> </p><p>billing_lastname</p><p> </p></td><td>Billing name</td><td>O</td><td>biling last name</td></tr><tr><td><p> </p><p>billing_address</p><p> </p></td><td>Alphanumeric (200)</td><td>O</td><td>Billing address</td></tr><tr><td><p> </p><p>billing_address_city</p><p> </p></td><td>Alphanumeric (50)</td><td>O</td><td>Billing City</td></tr><tr><td><p> </p><p>billing_address_region</p><p> </p></td><td>Alphanumeric (100)</td><td>O</td><td>Billing Addres Region</td></tr><tr><td><p> </p><p>billing_address_state</p><p> </p></td><td>Alphanumeric (100)</td><td>O</td><td>Billing Address State</td></tr><tr><td><p> </p><p>billing_address_poscode</p><p> </p></td><td>Alphanumeric (10)</td><td>O</td><td>Billing Address Pos Code</td></tr><tr><td><p> </p><p>billing_msisdn</p><p> </p></td><td>Numeric</td><td>C</td><td>Billing phone number</td></tr><tr><td><p> </p><p>billing_address_country_code</p><p> </p></td><td>Alphanumeric (10)</td><td>O</td><td>Billing Address Country Code</td></tr><tr><td><p> </p><p>receiver_name_for_shipping</p><p> </p></td><td>Alphanumeric (100)</td><td>C</td><td>Receiver Name</td></tr><tr><td><p> </p><p>shipping_lastname</p><p> </p></td><td>Alphanumeric</td><td>O</td><td>Receiver last name</td></tr><tr><td><p> </p><p>shipping_address</p><p> </p></td><td>Alphanumeric (200)</td><td>O</td><td>Shipping Address</td></tr><tr><td><p> </p><p>shipping_address_city</p><p> </p></td><td>Alphanumeric (50)</td><td>O</td><td>Shipping Address City</td></tr><tr><td><p> </p><p>shipping_address_region</p><p> </p></td><td>Alphanumeric (100)</td><td>O</td><td>Shipping Address Region</td></tr><tr><td><p> </p><p>shipping_address_state</p><p> </p></td><td>Alphanumeric (100)</td><td>O</td><td>Shipping Address State</td></tr><tr><td><p> </p><p>shipping_address_poscode</p><p> </p></td><td>Alphanumeric (10)</td><td>O</td><td>Shipping Address Pos Code</td></tr><tr><td><p> </p><p>shipping_msisdn</p><p> </p></td><td>Numeric</td><td>C</td><td>Shipping phone number</td></tr><tr><td><p> </p><p>shipping_address_country_code</p><p> </p></td><td>Alphanumeric (10)</td><td>O</td><td>Shipping Address Country Code</td></tr><tr><td><p> </p><p>item </p><p> </p></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, except Amount</strong></li><li>This parameter is <strong>Mandatory for</strong> payment channel <strong>Akulaku, DanaSubs, Kredivo</strong> and <strong>BRICeria</strong></li></ul></td></tr><tr><td><p> </p><p>        product</p><p> </p></td><td>Alphanumeric (50)</td><td>C</td><td>Item name</td></tr><tr><td><p> </p><p>        qty</p><p> </p></td><td>Numeric (32)</td><td>C</td><td>Item quantity</td></tr><tr><td><p> </p><p>       amount</p><p> </p></td><td>Numeric (15)</td><td>C</td><td>Item Price</td></tr><tr><td><p> </p><p>       tenor</p><p> </p></td><td>Numeric (2)</td><td>C</td><td><p>Installment Tenor</p><ul><li>00: Full Payment</li><li>03: 3 months</li><li>6 months</li><li>12: 12 months</li></ul><p>Tenor 03,06,12 only use on BCA KlikPay channel</p></td></tr><tr><td><p> </p><p>       payment_plan</p><p> </p></td><td>Numeric (1)</td><td>C</td><td><p>Payment plan</p><ul><li>1: Full Settlement</li><li>2: Installement</li></ul><p> </p></td></tr><tr><td><p> </p><p>       merchant_id</p><p> </p></td><td>Numeric (5)</td><td>C</td><td>Merchant Id From Payment Channel ex : MID from BCA KlikPay</td></tr><tr><td><p> </p><p>reserve1</p><p> </p></td><td>Alphanumeric (50)</td><td>O</td><td> </td></tr><tr><td><p> </p><p>reserve2</p><p> </p></td><td>Alphanumeric (50)</td><td>C</td><td> </td></tr><tr><td><p> </p><p>route</p><p> </p></td><td>Object</td><td>O</td><td> </td></tr><tr><td><p> </p><p>        owner</p><p> </p></td><td>Alphanumeric (32) </td><td>O</td><td><p>Registered partner id that owns/generates the transaction. </p><p> </p><p><strong>Notes:</strong></p><ul><li>1 transaction only can contain 1 owner. </li><li>If null, then the remaining transaction amount will belong to the merchant’s Sendme balance. </li></ul></td></tr><tr><td><p> </p><p>       partner_id</p><p> </p></td><td>Alphanumeric (32) </td><td>O</td><td>Merchant partner id number.</td></tr><tr><td><p> </p><p>      partner_amount</p><p> </p></td><td>Numeric (15) </td><td>C</td><td>Disbursement amount to partner.  </td></tr><tr><td><p> </p><p>signature</p><p> </p></td><td>Alphanumeric (100)</td><td>M</td><td><p>sha1(md5(user_id merchant + password merchant + bill_no))</p><ul><li>$signature : sha1(md5(($user_id.$pass.$bill_no)));</li><li>Sample signature: sha1(md5("bot310001p@ssw0rd310001zx")) = e0ba1b2dc29ab4cb4221df092f44b1c4e6f45c63</li></ul></td></tr></tbody></table>

***

### Sample Request

{% tabs %}
{% tab title="Sample Request (JSON)" %}

```json
{
    "request": "Payment Details",
    "merchant_id": "99999",
    "merchant": "FASPAY STORE",
    "bill_no": "9333300199999123456",
    "bill_reff": "Abcd",
    "bill_date": "2024-09-11 10:00:00",
    "bill_expired": "2024-09-12 14:36:32",
    "bill_desc": "Gadget payment",
    "bill_currency": "IDR",
    "bill_gross": "0",
    "bill_tax": "0",
    "bill_miscfee": "0",
    "bill_total": "1000000",
    "cust_no": "1",
    "cust_name": "budi",
    "cust_lastname": "faspay",
    "payment_channel": "402",
    "pay_type": "1",
    "bank_userid": "",
    "msisdn": "08123123123",
    "email": "budi@gmail.com",
    "terminal": "10",
    "billing_name": "faspay",
    "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": "8766688686",
    "billing_address_country_code": "ID",
    "receiver_name_for_shipping": "Faspay",
    "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": "8766688686",
    "shipping_address_country_code": "ID",
    "item":
    [
        {
            "product": "Invoice",
            "qty": 1,
            "amount": 1000000,
            "tenor": 0,
            "payment_plan": 1,
            "merchant_id": "99999"
        }
    ],
    "reserve1": "0",
    "reserve2": "",
    "route":
    [
        {
            "owner": "26100253"
        },
        {
            "partner_id": "29195827",
            "partner_amount": "500000"
        },
        {
            "partner_id": "29200008",
            "partner_amount": "500000"
        }
    ],
    "signature": "ca1ed7300c72b8b14bc503826d0f54db8ed1a8b8"
}

```

{% endtab %}

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

```xml
<?xml version="1.0" encoding="UTF-8" ?>
 <faspay>
     <request>Payment Details</request>
     <merchant_id>99999</merchant_id>
     <merchant>FASPAY STORE</merchant>
     <bill_no>9333300199999123456</bill_no>
     <bill_reff>Abcd</bill_reff>
     <bill_date>2024-09-11 10:00:00</bill_date>
     <bill_expired>2024-09-12 14:36:32</bill_expired>
     <bill_desc>Gadget payment</bill_desc>
     <bill_currency>IDR</bill_currency>
     <bill_gross>0</bill_gross>
     <bill_tax>0</bill_tax>
     <bill_miscfee>0</bill_miscfee>
     <bill_total>1000000</bill_total>
     <cust_no>1</cust_no>
     <cust_name>budi</cust_name>
     <cust_lastname>faspay</cust_lastname>
     <payment_channel>402</payment_channel>
     <pay_type>1</pay_type>
     <bank_userid></bank_userid>
     <msisdn>08123123123</msisdn>
     <email>budi@gmail.com</email>
     <terminal>10</terminal>
     <billing_name>faspay</billing_name>
     <billing_lastname>0</billing_lastname>
     <billing_address>jalan pintu air raya</billing_address>
     <billing_address_city>Jakarta Pusat</billing_address_city>
     <billing_address_region>DKI Jakarta</billing_address_region>
     <billing_address_state>Indonesia</billing_address_state>
     <billing_address_poscode>10710</billing_address_poscode>
     <billing_msisdn>8766688686</billing_msisdn>
     <billing_address_country_code>ID</billing_address_country_code>
     <receiver_name_for_shipping>Faspay</receiver_name_for_shipping>
     <shipping_lastname></shipping_lastname>
     <shipping_address>jalan pintu air raya</shipping_address>
     <shipping_address_city>Jakarta Pusat</shipping_address_city>
     <shipping_address_region>DKI Jakarta</shipping_address_region>
     <shipping_address_state>Indonesia</shipping_address_state>
     <shipping_address_poscode>10710</shipping_address_poscode>
     <shipping_msisdn>8766688686</shipping_msisdn>
     <shipping_address_country_code>ID</shipping_address_country_code>
     <item>
         <product>Invoice</product>
         <qty>1</qty>
         <amount>1000000</amount>
         <tenor>0</tenor>
         <payment_plan>1</payment_plan>
         <merchant_id>99999</merchant_id>
     </item>
     <reserve1>0</reserve1>
     <reserve2></reserve2>
     <route>
         <owner>26100253</owner>
     </route>
     <route>
         <partner_id>29195827</partner_id>
         <partner_amount>500000</partner_amount>
     </route>
     <route>
         <partner_id>29200008</partner_id>
         <partner_amount>500000</partner_amount>
     </route>
     <signature>ca1ed7300c72b8b14bc503826d0f54db8ed1a8b8</signature>
 </faspay>

```

{% endtab %}
{% endtabs %}

## Response Parameter

Response parameters are parameters that will be delivered by Faspay system in response to the request that have been sent by the merchant system. If no parameters appropriate/value are incorrect, the transaction will be rejected in the system Faspay.

<table><thead><tr><th width="299">Parameter</th><th width="155">Data Type</th><th width="85">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><p>Transaction ID (Issued/generated by Faspay)</p><p> </p><p>Notes: Unique Transaction ID for 1 day or if it hasn't been paid and hasn't expired</p></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>external_id</td><td>Alphanumeric (16)</td><td>C</td><td>External id number</td></tr><tr><td>bill_item </td><td>Array of Object</td><td>C</td><td><p>Details item</p><p> </p><p><strong>Notes:</strong></p><ul><li>Variable that contains in this parameter are <strong>customizable, except Amount</strong></li><li>This parameter is <strong>Mandatory 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>C</td><td>Item name</td></tr><tr><td>    qty</td><td>Numeric (32)</td><td>C</td><td>Item quantity</td></tr><tr><td>   amount</td><td>Numeric (15)</td><td>C</td><td>Item Price</td></tr><tr><td>   tenor</td><td>Numeric (2)</td><td>C</td><td><p>Installment Tenor</p><ul><li>00: Full Payment</li><li> 03: 3 months</li><li>06: 6 months</li><li>12: 12 months</li></ul><p>Tenor 03,06,12 only use on BCA KlikPay channel</p></td></tr><tr><td>   payment_plan</td><td>Numeric (1)</td><td>C</td><td><p>Payment plan</p><ul><li> 1: Full Settlement</li><li>2: Installment</li></ul><p> </p></td></tr><tr><td>   merchant_id</td><td>Numeric (5)</td><td>C</td><td><p>Merchant Id From Payment Channel </p><p><strong>example:</strong> MID from BCA KlikPay</p></td></tr><tr><td>response_code</td><td>Numeric (2)</td><td>M</td><td>Response Code. In details <a href="https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/reference/status-response-code">here.</a></td></tr><tr><td>response_desc</td><td>Alphanumeric (32)</td><td>M</td><td>Response Code Description. In details <a href="https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/reference/status-response-code">here.</a></td></tr><tr><td>route</td><td>Object</td><td>O</td><td> </td></tr><tr><td>    owner</td><td>Alphanumeric (32) </td><td>O</td><td><p>Registered partner id that owns/generates the transaction. </p><p> </p><p><strong>Notes:</strong></p><ul><li> 1 transaction only can contain 1 owner. </li><li>If null, then the remaining transaction amount will belong to the merchant’s Sendme balance. </li></ul></td></tr><tr><td>    partner_id</td><td>Alphanumeric (32) </td><td>O</td><td>Merchant partner id number.</td></tr><tr><td>    partner_amount</td><td>Numeric (15) </td><td>C</td><td>Disbursement amount to partner.  </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>

### Sample Response

{% tabs %}
{% tab title="Sample Response (JSON)" %}

```json
{
    "response": "Payment Details",
    "trx_id": "8504999946414145",
    "merchant_id": "99999",
    "merchant": "FASPAY",
    "bill_no": "9333300199999123456",
    "external_id": "",
    "bill_item": [
        {
            "product": "Invoice",
            "qty": 1,
            "amount": 1000000,
            "tenor": 0,
            "payment_plan": 1,
            "merchant_id": "99999"
        }
    ],
    "response_code": "00",
    "response_desc": "Success",
    "route":
    [
        {
            "owner": "26100253"
        },
        {
            "partner_id": "29195827",
            "partner_amount": "500000"
        },
        {
            "partner_id": "29200008",
            "partner_amount": "500000"
        }
    ],
    "redirect_url": "https://debit-staging.faspay.co.id/pws/100003/0830000010100000/ca1ed7300c72b8b14bc503826d0f54db8ed1a8b8?trx_id=8504999946414145&merchant_id=99999&bill_no=9333300199999123456"
}

```

{% endtab %}

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

```xml
<?xml version="1.0" encoding="UTF-8" ?>
 <faspay>
     <response>Payment Details</response>
     <trx_id>8504999946414145</trx_id>
     <merchant_id>99999</merchant_id>
     <merchant>FASPAY</merchant>
     <bill_no>9333300199999123456</bill_no>
     <external_id></external_id>
     <bill_item>
         <product>Invoice</product>
         <qty>1</qty>
         <amount>1000000</amount>
         <tenor>0</tenor>
         <payment_plan>1</payment_plan>
         <merchant_id>99999</merchant_id>
     </bill_item>
     <response_code>00</response_code>
     <response_desc>Sukses</response_desc>
     <route>
         <owner>26100253</owner>
     </route>
     <route>
         <partner_id>29195827</partner_id>
         <partner_amount>500000</partner_amount>
     </route>
     <route>
         <partner_id>29200008</partner_id>
         <partner_amount>500000</partner_amount>
     </route>
     <redirect_url>https://debit-staging.faspay.co.id/pws/100003/0830000010100000/ca1ed7300c72b8b14bc503826d0f54db8ed1a8b8?trx_id=8504999946414145&merchant_id=99999&bill_no=9333300199999123456</redirect_url>
 </faspay>

```

{% endtab %}
{% endtabs %}