BRI Direct Debit

Binding Card Token

This process is card information data from the merchant to Faspay. The post data (binding) process is carried out when the merchant requests parameters and then Faspay will respond to the request.

Environment	URL
Development	https://debit-sandbox.faspay.co.id/pws/bridd/inputNumberPage

Request Binding Card Token

The following are the parameters of the request that must be sent by the merchant system to the Faspay system.

Request Parameter

Parameter	Data Type	M/O/C	Description
passw	Alphanumeric	M	merchant password
boi_uid	Numeric	M	merchant id from Faspay credential
email	Alphanumeric	M	Email customer
signature	Alphanumeric	M	sha1(md5(user_id+password+bill_no))
user_id	Alphanumeric	M	user id that has been registered with Faspay

Sample Request Code

<?php
$user_id = 'bot99999';
$passw = 'p@ssw0rd';
$data =  array
                'boi_uid' => '99999',
                'email' => '[e-mail]'
              );
$signature = sha1(md5($user_id.$passw.json_encode($data)));
$post =  array(
                'boi_uid' => '99999',
                'email' => '[e-mail]',
                'signature' => $signature
              );
$string = '<form method="post" name="form" action="https://web.faspay.co.id/pws/bridd/inputNumberPage">';
if ($post != null) {
         foreach ($post as $name=>$value) {
         $string .= '<input type="hidden" name="'.$name.'" value="'.$value.'">';
    }
}

$string .= '</form>';
$string .= '<script> document.form.submit();</script>';

echo $string;
exit;
?>

Response Binding Card Token

Response parameters are parameters that will be sent by the Faspay system in response to parameter requests that have been sent by the merchant system. If there are parameters that do not match / the value is wrong then the transaction will be rejected by Faspay's system.

Response Parameter

Parameter	Data Type	M/O/C	Description
card_token	Alphanumeric	M	It is a representation of the user / customer's card information that is used to make transactions
cardholder_email	Alphanumeric	M	Email customer
cardholder_phone	Numeric	M	Phone number customer
response_code	Numeric	M	Response code (sample 00 for success)

Sample Response Code

(
   [card_token] => card_.eyJleHAiOjE2Mjk3NjkyMTUsImlhdCI6MTU5ODIzMzIxNSwiaXNzIjoiQmFuayBCUkkgLSBEQ0UiLCJqdGkiOiIyNTRiZDY2MS01MGQ3LTQ2YWUtODczZi05ZDFlYTdjOTBiNzciLCJwYXJ0bmVySWQiOiLvv70iLCJzZXJ2aWNlTmFtZSI6IkREX0VYVEVSTkFMX1NFUlZJQ0UifQ.Lvaz-lPHgiW8GW0VrGdG5BpwW1JZhD171-KulkEpGxLihPLdaBGKy0rRyb2KOeuD0lrTv04kS9Gt-ODaqJKvQYtrdLJ-htmQ8GUsvUn3pxiTUiTw4EOfYcSfRRx7xyyFb1KS2cn_ngvaNwq3HFqExHl6x9rpIba7_yCOx66O8AnaDjIZ8M-3ZBAdHityTb72JIuBbVD7EGfG7gZrm4dXhu9vLi-C2YjM3ItLCRIHpELmfYIXcgYry27OVLpMCzfPibgCiKCB2GJ4YAlSbHgde51zcxDR_h0JYHzF2abSAa41WzH076c1yc_Ygob4wOrfFnLUJOGHbkDrReFCankFYA
   [cardholder_email] => [e-mail]
   [cardholder_phone] => 6281382829999
   [response_code] => 00
)

Unbinding Card Token

This service functions to delete user/customer card information data of BRI bank customers.

Environment	URL
Development	https://debit-sandbox.faspay.co.id/pws/bridd/deletecard

Request Unbinding Card Token

The following are the parameters of the unbinding request that must be sent by the merchant system to the Faspay system.

Request Parameter

Parameter	Data Type	M/O/C	Description
user_id	Alphanumeric	M	user id that has been registered with Faspay
passw	Alphanumeric	M	Merchant password
boi_uid	Numeric	M	Merchant id
card_token	Alphanumeric	M	It is a representation of the user / customer's card information that is used to make transactions
signature	Alphanumeric	M	sha1(md5($user_id+$passw+$bill_no))

Sample Request

