DANA Subs Integration Guide

Dana Subscription is one of the payment channels available on Faspay. When choosing DANA Subscription as a payment method, the User makes subscriptions at the beginning, then will be automatically cut in the next month.

Integration Step:

Post Data
Inquiry
Query All Subscription
Inquiry Subscription
Payment Notification
Cancel Subscription

1. Post Data Transaction

This process is used to send transaction data from merchants to Faspay. This post data process is carried out when the merchant requests parameters and then Faspay will give a response to the request.

URL EndPoint

Type

Development

A. Post Data Transaction Request

The parameters that must be provided by the Merchant system to be accessed by the Faspay system are as follows:

<?xml version="1.0" encoding="UTF-8" ?>
<faspay>
  <request>Transmission of Purchase Detail Info</request>
  <merchant_id>99999</merchant_id>
  <merchant>Sophia Store</merchant>
  <bill_no>84938942</bill_no>
  <bill_reff>20200324_02-2286704_336</bill_reff>
  <bill_date>2021-12-30 10:00:00</bill_date>
  <bill_expired>2021-12-31 12:04:10</bill_expired>
  <bill_desc>Payment #12345678</bill_desc>
  <bill_currency>IDR</bill_currency>
  <bill_gross>0</bill_gross>
  <bill_tax>0</bill_tax>
  <bill_miscfee>0</bill_miscfee>
  <bill_total>10000</bill_total>
  <cust_no>1</cust_no>
  <cust_name>John Doe</cust_name>
  <cust_lastname>Doe</cust_lastname>
  <payment_channel>722</payment_channel>
  <pay_type>1</pay_type>
  <bank_userid></bank_userid>
  <msisdn></msisdn>
  <email></email>
  <terminal>10</terminal>
  <billing_name>John</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>John Doe</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>Theater A</product>
    <subscription_message>Cartoon series A</subscription_message>
<subscription_interval_type>MONTHLY</subscription_interval_type>
    <subscription_interval_value>1</subscription_interval_value>
    <external_goods_id>cart-A9314</external_goods_id>
    <tenor>5</tenor>
  </item>
  <reserve1>0</reserve1>
  <reserve2></reserve2>
  <signature>09b2a8ed8e6bfe936cd24e69c12f675779ea240d</signature>
</faspay>

{
    "request": "Transmission of Purchase Detail Info",
    "merchant_id": 99999,
    "merchant": "Sophia Store",
    "bill_no": 84938942,
    "bill_reff": "20200324_02-2286704_336",
    "bill_date": "2021-12-30 10:00:00",
    "bill_expired": "2021-12-31 12:04:10",
    "bill_desc": "Payment #12345678",
    "bill_currency": "IDR",
    "bill_gross": 0,
    "bill_tax": 0,
    "bill_miscfee": 0,
    "bill_total": 10000,
    "cust_no": 1,
    "cust_name": "John Doe",
    "cust_lastname": "Doe",
    "payment_channel": 722,
    "pay_type": 1,
    "bank_userid": "",
    "msisdn": "",
    "email": "",
    "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": 8766688686,
    "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": 8766688686,
    "shipping_address_country_code": "ID",
    "item": [
        {
            "product": "Theater A",
            "subscription_message": "Kartun seri A",
            "subscription_interval_type": "MONTHLY",
            "subscription_interval_value": "1",
            "external_goods_id": "cart-A9314",
            "tenor": 5
        }
    ],
    "reserve1": 0,
    "reserve2": "",
    "signature": "09b2a8ed8e6bfe936cd24e69c12f675779ea240d"
}

Post Data Transaction Response

<?xml version="1.0" encoding="UTF-8" ?>
<faspay>
  <response>Transmission of Purchase Detail Info</response>
  <trx_id>9999971744152184</trx_id>
  <merchant_id>99999</merchant_id>
  <merchant>Sophia Store</merchant>
  <bill_no>84938942</bill_no>
  <bill_items>
     <product>Theater A</product>
     <subscription_message>Cartoon series A</subscription_message>
     <subscription_interval_type>MONTHLY</subscription_interval_type>
     <subscription_interval_value>1</subscription_interval_value>
     <external_goods_id>cart-A9314</external_goods_id>
     <tenor>5</tenor>
  </bill_items>
  <response_code>00</response_code>
  <response_desc>Success</response_desc>
  <redirect_url>https://debit-staging.faspay.co.id/pws/100003/0830000010100000/09b2a8ed8e6bfe936cd24e69c12f675779ea240d?trx_id=9999971744152184&amp;merchant_id=99999&amp;bill_no=84938942</redirect_url>
</faspay>

{
  "response": "Transmission of Purchase Detail Info",
  "trx_id": "9999971744152184",
  "merchant_id": "99999",
  "merchant": "Sophia Store",
  "bill_no": "84938942",
  "bill_items": [
    {
      "product": "Theater A",
      "subscription_message": "Cartoon series A",
      "subscription_interval_type": "MONTHLY",
      "subscription_interval_value": "1",
      "external_goods_id": "cart-A9314",
      "tenor": "5"
    }
  ],
  "response_code": "00",
  "response_desc": "Success",
  "redirect_url": "https://debit-staging.faspay.co.id/pws/100003/0830000010100000/09b2a8ed8e6bfe936cd24e69c12f675779ea240d?trx_id=9999971744152184&merchant_id=99999&bill_no=84938942"
}

