Faspay
Search…
API Integration

Post Data

The services API is basically the same as the existing Post data API in Debit Integration. However, there are the differences in the bill_expired parameter.
Endpoint URL Post Data
Method : HTTP POST

Request Parameter Post Data

Request
Sample XML Request
Sample JSON Request
Parameter
Data Type
M/O/C
Description
Request
Alfanumeric (50)
M
Request Description
Merchant_id
Numeric (5)
M
Merchant Code From Faspay = BOI
Merchant
Alfanumeric (32)
M
Merchant Name
bill_no
Numeric (16)
M
Virtual Account Number from channel (BNI VA).
(prefix 3 + client id 5+ faspay id 2 + 6 free digits)
bill_reff
Alfanumeric (32)
O
Booking Number/reffrence (can fill same with order no)
bill_date
Datetime YYYY-MM-DD HH:MM:SS (6)
M
Transaction/ Order Date
bill_expired
Datetime YYYY-MM-DD HH:MM:SS (6)
M
Payment Expired Date (Merchant can set > 30 days or less, except past date).
bill_desc
Alfanumeric (128)
M
Transaction Description
bill_currency
Alfanumeric (3)
M
Currency, Must be 'IDR'
bill_gross
Numeric (15)
O
Order Nominal
bill_miscfee
Numeric (15)
O
Miscellaneous fee
bill_total
Numeric (15)
M
Open maximum amount. Amount maximum per transaction.
payment_channel
Numeric (32)
M
Payment Channel Code
pay_type
Alfanumeric (1)
M
Payment type :
1: Full Settlement
2: Installment
3: Mixed 1 & 2
Pay Type 2 & 3 only implement on BCA KlikPay channel
cust_no
Alfanumeric (32)
M
Customer Number
cust_name
Alfanumeric (128)
M
Customer Name
bank_user_id
Alfanumeric (128)
O
Customer User ID on bank’s services (ex : KlikBCA User Id)
Msisdn
Numeric (64)
M
Customer Mobile Phone
Email
Alfanumeric (128)
M
Customer Email
1
<faspay>    
2
<request>Post Data Transaction</request>
3
    <merchant_id>99999</merchant_id>
4
    <merchant>Mi Merchant</merchant>
5
    <bill_no>9881236312345697</bill_no>
6
    <bill_reff>9881236312345697</bill_reff>
7
    <bill_date>2021-10-28 00:19:00</bill_date>
8
    <bill_expired>2021-10-29 00:19:00</bill_expired>
9
    <bill_desc>BNI Virtual Account Method</bill_desc>
10
    <bill_currency>IDR</bill_currency>
11
    <bill_gross>0</bill_gross>
12
    <bill_tax>0</bill_tax>
13
    <bill_miscfee>0</bill_miscfee>
14
    <bill_total>1000000</bill_total>
15
    <cust_no>5002</cust_no>
16
    <cust_name>Andreas Wira</cust_name>
17
    <cust_lastname>Wira</cust_lastname>
18
    <payment_channel>801</payment_channel>
19
    <pay_type>1</pay_type>
20
    <bank_userid/>
21
    <msisdn/>
22
    <email>[email protected]</email>
23
    <terminal>10</terminal>
24
    <billing_name>Faspay</billing_name>
25
    <billing_lastname>Test</billing_lastname>
26
    <billing_address>jalan pintu air raya</billing_address>
27
    <billing_address_city>Jakarta Pusat</billing_address_city>
28
    <billing_address_region>DKI Jakarta</billing_address_region>
29
    <billing_address_state>Indonesia</billing_address_state>
30
    <billing_address_poscode>10710</billing_address_poscode>
31
    <billing_msisdn>0856123456789</billing_msisdn>
32
    <billing_address_country_code>ID</billing_address_country_code>
33
    <receiver_name_for_shipping>Faspay</receiver_name_for_shipping>
34
    <shipping_lastname>Test</shipping_lastname>
35
    <shipping_address>jalan pintu air raya</shipping_address>
36
    <shipping_address_city>Jakarta Pusat</shipping_address_city>
37
    <shipping_address_region>DKI Jakarta</shipping_address_region>
