# 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: 1. Post Data 2. Inquiry 3. Query All Subscription 4. Inquiry Subscription 5. Payment Notification 6. 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
XML	https://debit-sandbox.faspay.co.id/pws/300011/183xx00010100000
JSON	https://debit-sandbox.faspay.co.id/cvr/300011/10

#### 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: {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
request	Alphanumeric (50)	M	Request Description
merchant_id	Numeric (5)	M	Merchant Code From Faspay = BOI
merchant	Alphanumeric (32)	M	Merchant Name
bill_no	Alphanumeric (32)	M	Order Number
bill_reff	Alphanumeric (32)	O	Booking Number/reference (can fill same with order no)
bill_date	Datetime YYYY-MM-DD HH:MM:SS	M	Transaction/ Order Date
bill_expired	Datetime YYYY-MM-DD HH:MM:SS	M	Payment Expiring Date (max 30 days)
bill_desc	Alphanumeric (128)	M	Transaction Description
bill_currency	Char (3)	M	Currency, Must be 'IDR'
bill_gross	Numeric (15)	O	Order Nominal without tax
bill_tax	Numeric (15)	O	Tax (IDR)
bill_miscfee	Numeric (15)	O	Miscellaneous fee
bill_total	Numeric (15)	M	Total Nominal
payment_channel	Numeric (3)	M	Payment Channel Code
pay_type	Alphanumeric (1)	M	Payment code : 1: Full Settlement 2: Installment 3: Mixed 1 & 2
cust_no	Alphanumeric (32)	M	Customer Number
cust_name	Alphanumeric (128)	M	Customer Name
bank_user_id	Alphanumeric (128)	O	Customer User ID on bank’s services (ex : KlikBCA User Id)
msisdn	Numeric (64)	M	Customer Mobile Phone
email	Alphanumeric (128)	M	Email
terminal	Numeric (2)	M	Terminal Origin 10. Web 20. MobApp Blackberry 21. MobApp Android 22. MobAppiOS 23. MobApp Windows 24. MobApp Symbian 30. TabApp BlackBerry 31. TabApp Android 32. TabAppiOS 33. TabApp Windows
billing_name	Alphanumeric	C	Billing name
billing_address	Alphanumeric (200)	O	Billing_address
billing_address_city	Alphanumeric (50)	O	Billing City
billing_address_region	Alphanumeric (100)	O	Billing Addres Region
billing_address_state	Alphanumeric (100)	O	Billing Address State
billing_address_poscode	Alphanumeric (10)	O	Billing Address Pos Code
billing_address_country_code	Alphanumeric (10)	O	Billing Address Country Code
receiver_name_for_shipping	Alphanumeric (100)	O	Receiver Name
shipping_address	Alphanumeric (200)	O	Shipping Address
shipping_address_city	Alphanumeric (50)	O	Shipping Address City
shipping_address_region	Alphanumeric (100)	O	Shipping Address Region
shipping_address_state	Alphanumeric (100)	O	Shipping Address State
shipping_address_poscode	Alphanumeric (10)	O	Shipping Address Pos Code
shipping_msisdn	Numeric	O	Shipping number phone
shipping_address_country_code	Alphanumeric (10)	O	Shipping Address Country Code
item	Array	M	List item product
product	Alphanumeric (50)	M	Product name
subscription_message	Alphanumeric (50)	M	Product Subcription detail
subscription_interval_type	Alphanumeric (10)	M	Determine months/weeks (e.g MONTHLY/WEEKLY)
subscription_interval_value	Numeric	M	Determine how many months/weeks (e.g 1/2/3/4)
external_goods_id	Alphanumeric (10)	M	Item code
tenor	Numeric	M	Determine the end date of subscription
reserve1	Alphanumeric (50)	O
reserve2	Alphanumeric (50)	C
signature	Alphanumeric (100)	M	sha1(md5(user_id merchant + password merchant + bill_no))

