Faspay
Search…
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
Parameter
Type
Lenght
Required
Description
merchant_id
N
5
M
Merchant code from faspay
merchant_name
AN
32
M
Merchant Name
order_id
AN
32
M
Order Number
order_reff
AN
32
O
Booking Number/reffrence (can fill same with order no)
bill_date
Datetime
​
M
Transaction/Order Date
bill_expired
Datetime
​
M
Transaction/Order Expiry Date
bill_desc
AN
128
M
Transaction Description
bill_gross
N
15
O
Order Nominal
bill_miscfee
N
15
O
Miscellaneous fee
bill_total
N
15
M
Total Nominal
custNo
AN
32
M
Customer Number
return_url
AN
32
M
url using to return to merchant website (*channel credit card)
custName
AN
32
O
Customer Name
custPhone
N
128
O
Customer Mobile Phone
custEmail
AN
128
M
Customer Email
billingAddress
AN
200
O
Billing Address
billingCity
AN
50
O
Billing City
billingRegion
AN
100
O
Billing Addres Region
billingState
AN
100
O
Billing Address State
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 results like the example below :
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 15d ago
Copy link
Contents