<?php
$user_id = 'bot99999';
$passw = 'p@ssw0rd';
$data =  array(
                'boi_uid' => '99999',
                'card_token' => 'card_.eyJleHAiOjE2MjU2MzkwOTUsImlhdCI6MTU5NDEwMzA5NSwiaXNzIjoiQmFuayBCUkkgLSBEQ0UiLCJqdGkiOiJkOTdlYjE5OC0zODA1LTRmNjYtYjNlMi01YTBiYWEyMWRlNzciLCJwYXJ0bmVySWQiOiLvv70iLCJzZXJ2aWNlTmFtZSI6IkREX0VYVEVSTkFMX1NFUlZJQ0UifQ.itwgLHgIPxdVAF25Ttzw6vDGxFrm7Qchj4RgGeP4ZE4bJppPIwNz-zVQNRe7yba5qGt7DflQMvp9JR5YiGRa_vk8wIZxntG-UiI6p_9e7bOny_OcvW_q5RxwyqD0lswyGglejSbeFDmOsSgXrSFgOcaj0kxUuWX5o9B32lcTzeICGrxJhnKsCh40LKvS0YhEJRoSyEJL1MjJbEeencjkbfgL59dD6ez131XgI6k3jqa4IzqQMyefk6AcLuqzzq_DbLeiJjBpilUUSOPxTocsNThEX4vdgXMOp80NVA1EO3Jqca7X1rPssyu6Xp2RdXrZp032E8QrtnYIOYvPjFOApQ'
              );
$signature = sha1(md5($user_id.$passw.json_encode($data)));
$post =  array(
                'boi_uid' => '99999',
                'card_token' => 'card_.eyJleHAiOjE2MjU2MzkwOTUsImlhdCI6MTU5NDEwMzA5NSwiaXNzIjoiQmFuayBCUkkgLSBEQ0UiLCJqdGkiOiJkOTdlYjE5OC0zODA1LTRmNjYtYjNlMi01YTBiYWEyMWRlNzciLCJwYXJ0bmVySWQiOiLvv70iLCJzZXJ2aWNlTmFtZSI6IkREX0VYVEVSTkFMX1NFUlZJQ0UifQ.itwgLHgIPxdVAF25Ttzw6vDGxFrm7Qchj4RgGeP4ZE4bJppPIwNz-zVQNRe7yba5qGt7DflQMvp9JR5YiGRa_vk8wIZxntG-UiI6p_9e7bOny_OcvW_q5RxwyqD0lswyGglejSbeFDmOsSgXrSFgOcaj0kxUuWX5o9B32lcTzeICGrxJhnKsCh40LKvS0YhEJRoSyEJL1MjJbEeencjkbfgL59dD6ez131XgI6k3jqa4IzqQMyefk6AcLuqzzq_DbLeiJjBpilUUSOPxTocsNThEX4vdgXMOp80NVA1EO3Jqca7X1rPssyu6Xp2RdXrZp032E8QrtnYIOYvPjFOApQ',
                'signature' => $signature
              );
              
              $curl_connection = curl_init('https://web.faspay.co.id/pws/bridd/deletecard');
     //set options
      curl_setopt($curl_connection, CURLOPT_CONNECTTIMEOUT, 100);
      curl_setopt($curl_connection, CURLOPT_USERAGENT, 
            'Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.0.3705; .NET CLR 1.1.4322)'); 
      curl_setopt($curl_connection, CURLOPT_RETURNTRANSFER, true); 
      curl_setopt($curl_connection, CURLOPT_SSL_VERIFYPEER, false);
      curl_setopt($curl_connection, CURLOPT_FOLLOWLOCATION, 1); 
      curl_setopt($curl_connection, CURLOPT_COOKIEFILE, "cookie2.txt"); 
      //set data to be posted
      curl_setopt($curl_connection, CURLOPT_POSTFIELDS, http_build_query($post));
     //perform our request
      $result=curl_exec($curl_connection);
     $data= json_decode($result);
      print_r($result);
     curl_close($curl_connection);
?>

Response Unbinding Card Token

Response parameters will be sent by the Faspay system in response to parameter requests that have been sent by the merchant system. If there are parameters that do not match / the value is wrong then the transaction will be rejected by Faspay's system.

Response Parameter

Parameter	Data Type	M/O/C	Description
request_id	Numeric	M	ID request to delete card information
response_code	Alphanumeric	M	Response code
response_desc	Numeric	M	Description of response_code parameter

Sample Response JSON

{
  "request_id":80330411,
  "response_code":"00",
  "response_desc":"Complete Delete Card"
}

Post Data Transaction

This process is used to send transaction data from merchants to Faspay.

URL Endpoint Post Data

This endpoint URL is a return URL that will process the data posted from the merchant system. 2 URLs need to be used, namely Production and Development. For testing or UAT implementation, you can use the development URL.

XML

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

JSON

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

Request Parameter Post Data

The following are the parameters that must be sent by the merchant system to the Faspay system.

XML