{% endtab %} {% tab title="Sample Code - XML" %} ```xml Transmission of Purchase Detail Info 99999 Sophia Store 84938942 20200324_02-2286704_336 2021-12-30 10:00:00 2021-12-31 12:04:10 Payment #12345678 IDR 0 0 0 10000 1 John Doe Doe 722 1 10 John 0 jalan pintu air raya Jakarta Pusat DKI Jakarta Indonesia 10710 8766688686 ID John Doe jalan pintu air raya Jakarta Pusat DKI Jakarta Indonesia 10710 8766688686 ID Theater A Cartoon series A MONTHLY 1 cart-A9314 5 0 09b2a8ed8e6bfe936cd24e69c12f675779ea240d ``` {% endtab %} {% tab title="Sample Code - JSON" %} ```json { "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" } ``` {% endtab %} {% endtabs %} #### Post Data Transaction Response {% tabs %} {% tab title="Parameter" %}

Parameter	Data Type	M/O/C	Description
response	Alphanumeric	O	Response description
trx_id	Numeric (20)	M	Transaction ID (Issued/generated by Faspay (Media Indonusa)). For the next payment has unique transaction ID.
merchant_id	Numeric	M	Merchant Code From Faspay = BOI
merchant	Alphanumeric	M	Merchant’s name
bill_no	Numeric	M	Order number
bill_items	Alphanumeric	O	Billing items / purchase items
product	Alphanumeric (50)	M	Item Name
subscription_message	Alphanumeric (50)	M	Product Subcription detail
subscription_interval_type	Alphanumeric (10)	M	Determine months/weeks (e.g MONTHLY/WEEKLY)
subscription_interval_value	Numeric	M	Determine how many months/weeks (e.g 1/2/3/4)
external_goods_id	Alphanumeric (10)	M	item code
tenor	Numeric	M	Determine the end date of subscription
response_code	Numeric (2)	M	Response code 00 : Success 01 : Failed
response_desc	Alphanumeric (32)	M	Response Description

{% endtab %} {% tab title="Sample Code - XML" %} ```xml Transmission of Purchase Detail Info 9999971744152184 99999 Sophia Store 84938942 Theater A Cartoon series A MONTHLY 1 cart-A9314 5 00 Success https://debit-staging.faspay.co.id/pws/100003/0830000010100000/09b2a8ed8e6bfe936cd24e69c12f675779ea240d?trx_id=9999971744152184&merchant_id=99999&bill_no=84938942 ``` {% endtab %} {% tab title="Sample Code - JSON" %} ```json { "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" } ``` {% endtab %} {% endtabs %} ## 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](https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/inquiry-payment-status) ## 3. Query All Subscription This service functions to query all payments or subscription-related transactions.

Type	Development
XML	https://debit-sandbox.faspay.co.id/pws/100035/183xx00010100000
JSON	https://debit-sandbox.faspay.co.id/cvr/100035/10

#### Query All Subscription Request {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
request	Alphanumeric (50)	O	Request Description
subscription_id	Numeric	M	Id subscription
bill_no	Numeric	M	Order number
merchant_id	Numeric (5)	M	Merchant Code From Faspay = BOI
payment_channel	Numeric (3)	M	Payment Channel Code
page	Numeric	M	The page number to display
limit	Numeric	M	Limit the amount of data wants to display
signature	Alphanumeric (100)	M	sha1(md5(user_id merchant + password merchant + bill_no))