2. Inquiry

Inquiry is a process of checking the status of Faspay’s payment transaction. The details of API Services of inquiry can be found here

3. Query All Subscription

This service functions to query all payments or subscription-related transactions.

Query All Subscription Request

<?xml version="1.0" encoding="UTF-8" ?>
<faspay>
  <request>Query All DANA Subscription</request>   
  <subscription_id>20211230111315800000DANAW3ID894000086077</subscription_id>
  <bill_no>84938942</bill_no>
  <merchant_id>99999</merchant_id>
  <payment_channel>722</payment_channel>
  <page>1</page>
  <limit>10</limit>
  <signature>09b2a8ed8e6bfe936cd24e69c12f675779ea240d</signature>
</faspay>

{
  "request": "Query All DANA Subscription",
  "subscription_id": "20211230111315800000DANAW3ID89400008607",
  "bill_no": "84938942",
  "merchant_id": "99999",
  "payment_channel": "722",
  "page": "1",
  "limit": "10",
  "signature": "09b2a8ed8e6bfe936cd24e69c12f675779ea240d"
}

<?xml version="1.0" encoding="UTF-8"?>
<faspay>
    <response>Query Subscription DANA Subscription</response>
    <merchant_id>99999</merchant_id>
    <payment_channel>722</payment_channel>
    <merchant>Sophia Store</merchant>
    <subscription_id>20220920111315800000DANAW3ID708600245077</subscription_id>
    <list_transaction>
        <transaction_1>
            <payment_date>2022-09-20 10:55:09</payment_date>
            <payment_status_code>2</payment_status_code>
            <payment_status_desc>Payment Success</payment_status_desc>
            <payment_amount>100</payment_amount>
        </transaction_1>
    </list_transaction>
    <response_code>00</response_code>
    <response_desc>Success</response_desc>
</faspay>

{
  "response": "Query Subscription DANA Subscription",
  "merchant_id": "99999",
  "payment_channel": "722",
  "merchant": "Sophia Store",
  "trx_id": "9999971744152184",
  "subscription_id": "20211230111315800000DANAW3ID894000086077",
  "list_transaction": {
    "transaction_1": {
      "payment_date": "2021-12-30 10:56:18",
      "payment_status_code": "2",
      "payment_status_desc": "Payment Success",
      "payment_amount": "100"
    }
  },
  "response_code": "00",
  "response_desc": "Success",
}

4. Inquiry Subscription

This service function integrates Faspay's Inquiry Subscription API with the Fund Details Query Order API.

URL EndPoint

Inquiry Subscription Request

The parameters that must be provided by the Merchant system to be accessed by the Faspay system are as follows:

<faspay>
    <request>Inquiry Subscription DANA Subscription</request>    
    <subscription_id>20220922111315800000DANAW3ID700500247519</subscription_id>
    <merchant_id>99999</merchant_id>
    <bill_no>9881236390987599</bill_no>
    <signature>54e43aa70b12aacceeb2b0b2c3cfc16bfea951ed</signature>
</faspay>

{
    "request": "Inquiry Subscription DANA Subscription",
    "subscription_id": "20220922111315800000DANAW3ID700500247519",
    "merchant_id": "99999",
    "bill_no": "9881236390987599",
    "signature": "54e43aa70b12aacceeb2b0b2c3cfc16bfea951ed"
}

Inquiry Subscription Response

<?xml version="1.0" encoding="UTF-8"?>
<faspay>
	<response>Inquiry Subscription DANA Subscription</response>
	<subscription_id>20220922111315800000DANAW3ID700500247519</subscription_id>
	<merchant>Sophia Store</merchant>
	<merchant_id>99999</merchant_id>
	<bill_no>9881236390987599</bill_no>
	<subs_status_code>1</subs_status_code>
	<subs_status_desc>Active</subs_status_desc>
	<payment_total>100.00</payment_total>
	<response_code>00</response_code>
	<response_desc>Success</response_desc>
</faspay>

{
  "response":"Inquiry Subscription DANA Subscription",
  "subscription_id":"20220922111315800000DANAW3ID700500247519",
  "merchant":"Sophia Store",
  "merchant_id":"99999",
  "bill_no":"9881236390987599",
  "subs_status_code":"1",
  "subs_status_desc":"Active",
  "payment_total":"100.00",
  "response_code":"00",
  "response_desc":"Success"
}

5. Payment Notification

A process for sending notifications to the merchant's payment of Faspay. Payment notifications are sent via URL merchant who previously had been prepared, which is the URL to receive notifications of transactions hit. Faspay will repeatedly send a payment notification 3 times if the first try does not get an OK response.

Payment Notification Request

