Faspay
Search…
Getting Started
Merchant Integration
SDK Integration
BEFORE LIVE
AFTER LIVE
Xpress
Faspay xpress is another way to integrate with Faspay business services, the difference is the payment channel option is on the Faspay page.
Basic integration process of faspay xpress will be explained below.
Integration Step
- 1.Post Data Transaction
- 2.callback/return URL (for one step transaction)
- 3.Payment Notification
1. Post Data Transaction
Endpoint URL Post Data
Endpoint URL is used as a feedback URL that will process the data in the post from the merchant system. There are two URLs that needs to be used, namely Production and Development. For the implementation of the testing or UAT can use the URL development
Production
Development
Request Parameter
Sample Request
No
Parameter
Type
Lenght
Required
Description
1
Merchant_id
N
5
M
Merchant code from faspay
2
Merchant_name
AN
32
M
Merchant Name
3
order_id
AN
32
M
Order Number
4
order_reff
AN
32
O
Booking Number/reffrence (can fill same with order no)
5
bill_date
Datetime
​
M
Transaction/Order Date
6
bill_expired
Datetime
​
M
Transaction/Order Expiry Date
7
bill_desc
AN
128
M
Transaction Description
8
bill_gross
N
15
O
Order Nominal
9
bill_miscfee
N
15
O
Miscellaneous fee
10
bill_total
N
15
M
Total Nominal
11
custNo
AN
32
M
Customer Number
12
return_url
AN
32
M
url using to return to merchant website (*channel credit card)
13
custName
AN
32
O
Customer Name
14
custPhone
N
128
O
Customer Mobile Phone
15
custEmail
AN
128
M
Customer Email
16
billingAddress
AN
200
O
Billing Address
17
billingCity
AN
50
O
Billing City
18
BillingRegion
AN
100
O
Billing Addres Region
19
billingState
AN
100
O
Billing Address State
20
billingPoscode
AN
10
O
Billing Address PosCode
21
billingCountryCode
AN
10
O
Billing Address Country Code
22
receiver_name
AN
100
O
Receiver Name
23
shippingAddress
AN
200
O
Shipping Address
24
shippingCity
AN
50
O
Shipping Address City
25
shippingRegion
AN
100
O
Shipping Address Region
26
shippingState
AN
100
O
Shipping Address State
27
shippingPostcode
AN
10
O
Shipping AddressPosCode
28
Products
AN
50
M
Items
29
Signature
AN
100
M
sha1(md5(user_id merchant + password merchant + bill_no + bill_total))
30
term_condition
N
1
M
Active Term and Conditions (1=True , 0=False)
1
$products = array(
2
array(
3
'product' => 'Bunga',
4
'qty' => 1,
5
'amount' => 450000
6
),
7
array(
8
'product' => 'Coklat',
9
'qty' => 2,
10
'amount' => 500000
11
)
12
);
13
​
14
$signature = sha1(md5($this->merchant_user.$this->merchant_password.$bill_no));
15
​
16
foreach($products as $rprod => $fprod){ $bill_total += ($fprod["amount"] * $fprod["qty"]); }
17
$data = serialize($products);
18
$encoded = htmlentities($data);
19
​
20
$post = array(
21
"merchant_id" => $this->merchant_id,
22
"merchant_name" => $this->merchant_name,
23
"order_id" => $bill_no,
24
"order_reff" => $bill_no,
25
"bill_date" => date("Y-m-d H:i:s"),
26
"bill_expired" => date("Y-m-d H:i:s", strtotime("+1 day")),
27
"bill_gross" => $bill_total,
28
"bill_miscfee" => '0',
29
"bill_total" => $bill_total,
30
"bill_desc" => 'Purchase Orders',
31
"custNo" => '01',
32
"return_url" => 'https://alamatwebsite.com/response',
33
"custName" => 'Tester',
34
"custPhone" => '085881130118',
35
"custEmail" => '[email protected]',
36
"billingAddress" => 'Jl. Pintu Air Raya No 2A',
37
"billingState" => 'Indonesia',
38
"billingCity" => 'Jakarta Pusat',
39
"billingRegion" => 'DKI Jakarta',
40
"billingPostcode" => '10710',
41
"billingCountryCode" => 'ID',
42
"receiver_name" => 'Tester',
43
"shippingAddress" => 'Jl. Pintu Air Raya No 2A',
44
"shippingState" => 'Indonesia',
45
"shippingCity" => 'Jakarta Pusat',
46
"shippingRegion" => 'DKI JAKARTA',
47
"shippingPostCode" => '10710',
48
"klik_pay_code" => $this->klikpay_code,
49
"clear_key" => $this->clear_key,
50
"server" => $this->server,
51
"mixed" => 0,
52
"mid_full" => '100001',
53
"mid_tiga_bulan" => '100003',
54
"mid_enam_bulan" => '100006',
55
"mid_duabelas_bulan" => '100012',
56
"mid_duaempat_bulan" => '100024',
57
"cicilan_enam_bulan" => 1,
58
"cicilan_tiga_bulan" => 1,
59
"cicilan_duabelas_bulan" => 1,
60
"cicilan_duaempat_bulan" => 1,
61
"products" => $encoded,
62
"signature" => $signature,
63
"term_condition" => 1,
64
);
65
Copied!
For every valid post data will get result like example bellow :
xpress purchase detail page
xpress payment method page
2. Callback/Return URL
After the customer completes the payment via bank's website, the bank website automatically redirect customer to Callback/Return URL. Please provide the URL and make sure it's already register on Faspay system. For the detail reference can be find Here​
3. 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
​
Last modified 3mo ago
Copy link
Contents