{% endtab %} {% tab title="Sample Code - XML" %} ```xml Query All DANA Subscription 20211230111315800000DANAW3ID894000086077 84938942 99999 722 1 10 09b2a8ed8e6bfe936cd24e69c12f675779ea240d ``` {% endtab %} {% tab title="Sample Code - JSON" %} ```json { "request": "Query All DANA Subscription", "subscription_id": "20211230111315800000DANAW3ID89400008607", "bill_no": "84938942", "merchant_id": "99999", "payment_channel": "722", "page": "1", "limit": "10", "signature": "09b2a8ed8e6bfe936cd24e69c12f675779ea240d" } ``` {% endtab %} {% endtabs %} #### Query All Subscribe Response {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
response	Alphanumeric (50)	O	Response Description
merchant_id	Numeric (5)	M	Merchant Code From Faspay = BOI
payment_channel	Numeric (3)	M	Payment Channel Code
merchant	Alphanumeric (32)	M	Merchant name
subscription_id	Numeric	M	id subscription
list_transaction	Array	M	Report listing all the transactions
transaction_1	Array	M	Detail payment of all the transactions
payment_date	Datetime YYYY-MM-DD HH:MM:SS	M	Payment Date (from Payment Channel)
payment_status_code	Numeric (1)	M	Status Code 0 Unprocessed 1 In Process 2 Payment Success 4 Payment Reserval 5 No bills found 8 Payment Cancelled 9 Unknown
payment_status_desc	Alphanumeric (32)	M	Description status of payment
payment_amount	Numeric (3)	M	Payment Total
response_code	Numeric (2)	M	Response code: 00 : Success 01 : Failed
response_desc	Alphanumeric (32)	M	Response Description

{% endtab %} {% tab title="Sample Code - XML" %} ```xml Query Subscription DANA Subscription 99999 722 Sophia Store 20220920111315800000DANAW3ID708600245077 2022-09-20 10:55:09 2 Payment Success 100 00 Success ``` {% endtab %} {% tab title="Sample Code - JSON" %} ```json { "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", } ``` {% endtab %} {% endtabs %} ## 4. Inquiry Subscription This service function integrates Faspay's Inquiry Subscription API with the Fund Details Query Order API. #### URL EndPoint

Type	Development
XML	https://debit-sandbox.faspay.co.id/ pws/100043/183xx00010100000
JSON	https://debit-sandbox.faspay.co.id/ cvr/100043/10