<?xml version="1.0" encoding="UTF-8"?>
<faspay>
      <request>Payment Notification</request>
      <trx_id>9999971744152185</trx_id>
      <merchant_id>99999</merchant_id>
      <merchant>Sophia Store</merchant>
      <bill_no>84938942</bill_no>
      <payment_reff>20211230111315800000DANAW3ID894000086077</payment_reff>
      <payment_date>2021-12-30 10:00:00</payment_date>
      <payment_status_code>2</payment_status_code>
      <payment_status_desc>Payment Success</payment_status_desc>
      <bill_total>5000000</bill_total>
      <payment_total>5000000</payment_total>
      <payment_channel_uid>722</payment_channel_uid>
      <payment_channel>DANA Subscription</payment_channel>
      <signature>9ed18926fa88f83b469f3ae73ef71ef2a4835c03</signature>
</faspay>

{
      "request": "Payment Notification",
      "trx_id": "9999971744152185",
      "merchant_id": "99999",
      "merchant": "Sophia Store",
      "bill_no": "84938942",
      "payment_reff": "20211230111315800000DANAW3ID894000086077",
      "payment_date": "2021-12-30 10:00:00",
      "payment_status_code": "2",
      "payment_status_desc": "Payment success",
      "bill_total": "5000000",
      "payment_total": "5000000",
      "payment_channel_uid": "722",
      "payment_channel": "DANA Subscription",
      "signature": "9ed18926fa88f83b469f3ae73ef71ef2a4835c03"
}

Payment Notification Response

<?xml version="1.0" encoding="utf-8"?>
<faspay>
       <response>Payment Notification</response>
       <trx_id>9999971744152185</trx_id>
       <merchant_id>99999</merchant_id>
       <bill_no>84938942</bill_no>
       <response_code>2</response_code>
       <response_desc>Success</response_desc>
       <response_date>2021-12-30 10:00:30</response_date>
</faspay>

{
      "response": "Payment Notification",
      "trx_id": "9999971744152185",
      "merchant_id": "99999",
      "bill_no": "84938942",
      "response_code": "2",
      "response_desc": "Success",
      "response_date": "2021-12-30 10:00:30"
}

6. Cancel Subscription

This cancel subscription service function to cancel the payment which means all future billing will be disabled and the customer will no longer be charged on the billing date set by the customer plan

URL EndPoint

Cancel Subscription Request

<faspay>
        <request>Canceling Payment</request>
        <trx_id>9999972289533352</trx_id>
        <merchant_id>99999</merchant_id>
        <merchant>Sophia Store</merchant>
        <bill_no>9881236390987599</bill_no>
        <payment_cancel>Out of Stock</payment_cancel>
        <signature>54e43aa70b12aacceeb2b0b2c3cfc16bfea951ed</signature>
</faspay>

{
  "request": "Canceling Payment",
  "trx_id": "9999972289533352",
  "merchant_id": "99999",
  "merchant": "Sophia Store",
  "bill_no": 9881236390987600,
  "payment_cancel": "Out Of Stock",
  "signature": "54e43aa70b12aacceeb2b0b2c3cfc16bfea951ed"
}

Cancel Subscription Response

<faspay>
        <response>Canceling Payment</response>
        <subscription_id>20220920111315800000DANAW3ID708600245077</subscription_id>
        <merchant_id>99999</merchant_id>
        <merchant>Sophia Store</merchant>
        <bill_no>9881236390987599</bill_no>
        <subs_status_code>2</subs_status_code>
        <subs_status_desc>Inactive</subs_status_desc>
        <payment_cancel>Out of Stock</payment_cancel>
        <payment_cancel_date>2022-10-10 10:00:00</payment_cancel_date>
        <response_code>00</response_code>
        <response_desc>Success</response_desc>
</faspay>

{
  "response": "Canceling Payment",
  "subscription_id": "20220920111315800000DANAW3ID708600245077",
  "merchant_id": "99999",
  "merchant": "Sophia Store",
  "bill_no": "9881236390987600",
  "subs_status_code": "2",
  "subs_status_desc": "Inactive",
  "payment_cancel": "Out Of Stock",
  "payment_cancel_date": "2022-10-10 10:00:00",
  "response_code": "00",
  "response_desc": "Success"
}

PreviousOVO Tokenize Integration Guide NextPaydia QRIS Integration Guide

Last updated 5 months ago

Integration Step:

1. Post Data Transaction

URL EndPoint

A. Post Data Transaction Request

Post Data Transaction Response

2. Inquiry

3. Query All Subscription

Query All Subscription Request

Query All Subscribe Response

4. Inquiry Subscription

URL EndPoint

Inquiry Subscription Request

Inquiry Subscription Response

5. Payment Notification

Payment Notification Request

Payment Notification Response

6. Cancel Subscription

URL EndPoint

Cancel Subscription Request

Cancel Subscription Response

Integration Step:

1. Post Data Transaction

URL EndPoint

A. Post Data Transaction Request

Post Data Transaction Response

2. Inquiry

3. Query All Subscription

Query All Subscription Request

Query All Subscribe Response

4. Inquiry Subscription

URL EndPoint

Inquiry Subscription Request

Inquiry Subscription Response

5. Payment Notification

Payment Notification Request

Payment Notification Response

6. Cancel Subscription

URL EndPoint

Cancel Subscription Request

Cancel Subscription Response