Faspay
  • Homepage
  • Getting Started
    • Faspay Business
      • Debit Transaction
        • Features
          • Static Transaction
            • Virtual Account Static
          • UNIcount
      • Credit Card Transaction
        • Recurring Payment
    • Faspay Billing
      • Introduction
      • Feature
      • How To Use
        • Getting Started
        • Dashboard
        • Recipient
          • List Recipient
          • Recipient Group
          • Recurrence Status
        • Scheduled Status
        • Invoice
        • Report
        • Create Billing System
          • Single Billing
          • Mass Billing
        • Billing Setting
          • Reminder Setting
          • Template Setting
          • Invoice Status
    • Faspay Billing 2.0
      • How to Use
        • Getting Started
        • Billings
          • Billings List
            • Detail Billing
            • Upload Document
          • Scheduled Billing
          • Recurring Billing
          • Static VA Generator
            • Static VA Close Generator
            • Static VA Open Generator
            • Static VA List
            • Payment History
            • Excel File Template
        • Customers
          • Customer List
          • Customer Group
        • Reports
          • Invoice Issued
          • Payment History
          • Summary Outstanding
          • Detail Outstanding
          • Invoice Aging Report
          • Invoice Paid Report
          • Export Report
        • Items
          • Product Catalogs
          • Rooms
          • Product Category
          • UoM (Unit of Measurement)
        • E-Faktur
          • E-Faktur Range Number
            • Generate E-Faktur Number
            • Cancelation E-Faktur Number
          • Export CSV
          • E-Faktur Files
          • Setting Threshold E-Faktur
        • QR Business Profile
          • Create Business Profile
          • Business Profile List
          • Access Business Profile Page
          • Transaction History on Business Profile
            • Lite Sales App
        • Billing Settings
    • Faspay Xpress
      • Faspay Xpress 4.0
        • Setting Language
        • Payment Method
        • Quick Payment Guide
        • Send your Order Details and Payment Instructions
        • Payment Status
        • Payment Receipt
        • Rating Payment
      • Setting Xpress
    • Faspay SendMe
      • Introduction
      • Credentials
      • List Of Service API
      • Authentication
        • Header
        • Authorization
        • Signature
          • Generate signature token
          • Generate signature other service
          • HTTP Method
          • Relative URL
        • Request Body
        • Access Token
      • Cash Out
        • Alfamart Cash Out
        • Indomaret Cash Out
      • E-Wallet
    • SNAP
      • SNAP Direct Debit
      • SNAP QRIS
      • SNAP Virtual Account
      • SNAP Disbursement
  • Merchant Integration
    • API Reference
      • Debit
        • Payment Channel Inquiry
        • Post Data Transaction
        • Redirect Process
        • Inquiry Payment Status
        • Cancel Transaction
        • Payment Notification
        • URL Callback/Return URL
        • Reference
          • Status Response Code
          • Payment Channel Code
        • Bank Transfer Integration Guide
        • Internet Banking integration Guide
        • Retail Payment Integration Guide
        • Online Debit Integration Guide
          • B-secure
          • BRI Direct Debit
        • Online Credit Integration Guide
          • Status Response Code
        • e-Money Integration Guide
          • LinkAja Integration Guide
          • LinkAja QRIS Integration Guide
          • LinkAja AppLink Integration Guide
          • DANA Integration Guide
          • Sakuku Integration Guide
          • OVO Integration Guide
          • ShopeePay Jump App Integration Guide
          • ShopeePay QRIS Integration Guide
          • OVO Tokenize Integration Guide
          • DANA Subs Integration Guide
          • Paydia QRIS Integration Guide
        • Features
          • Static Transaction Integration
            • BNI VA Static Integration
            • BNC VA Static Integration
          • Unicount
        • Postman Collection
      • Credit Card
        • Payment Integration API
        • Additional API Integration
          • Inquiry Payment Status
          • Capture Transaction
          • Transaction Void
          • Refund Transaction
          • Signature Transaction
            • Generate Signature Request
            • Genarete signature response
          • Server CallBack / URL Notification Credit Card
          • API Tokenization
            • Payment Window Integration API
            • Payment Direct API
            • Advance Functionality API Tokenization
              • Inquiry Detail Token
              • Inquiry Delete Token
              • Inquiry Last Token (Dynamic Token Only)
        • Recurring Payment API
          • Message Flow Transaction
            • Post Transaction
            • Update Card
          • JSON Message Format
            • Update Member
            • Inquiry Status
            • Payment Notification
            • Notification CC Expired
          • Status Response Code
        • Response Transaction
          • Response Success
          • Response Failed
          • Response Code Error Transaction
          • User Notification Screen
        • Reference
          • Faspay e-Payment Error Code Listing - CC
          • Transaction Status - CC
          • End User Indicator (EUI)
          • Categories of User Code and User Message - CC
          • ECI
      • Xpress
        • Xpress Version 4🆕
      • Faspay Billing API
        • Create Billing
        • Inquiry Billing
        • Cancel Billing
        • Get List Invoice
        • Callback
      • SendMe
        • Register Account
        • Confirmation Register Account
        • Transfer
        • Inquiry Name
        • Inquiry Balance
        • Mutasi
        • Inquiry Status
        • Notification / Callback
        • Error Code And Response Code
        • APPENDIX
        • Cash Out
          • ATM Permata Cash Out
          • Alfamart Cash Out
          • Indomaret Cash Out
        • E-Wallet (Top Up)
          • Inquiry Name
          • Transfer (Top Up)
      • SNAP
        • Signature SNAP
        • SNAP Virtual Account
        • SNAP Direct Debit
        • SNAP QRIS
        • SNAP Disbursement
          • Response Code
      • Route Payment
        • Post Data Transaction
        • SNAP Generate QRIS
        • SNAP Create Virtual Account
        • SNAP Direct Debit
        • Inquiry Static VA
        • SNAP Inquiry Static VA
        • Response Code
    • E-Commerce Plugin
      • Woocommerce
      • Ecwid
  • SDK Integration
    • SendMe SDK
      • Integration with Java SDK
      • Integrate with PHP SDK
      • Integrate with Python SDK
  • BEFORE LIVE
    • Whitelist IP
    • Account Testing
    • Sample Code
  • AFTER LIVE
  • Merchant page Reference
    • Change Password
    • Dashboard
    • Transactions
      • Debit
      • Credit
      • Settlement
      • Notification
    • Settings Profile
    • Faspay Business
      • Credential Settings
      • Report Settings
        • Daily Report Settings
        • Daily Report
        • Resend Daily Report
      • Developer Settings
      • Route Payment
        • Transaction Report
        • History
    • Faspay SendMe
      • Google Authenticator Pairing
      • Disbursement Account
      • Withdrawal
      • Withdraw History
      • Single Transfer
      • Mass Transfer
        • Upload File
        • Validation
        • Mass Transfer
      • Transaction History
      • Paycheck
      • Top Up
      • Credential Settings
      • Report Settings
        • Daily Report
        • Daily Report Setting
        • Resend Daily Report
Powered by GitBook
On this page
  • Integration Step:
  • 1. Post Data Transaction
  • 2. Inquiry
  • 3. Query All Subscription
  • 4. Inquiry Subscription
  • 5. Payment Notification
  • 6. Cancel Subscription
  1. Merchant Integration
  2. API Reference
  3. Debit
  4. e-Money Integration Guide

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

JSON

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:

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

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

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

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

3. Query All Subscription

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

Type
Development

XML

JSON

Query All Subscription Request

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

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

Query All Subscribe Response

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

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

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:

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

<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

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

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

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

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

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

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

Type
Development

XML

JSON

Cancel Subscription Request

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

<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

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

<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 GuideNextPaydia QRIS Integration Guide

Last updated 10 months ago

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://debit-sandbox.faspay.co.id/pws/300011/183xx00010100000
https://debit-sandbox.faspay.co.id/cvr/300011/10
https://debit-sandbox.faspay.co.id/pws/100035/183xx00010100000
https://debit-sandbox.faspay.co.id/cvr/100035/10
https://debit-sandbox.faspay.co.id/pws/100005/183xx00010100000
https://debit-sandbox.faspay.co.id/cvr/100005/10