Sakuku Integration Guide

One of the e-money payment methods offered by Faspay is BCA Sakuku. By using this payment method, customers can pay via e-money website and Faspay will send real-time notifications when the customer completes the payment.

The basic integration process of BCA Sakuku will be explained below.

Integration Step

1. Post Data Transaction to Faspay

2. Redirect customer to Sakuku's website

3. Callback/Return URL

4. Payment Notification

1. Post Data Transaction

Post data transactions should be initiated from the merchant's backend. You can find detailed API references Here

This is an example of post data transaction for Sakuku channel

A. Post Data Transaction Request

Sample Code - XML

<?xml version="1.0" encoding="UTF-8" ?>
<faspay>
    <request>Post Data Transaction</request>
    <merchant_id>99999</merchant_id>
    <merchant>Sophia Store</merchant>
    <bill_no>20201222024113</bill_no>
    <bill_reff>20200324_02-2286704_336</bill_reff>
    <bill_date>2020-12-19 06:04:29</bill_date>
    <bill_expired>2020-12-19 07:04:29</bill_expired>
    <bill_desc>Payment Online Via Faspay</bill_desc>
    <bill_currency>IDR</bill_currency>
    <bill_gross>100000</bill_gross>
    <bill_miscfee>100000</bill_miscfee>
    <bill_total>200000</bill_total>
    <cust_no>01</cust_no>
    <cust_name>John Doe</cust_name>
    <payment_channel>704</payment_channel>
    <pay_type>01</pay_type>
    <msisdn>8562927907</msisdn>
    <email>[e-mail]</email>
    <terminal>10</terminal>
    <billing_address>Jl Sabang 37</billing_address>
    <billing_address_city>Jakarta</billing_address_city>
    <billing_address_region>DKI Jakarta</billing_address_region>
    <billing_address_state>Indonesia</billing_address_state>
    <billing_address_poscode>10170</billing_address_poscode>
    <billing_address_country_code>ID</billing_address_country_code>
    <receiver_name_for_shipping>John Doe</receiver_name_for_shipping>
    <shipping_address>Jl. Sabang 37</shipping_address>
    <shipping_address_city>Jakarta</shipping_address_city>
    <shipping_address_region>DKI Jakarta</shipping_address_region>
    <shipping_address_state>Indonesia</shipping_address_state>
    <shipping_address_poscode>10170</shipping_address_poscode>
    <item>
	<id>A001</id>
	<product>Invoice #2286704</product>
	<qty>1</qty>
	<amount>100000</amount>
	<payment_plan>01</payment_plan>
	<merchant_id>99999</merchant_id>
	<tenor>00</tenor>
    </item>
    <reserve1></reserve1>
    <reserve2></reserve2>
    <signature>d0ef313cc0f20a5d64d01fd3f43899c10b5e5442</signature>
</faspay>

Sample Code - JSON

{
   "request": "Post Data Transaction",
   "merchant_id": "99999",
   "merchant": "Sophia Store",
   "bill_no": "20201222024113",
   "bill_reff": "20200324_02-2286704_336",
   "bill_date": "2020-12-19 06:04:29",
   "bill_expired": "2020-12-19 07:04:29",
   "bill_desc": "Payment Online Via Faspay",
   "bill_currency": "IDR",
   "bill_gross": "100000",
   "bill_miscfee": "100000",
   "bill_total": "200000",
   "cust_no": "01",
   "cust_name": "John Doe",
   "payment_channel": "704",
   "pay_type": "01",
   "msisdn": "8562927907",
   "email": "[e-mail]",
   "terminal": "10",
   "billing_address": "Jl Sabang 37",
   "billing_address_city": "Jakarta",
   "billing_address_region": "DKI Jakarta",
   "billing_address_state": "Indonesia",
   "billing_address_poscode": "10170",
   "billing_address_country_code": "ID",
   "receiver_name_for_shipping": "John Doe",
   "shipping_address": "Jl. Sabang 37",
   "shipping_address_city": "Jakarta",
   "shipping_address_region": "DKI Jakarta",
   "shipping_address_state": "Indonesia",
   "shipping_address_poscode": "10170",
   "item": {
      "id": "A001",
      "product": "Invoice #2286704",
      "qty": "1",
      "amount": "100000",
      "payment_plan": "01",
      "merchant_id": "99999",
      "tenor": "00"
   },
   "reserve1": "",
   "reserve2": "",
   "signature": "d0ef313cc0f20a5d64d01fd3f43899c10b5e5442"
}

B. Post Data Transaction response

You will get the post data response like the following:

Sample Code XML

<?xml version="1.0" encoding="UTF-8" ?>
<faspay>
    <response>Transmission of Purchase Detail Info</response>
    <trx_id>9999970400001750</trx_id>
    <merchant_id>99999</merchant_id>
    <merchant>Sophia Store</merchant>
    <bill_no>20201222024113</bill_no>
    <bill_items>
	<id>A001</id>
	<product>Invoice #2286704</product>
	<qty>1</qty>
	<amount>100000</amount>
	<payment_plan>01</payment_plan>
	<merchant_id>99999</merchant_id>
	<tenor>00</tenor>
    </bill_items>
    <response_code>00</response_code>
    <response_desc>Success</response_desc>
    <redirect_url>https://dev.faspay.co.id/pws/100003/0830000010100000/d0ef313cc0f20a5d64d01fd3f43899c10b5e5442?trx_id=9999970400001750&merchant_id=99999&bill_no=20201222024113
    </redirect_url>
</faspay>

Sample Code - JSON

{
   "response": "Transmission of Purchase Detail Info",
   "trx_id": "9999970400001750",
   "merchant_id": "99999",
   "merchant": "Sophia Store",
   "bill_no": "20201222024113",
   "bill_items": {
      "id": "A001",
      "product": "Invoice #2286704",
      "qty": "1",
      "amount": "100000",
      "payment_plan": "01",
      "merchant_id": "99999",
      "tenor": "00"
   },
   "response_code": "00",
   "response_desc": "Success",
   "redirect_url" : "https://dev.faspay.co.id/pws/100003/0830000010100000/d0ef313cc0f20a5d64d01fd3f43899c10b5e5442?trx_id=9999970400001750&merchant_id=99999&bill_no=20201222024113"
}

2. Redirect customer to Sakuku's website

To redirect customers to Sakuku's Website, use redirect_url retrieved from Post Data Transaction response (JSON Format) or follow the detailed API reference Here

3. Callback/Return URL

After the customer completes the payment via Sakuku's apps, the Sakuku website automatically redirects the customer to Callback/Return URL. Please provide the URL and make sure it's already registered on Faspay system. For the detailed reference can be found Here

4. Payment Notification

Payment notification from Faspay to Merchant backend will also be triggered if the transaction status is updated to ensure the merchant is securely informed. Please provide the URL and make sure it's already registered on Faspay system

The detailed API reference can be found here