38
    <shipping_address_state></shipping_address_state>
39
    <shipping_address_poscode>10710</shipping_address_poscode>
40
    <shipping_msisdn>0856123456789</shipping_msisdn>
41
    <shipping_address_country_code>ID</shipping_address_country_code>
42
<item>
43
        <qty>8</qty>
44
        <amount>500000</amount>
45
        <type>Smartphone</type>
46
    </item>
47
    <item>
48
        <qty>1</qty>
49
        <amount>500000</amount>
50
        <type>Smartphone</type>
51
    </item>
52
    <reserve1/>
53
    <reserve2/>
54
    <signature>d848063d9836c20cf0055d70bd7e862e5f991688</signature>
55
</faspay>
Copied!
1
{
2
"request": "Post Data Transaction",
3
"merchant_id": 99999,
4
"merchant": "Mi Merchant",
5
"bill_no":9881236312345696,
6
"bill_reff":9881236312345696,
7
"bill_date": "2021-10-28 00:19:00",
8
"bill_expired": "2021-10-29 00:19:00",
9
"bill_desc": "BNI Virtual Accunt Method",
10
"bill_currency": "IDR",
11
"bill_gross":0,
12
"bill_tax":0,
13
"bill_miscfee":0,
14
"bill_total": 1000000,
15
"cust_no":5002,
16
"cust_name": "Andreas Wira",
17
"cust_lastname": "Wira",
18
"payment_channel":801,
19
"pay_type":1,
20
"bank_userid": "",
21
"msisdn": ""
22
"email": "[email protected]",
23
"terminal":10,
24
"billing_name": "Faspay",
25
"billing_lastname": "Indonusa",
26
"billing_address": "jalan pintu air raya",
27
"billing_address_city": "Jakarta Pusat",
28
"billing_address_region": "DKI Jakarta"
29
"billing_address_state": "Indonesia",
30
"billing_address_poscode":10710,
31
"billing_msisdn":856123456789,
32
"billing_address_country_code": "ID",
33
"receiver_name_for_shipping": "Faspay",
34
"shipping_lastname": "Indonusa",
35
"shipping_address": "jalan pintu air raya",
36
"shipping_address_city": "Jakarta Pusat",
37
"shipping_address_region": "DKI Jakarta",
38
"shipping_address_state": "",
39
"shipping_address_poscode":10710,
40
"shipping_msisdn":856123456789,
41
"shipping_address_country_code": "ID"
42
"item": [
43
{
44
"qty":8,
45
"amount":500000,
46
"type": "Smartphone"
47
},
48
{
49
"qty":1,
50
"amount":500000,
51
"type": "Smartphone"
52
}
53
],
54
"reserve1": "",
55
"reserve2": "",
56
"signature": "d848063d9836c20cf0055d70bd7e862e5f991688"
57
},
58
}
Copied!

Response Parameter Post Data

Response
Sample XML Response
Sample JSON reponse
Parameter
Data Type
M/O/C
Description
Response
Alfanumeric (50)
O
Response Name
trx_id
Numeric (16)
M
Transaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired
Merchant_id
Numeric (5)
M
Merchant Code
Merchant
Alfanumeric (32)
M
Merchant Name
bill_no
Numeric (16)
M
Virtual Account Number from channel (BNI VA).
(prefix 3 + client id 5+ faspay id 2 + 6 free digits)
Response_Code
Numeric (2)
M
Response Code 00 Success
Response_Desc
Alfanumeric (32)
M
Response Code Description
redirect_url
Alfanumeric
O
the redirect url for the next process, available only on JSON format
1
<?xml version="1.0" encoding="UTF-8"?>
2
<faspay>
3
<response>Transmission of Purchase Details </response>
4
<trx_id>1635384937045906</trx_id>
5
<merchant_id>99999</merchant_id>
6
<merchant>FASPAY DEMO</merchant>
7
<bill_no>9881236312345697</bill_no>
8
<bill_items>
9
<id>101</id>
10
<qty>8</qty>
11
<amount>500000</amount>
12
<type>Smartphone</type>
13
</bill_items>
14
<bill_items>
15
<id>102</id>
16
<qty>1</qty>
17
<amount>500000</amount>
18
<type>Smartphone</type>
19
</bill_items>
20
<response_code>00</response_code>
21
<response_desc>Sukses</response_desc>
22
</faspay>
Copied!
1
{
2
"response": "Transmission of Purchase Details ",
3
"trx_id": 1635384937045906,
4
"merchant_id": 99999,
5
"merchant": "FASPAY DEMO",
6
"bill_no": 9881236312345696,
7
"bill_items": [
8
{
9
"qty": 8,
10
"amount": 500000,
11
"type": "Smartphone"
12
},
13
{
14
"qty": 1,
15
"amount": 500000,
16
"type": "Smartphone"
17
}
18
],
19
"response_code": 00,
20
"response_desc": "Sukses"
21
}
Copied!