#### Inquiry Subscription Request The parameters that must be provided by the Merchant system to be accessed by the Faspay system are as follows: {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
request	Alphanumeric (50)	O	Request Description
subscription_id	Numeric (16)	M	ID Subscription
merchant_id	Numeric (5)	M	Merchant Code
bill_no	Alphanumeric (16)	M	Order Number
signature	Alphanumeric	M	sha1(md5((user_id + password + bill_no))

{% endtab %} {% tab title=" Sample Code - XML " %} ```xml Inquiry Subscription DANA Subscription 20220922111315800000DANAW3ID700500247519 99999 9881236390987599 54e43aa70b12aacceeb2b0b2c3cfc16bfea951ed ``` {% endtab %} {% tab title="Sample Code - JSON" %} ```json { "request": "Inquiry Subscription DANA Subscription", "subscription_id": "20220922111315800000DANAW3ID700500247519", "merchant_id": "99999", "bill_no": "9881236390987599", "signature": "54e43aa70b12aacceeb2b0b2c3cfc16bfea951ed" } ``` {% endtab %} {% endtabs %} #### Inquiry Subscription Response {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
response	Alphanumeric (50)	O	Response Name
subscription_id	Numeric (16)	M	ID Subscription
merchant_id	Numeric (6)	M	Merchant Code
merchant	Alphanumeric (32)	M	Merchant name
bill_no	Alphanumeric (32)	M	Order number
subs_status_code	Numeric (1)	M	Status Code 1 Active 2 In Active
subs_status_desc	Alphanumeric (32)	M	Description Status
payment_total	Numeric	M	Total amount of payment
response_code	Numeric (2)	M	Response code: 00 = Success 01 = Failed
response_desc	Alphanumeric (32)	M	Response description

{% endtab %} {% tab title="Sample Code - XML" %} ```xml Inquiry Subscription DANA Subscription 20220922111315800000DANAW3ID700500247519 Sophia Store 99999 9881236390987599 1 Active 100.00 00 Success ``` {% endtab %} {% tab title="Sample Code - JSON" %}

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

{% endtab %} {% endtabs %} ## 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 {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
request	Alphanumeric (50)	O	Request Description
trx_id	Numeric (16)	M	Transaction ID (Issued/generated by Faspay (Media Indonusa)). For the next payment has unique transaction ID.
merchant_id	Numeric (5)	M	Merchant Code
merchant	Alphanumeric (32)	M	Merchant name
bill_no	Alphanumeric (16)	M	Order Number
payment_reff	Alphanumeric (16)	M	Subscription ID
payment_date	Datetime YYYY-MM-DD HH:MM:SS	M	Payment Date (from Payment Channel)
payment_status_code	Numeric (1)	M	Status Code 0 Unprocessed 1 In Process 2 Payment Success 4 Payment Reserval 5 No bills found 8 Payment Cancelled 9 Unknown
payment_status_desc	Alphanumeric (32)	M	Description Status
bill_total	Numeric	M	Total billing
payment_total	Numeric	M
payment_channel_uid	Alphanumeric (50)	M	Cancel description
payment_channel	Datetime YYYY-MM-DD HH:MM:SS	M	Payment cancel date
signature	Alphanumeric	M	sha1(md5((user_id + password + bill_no))

{% endtab %} {% tab title="Sample Code - XML" %}

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

{% endtab %} {% tab title="Sample Code - JSON" %} ```json { "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" } ``` {% endtab %} {% endtabs %} #### Payment Notification Response {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
response	Alphanumeric (50)	O	Response Name
trx_id	Numeric (16)	M	Transaction ID (Issued/generated by Faspay (Media Indonusa)). For the next payment has unique transaction ID.
merchant_id	Numeric (6)	M	Merchant Code
merchant	Alphanumeric (32)	M	Merchant name
bill_no	Alphanumeric (32)	M	Order number
response_code	Numeric (2)	M	Response code: 00 : Success 01 : Failed
response_desc	Alphanumeric (32)	M	Response Description
response_date	Datetime YYYY-MM-DD HH:MM:SS	M	Response Date

{% endtab %} {% tab title="Sample Code - XML" %} ```xml Payment Notification 9999971744152185 99999 84938942 2 Success 2021-12-30 10:00:30 ``` {% endtab %} {% tab title="Sample Code - JSON" %} ```json { "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" } ``` {% endtab %} {% endtabs %} ## 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

Type	Development
XML	https://debit-sandbox.faspay.co.id/pws/100005/183xx00010100000
JSON	https://debit-sandbox.faspay.co.id/cvr/100005/10

#### Cancel Subscription Request {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
request	Alphanumeric (50)	O	Request Description
trx_id	Numeric (16)	M	Transaction ID (Issued/generated by Faspay (Media Indonusa)). For the next payment has unique transaction ID.
merchant_id	Numeric (5)	M	Merchant Code
merchant	Alphanumeric (32)	M	Merchant name
bill_no	Alphanumeric (16)	M	Order Number
payment_cancel	Alphanumeric	M	Payment cancel description
signature	Alphanumeric	M	sha1(md5((user_id + password + bill_no))

{% endtab %} {% tab title="Sample Code - XML" %}

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

{% endtab %} {% tab title="Sample Code - JSON" %} ```json { "request": "Canceling Payment", "trx_id": "9999972289533352", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": 9881236390987600, "payment_cancel": "Out Of Stock", "signature": "54e43aa70b12aacceeb2b0b2c3cfc16bfea951ed" } ``` {% endtab %} {% endtabs %} #### Cancel Subscription Response {% tabs %} {% tab title="Parameter Body" %}

Parameter	Data Type	M/O/C	Description
response	Alphanumeric (50)	O	Request description
subscription_id	Numeric	M	id subscription
merchant_id	Numeric (5)	M	Merchant code
merchant	Alphanumeric (32)	M	Merchant name
bill_no	Alphanumeric (16)	M	Order number
subs_status_code	Numeric (1)	M	Status Code: 1: Active 2: Inactive
subs_status_desc	Alphanumeric	M	Subscription status description
payment_cancel	Alphanumeric	M	Payment cancel description
payment_cancel_date	Datetime	M	Payment cancel date. Format YYYY-MM-DD hh:mm:ss
response_code	Numeric	M	Code description
response_desc	Alphanumeric	M	Response description

{% endtab %} {% tab title="Sample Code - XML" %}

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

{% endtab %} {% tab title="Sample Code - JSON" %} ```json { "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" } ``` {% endtab %} {% endtabs %}