<faspay>
    <request> Transmission of Purchase Detail Info </request>
    <merchant_id>99999</merchant_id>
    <merchant>Sophia Store</merchant>
    <bill_no>849389422312</bill_no>
    <bill_reff> schlbg </bill_reff>
    <bill_date>2021-02-11 07:25:00</bill_date>
    <bill_expired>2021-02-28 20:04:10</bill_expired>
    <bill_desc> Payment #12345678</bill_desc>
    <bill_currency>IDR</bill_currency>
    <bill_gross>000</bill_gross>
    <bill_tax>000</bill_tax>
    <bill_miscfee>000</bill_miscfee>
    <bill_total>100000</bill_total>
    <bill_miscdata>card_.eyJleHAiOjE2NDQ0NzI5NDAsImlhdCI6MTYxMjkzNjk0MCwiaXNzIjoiQmFuayBCUkkgLSBEQ0UiLCJqdGkiOiJkMGQ2ZWM4OS1mNzNhLTQzZjItOGE5ZS1kMWIwNThhODA1ZDkiLCJwYXJ0bmVySWQiOiLvv70iLCJzZXJ2aWNlTmFtZSI6IkREX0VYVEVSTkFMX1NFUlZJQ0UifQ.Dp3I8Cl1IcVtPNdHFWAUZpchEnK_8r6SkbDB4XhLyt8Awitq9Hr2MHPsrp6yJG3D9DDrZAnmi2CgRumj7RqNKdAO6jt7zkS4asomy4Bapstd4Y_kMzWkXWMZCLUQJjakKu4mB1IDv89dDV2-thB9QgZkWx7asMCQG-QQO4hSwo6lAEN_cg5PEknI7mbwKCWIzR26QbXfytgH4yYwhdfQcg_HELCCQ1TeMOdfo3QP2qg-RgdkdgMZIkYC3JS_1wDenjduGq-MPRSbBDwhVkUKqvSssQn2iaErR8Q5KM2yYMIVSjaYTSyau9MFwV5Br7t7aLs5ssSyCixolrxa1GHCQg</bill_miscdata>
    <cust_no>1</cust_no>
    <cust_name>John Doe</cust_name>
    <cust_lastname> Doe </cust_lastname>
    <payment_channel>714</payment_channel>
    <pay_type>1</pay_type>
    <bank_userid> </bank_userid>
    <msisdn>081382826301</msisdn>
    <email> [e-mail] </email>
    <terminal>10</terminal>
    <billing_name>John</billing_name>
    <billing_lastname>0</billing_lastname)>
    <billing_address>Kawasan 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_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_msisdn>08766688686</shipping_msisdn>
    <shipping_address_country_code>ID</shipping_address_country_code>
    <item>
        <id>123</id>
    <product> Xiaomi </product>
    <qty>1</qty>
    <amount>100000</amount>
    <payment_plan>1</payment_plan>
    <merchant_id>99999</merchant_id>
    <tenor>00</tenor>
    <type>Smartphone</type>
    <url> http://localhost:8088/kredivo</url>
    <image_url> https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg</image_url>
    </item>
    <item>
    <id>234</id>
    <product> Oppo</product>
    <qty>1</qty>
    <amount>100000</amount>
    <payment_plan>1</payment_plan>
    <merchant_id>99999</merchant_id>
    <tenor>00</tenor>
    <type>Smartphone</type>
    <url> http://localhost:8088/kredivo</url>
    <image_url> https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg</image_url>
    </item>
    <reserve1>0</reserve1 >
    <reserve2 ></reserve1>
    <signature>0d8a326853f3090251fb81b1a56f5c4d5b5f2639</signature>
</faspay>

JSON

