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
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:
{"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 detail 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"}
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"}
{"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 retry to send a payment notification 3 times if the first try is not getting a response ok.
This cancel subscription services function to cancel the payment which is all future billing will be disabled and the customer will no longer be charged on the billing date set by the customer plan
{"request":"Canceling Payment","trx_id":"9999972289533352","merchant_id":"99999","merchant":"Sophia Store","bill_no":9881236390987600,"payment_cancel":"Out Of Stock","signature":"54e43aa70b12aacceeb2b0b2c3cfc16bfea951ed"}