Inquiry Payment Status Request

In this API service, basically the Inquiry Payment Status parameter is the same as the existing one. The difference is that when hit, the response received is a list of several transactions using that VA number.

Endpoint URL Inquiry Payment Status

Inquiry Payment Status Request

The parameters that must be provided by the merchant system to be able to integrate with the Faspay system are as follows:
Request
Sample XML Request
Sample JSON Request
Parameter
Data Type
M/O/C
Deskripsi
request
Alphanumeric
Optional
Request Description
trx_id
Numeric
Mandatory
Transaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired.
bill_no
Numeric
Mandatory
Virtual Account Number from channel (BNI VA).
(prefix 3 + client id 5+ faspay id 2 + 6 free digits)
merchant_id
Numeric
Mandatory
Merchant Code.
signature
Numeric
Mandatory
sha1(md5((user_id + password + bill_no))
1
<faspay>
2
<request>Inquiry Status Payment</request>
3
<trx_id>1634624112045887</trx_id>
4
<bill_no>9881236312345694</bill_no>
5
<merchant_id>99999</merchant_id>
6
<signature>c71c38790836479377713395117bbc9e70dadd17</signature>
7
</faspay>
Copied!
1
{
2
“request”: “Inquiry Status Payment”,
3
“trx_id”:1634624112045887,
4
“bill_no”:9881236312345694,
5
“merchant_id”:99999,
6
“signature”: “c71c38790836479377713395117bbc9e70dadd17”
7
}
Copied!

Inquiry Payment Status Response

Response
Sample XML Response
Sample JSON Response
Parameter
Data Type
M/O/C
Deskripsi
response
Alphanumeric (50)
Mandatory
Response description
merchant_id
Numeric (6)
Mandatory
Merchant Code
merchant
Alphanumeric (32)
Mandatory
Merchant name
bill_no
Numeric (16)
Mandatory
Virtual Account Number from channel (BNI VA).
(prefix 3 + client id 5+ faspay id 2 + 6 free digits)
transaction
Transaction data object
Mandatory
collection of all transaction data status used
trx_id
Numeric (16)
Mandatory
Transaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired
Payment_reff
Numeric (16)
Mandatory
Payment Reff (from Payment Channel)
payment_date
DateTime
Mandatory
Payment Date (from Payment Channel)
paymnet_status_code
Numeric
Mandatory
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
Mandatory
Description status of Payment
response_code
Numeric
Mandatory
Response Code 00 Success
response_desc
Alphanumeric
Mandatory
Response Description
1
<?xml version="1.0" encoding="UTF-8"?>
2
<faspay>
3
<response>Inquiry Payment Status</response>
4
<merchant_id>99999</merchant_id>
5
<merchant>FASPAY DEMO</merchant>
6
<bill_no>9881236312345600</bill_no>
7
<transaction>
8
<transaction_1>
9
<trx_id>1634091930000913</trx_id>
10
<payment_reff>377798</payment_reff>
11
<payment_date>2021-10-13 09:26:16</payment_date>
12
<payment_status_code>2</payment_status_code>
13
<payment_status_desc>Payment Success</payment_status_desc>
14
</transaction_1>
15
<transaction_2>
16
<trx_id>1634091930000914</trx_id>
17
<payment_reff>715524</payment_reff>
18
<payment_date>2021-10-13 16:08:31</payment_date>
19
<payment_status_code>8</payment_status_code>
20
<payment_status_desc>Payment Cancelled</payment_status_desc>
21
</transaction_2>
22
</transaction>
23
<response_code>00</response_code>
24
<response_desc>Sukses</response_desc>
25
</faspay>
Copied!
1
{
2
"faspay": {
3
"response": "Inquiry Payment Status",
4
"merchant_id": 99999,
5
"merchant": "FASPAY DEMO",
6
"bill_no": 9881236312345600,
7
"transaction": {
8
"transaction_1": {
9
"trx_id": 1634091930000913,
10
"payment_reff": 377798,
11
"payment_date": "2021-10-13 09:26:16",
12
"payment_status_code": 2,
13
"payment_status_desc": "Payment Success"
14
},
15
"transaction_2": {
16
"trx_id": 1634091930000914,
17
"payment_reff": 715524,
18
"payment_date": "2021-10-13 16:08:31",
19
"payment_status_code": 8,
20
"payment_status_desc": "Payment Cancelled"
21
}
22
},
23
"response_code": 0,
24
"response_desc": "Success"
25
}
26
}
27
Copied!

Update Transaction

This service aims to update static transactions, transaction updates can be done before or after making payments.

Endpoint URL Inquiry Update Transaction

Update Transaction Request

The parameters that must be provided by the merchant system to be able to integrate with the Faspay system are as follows:
Request
Sample XML request
Sample JSON Request
Parameter
Data Type
M/O/C
Deskripsi
request
Alphanumeric
M
Request Description
bill_no
Numeric
M
Virtual Account Number from channel (BNI VA).
(prefix 3 + client id 5+ faspay id 2 + 6 free digits)
merchant_id
Numeric
M
Merchant code
bill_total
Numeric
M
Open maximum amount. Amount maximum per transaction.
cust_name
Alphanumeric
M
Custumer name
bill_expired
DateTime (YYYY:MM:DD HH:MM:SS)
M
Payment Expired Date (Merchant can set > 30 days or less, except past date).
signature
Alphanumeric
M
sha1(md5((merchant_id + passwd + bill_no))
1
<faspay>
2
<request>Update Transaction BNI VA Static</request>
3
<bill_no>9881236398989898</bill_no>
4
<merchant_id>99999</merchant_id>
5
<bill_total>1000000</bill_total>
6
<cust_name>Andreas Wira</cust_name>
7
<bill_expired>2021-10-31 15:04:10</bill_expired>
8
<signature>1ac4d5a611ec5376d8da43bbe33aaea1719076b6</signature>
9
</faspay>
Copied!
1
{
2
"request": "Update Transaction BNI VA Static",
3
"bill_no": 9881236398989898,
4
"merchant_id": 99999,
5
"bill_total": 1000000,
6
"cust_name": "Andreas Wira",
7
"bill_expired": "2021-10-31 15:04:10",
8
"signature": "1ac4d5a611ec5376d8da43bbe33aaea1719076b6"
9
}
Copied!

Update Transaction Response

Response
Sample XML Response
Sample JSON response
Parameter
Data Type
M/O/C
Deskripsi
response_code
Numeric
M
Response code
response_desc
Alphanumeric
M
Response description
bill_no
Numeric
M
Virtual Account Number from channel (BNI VA).
(prefix 3 + client id 5+ faspay id 2 + 6 free digits)
1
<?xml version="1.0" encoding="UTF-8"?>
2
<faspay>
3
<response_code>00</response_code>
4
<response_desc>Successfully updated transaction</response_desc>
5
<bill_no>9881236312345697</bill_no>
6
</faspay>
Copied!
1
{
2
"response_code":00,
3
"response_desc": "Successfully updated transaction",
4
"bill_no":9881236312345696
5
}
Copied!

Payment Notification

Payment notification from Faspay to Merchant backend will also be triggered on event of transacion status getting updated, to ensure merchant is securely informed. Please provide the URL and make sure it's already register on Faspay system.
The detail API reference can be find here
Copy link
Contents