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.

Parameter

Data Type

M/O/C

Description

passw

Alphanumeric

merchant password

boi_uid

Numeric

merchant id from Faspay credential

Alphanumeric

Email customer

signature

Alphanumeric

sha1(md5(user_id+password+bill_no))

user_id

Alphanumeric

user id that has been registered with Faspay

<?php
$user_id = 'bot99999';
$passw = 'p@ssw0rd';
$data =  array
                'boi_uid' => '99999',
                'email' => 'john@gmail.com'
              );
$signature = sha1(md5($user_id.$passw.json_encode($data)));
$post =  array(
                'boi_uid' => '99999',
                'email' => 'john@gmail.com',
                '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.

Parameter

Data Type

M/O/C

Description

card_token

Alphanumeric

It is a representation of the user / customer's card information that is used to make transactions

cardholder_email

Alphanumeric

Email customer

cardholder_phone

Numeric

Phone number customer

response_code

Numeric

Response code (sample 00 for success)

(
   [card_token] => card_.eyJleHAiOjE2Mjk3NjkyMTUsImlhdCI6MTU5ODIzMzIxNSwiaXNzIjoiQmFuayBCUkkgLSBEQ0UiLCJqdGkiOiIyNTRiZDY2MS01MGQ3LTQ2YWUtODczZi05ZDFlYTdjOTBiNzciLCJwYXJ0bmVySWQiOiLvv70iLCJzZXJ2aWNlTmFtZSI6IkREX0VYVEVSTkFMX1NFUlZJQ0UifQ.Lvaz-lPHgiW8GW0VrGdG5BpwW1JZhD171-KulkEpGxLihPLdaBGKy0rRyb2KOeuD0lrTv04kS9Gt-ODaqJKvQYtrdLJ-htmQ8GUsvUn3pxiTUiTw4EOfYcSfRRx7xyyFb1KS2cn_ngvaNwq3HFqExHl6x9rpIba7_yCOx66O8AnaDjIZ8M-3ZBAdHityTb72JIuBbVD7EGfG7gZrm4dXhu9vLi-C2YjM3ItLCRIHpELmfYIXcgYry27OVLpMCzfPibgCiKCB2GJ4YAlSbHgde51zcxDR_h0JYHzF2abSAa41WzH076c1yc_Ygob4wOrfFnLUJOGHbkDrReFCankFYA
   [cardholder_email] => john@gmail.com
   [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.

Parameter

Data Type

M/O/C

Description

user_id

Alphanumeric

user id that has been registered with Faspay

passw

Alphanumeric

Merchant password

boi_uid

Numeric

Merchant id

card_token

Alphanumeric

It is a representation of the user / customer's card information that is used to make transactions

signature

Alphanumeric

sha1(md5($user_id+$passw+$bill_no))

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

Parameter

Data Type

M/O/C

Description

request_id

Numeric

ID request to delete card information

response_code

Alphanumeric

Response code

response_desc

Numeric

Description of response_code parameter

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

Environment

URL

Development

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

Request Parameter Post Data

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

<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> john@gmail.com </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>

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

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

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

PreviousB-secure NextOnline Credit Integration Guide

Last updated 6 months ago