{
    "request":" Transmission of Purchase Detail Info ",
    "merchant_id":"99999",
    "merchant":"Sophia Store",
    "bill_no":"849389422312",
    "bill_reff":"schlbg",
    "bill_date":"2021-02-11 07:25:00",
    "bill_expired":"2021-02-28 20:04:10",
    "bill_desc":"Payment #12345678",
    "bill_currency":"IDR",
    "bill_gross":"0",
    "bill_tax":"0",
    "bill_miscfee":"0",
    "bill_total":"100000",
    "bill_miscdata": "card_.eyJleHAiOjE2NDQ0NzI5NDAsImlhdCI6MTYxMjkzNjk0MCwiaXNzIjoiQmFuayBCUkkgLSBEQ0UiLCJqdGkiOiJkMGQ2ZWM4OS1mNzNhLTQzZjItOGE5ZS1kMWIwNThhODA1ZDkiLCJwYXJ0bmVySWQiOiLvv70iLCJzZXJ2aWNlTmFtZSI6IkREX0VYVEVSTkFMX1NFUlZJQ0UifQ.Dp3I8Cl1IcVtPNdHFWAUZpchEnK_8r6SkbDB4XhLyt8Awitq9Hr2MHPsrp6yJG3D9DDrZAnmi2CgRumj7RqNKdAO6jt7zkS4asomy4Bapstd4Y_kMzWkXWMZCLUQJjakKu4mB1IDv89dDV2-thB9QgZkWx7asMCQG-QQO4hSwo6lAEN_cg5PEknI7mbwKCWIzR26QbXfytgH4yYwhdfQcg_HELCCQ1TeMOdfo3QP2qg-RgdkdgMZIkYC3JS_1wDenjduGq-MPRSbBDwhVkUKqvSssQn2iaErR8Q5KM2yYMIVSjaYTSyau9MFwV5Br7t7aLs5ssSyCixolrxa1GHCQg",
    "cust_no":"1",
    "cust_name":"John Doe",
    "cust_lastname":"Doe",
    "payment_channel":"714",
    "pay_type":"1",
    "bank_userid":"",
    "msisdn":"081382829999",
    "email":"[e-mail]",
    "terminal":"10",
    "billing_name":"John",
    "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":" Kawasan industri sentul.jl.olympic raya kav.b8 sentul bogor ",
    "shipping_address_city":"Bogor",
    "shipping_address_region":"Bogor",
    "shipping_address_state":"Jawa Barat",
    "shipping_address_poscode":"16810",
    "shipping_msisdn":"08766688686",
    "shipping_address_country_code":"ID",
    "item":[{   
            "id":"123",
            "product":"Xiaomi",
            "qty":"1",
            "amount":"100000",
            "payment_plan":"01",
            "merchant_id":"99999",
            "tenor":"00",
            "type":"Smartphone",
            "url":"http://localhost:8088/kredivo",
            "image_url":"https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg"
  
    },
    {   
            "id":"234",
            "product":"Oppo",
            "qty":"1",
            "amount":"100000",
            "payment_plan":"01",
            "merchant_id":"99999",
            "tenor":"00",
            "type":"Smartphone",
            "url":"http://localhost:8088/kredivo",
            "image_url":"https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg"
    }],
    "reserve1":"0",
    "reserve2":"",
    "signature":"0d8a326853f3090251fb81b1a56f5c4d5b5f2639"
}

Response Post Data

Response parameters are parameters that will be sent by the Faspay system in response to parameter requests that have been sent by the merchant system. If there are parameters that do not match / the value is wrong then the transaction will be rejected by Faspay's system.

XML

<?xml version="1.0" encoding="UTF-8"?>
<faspay>
    <response>Transmission of Detail Info</response>
    <trx_id>9999971430152848</trx_id>
    <merchant_id>99999</merchant_id> 
    <merchant> Sophia Store </merchant>
    <bill_no>849389422312</bill_no>
    <bill_items>
<id>123</id>
<product> Xiaomi </product>
<qty>1</qty>
<amount>100000</amount>
<payment_plan>1</payment_plan>
<merchant_id>99999</merchant_id>
<tenor>00</tenor>
<type>Smartphone</type>
<url> http://localhost:8088/kredivo</url>
<image_url> https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg</image_url>
    </bill_items>
    <bill_items>
<id>234</id>
<product> Oppo</product>
<qty>1</qty>
<amount>100000</amount>
<payment_plan>1</payment_plan>
<merchant_id>99999</merchant_id>
<tenor>00</tenor>
<type>Smartphone</type>
<url> http://localhost:8088/kredivo</url>
<image_url> https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg</image_url>
    </bill_items>
    <response_code>00</response_code>
    <response_desc>Success</response_desc>
</faspay>

JSON

{
   "response":" Transmission of Purchase Detail Info",
   "trx_id":"9999971430152848",
   "merchant_id":"99999",
   "merchant":"Sophia Store",
   "bill_no":"849389422312",
   "bill_items":[
      {
         "id":"123",
         "product":"Xiaomi",
         "qty":"1",
         "amount":"100000",
         "payment_plan":"01",
         "merchant_id":"99999",
         "tenor":"00",
         "type":"Smartphone",
         "url":"http://localhost:8088/kredivo",
         "image_url":"https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg"
      },
      {
         "id":"234",
         "product":"Oppo",
         "qty":"1",
         "amount":"100000",
         "payment_plan":"01",
         "merchant_id":"99999",
         "tenor":"00",
         "type":"Smartphone",
         "url":"http://localhost:8088/kredivo",
         "image_url":"https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg"
      }
   ],
   "response_code":"00",
   "response_desc":"Success",
   "redirect_url":"https://web.faspay.co.id/pws/100003/2830000010100000/0d8a326853f3090251fb81b1a56f5c4d5b5f2639?trx_id=9999971430152848&merchant_id=99999&bill_no=849389422312"
}

Redirect Process

For the BRI Direct Debit channel redirect process API is basically like any other debit channel, To redirect a customer to the online debit website, use redirect_url that retrieved from Post Data Transaction response (JSON Format)