Faspay
Search…
OVO Integration Guide
One of the e-money payment method offered by Faspay is OVO. By using this payment method, customers will have the option to make a payment via e-money website and Faspay will send real time notification when the customer complete the payment.
Basic integration process of OVO will be explained below.
Integration Step
  1. 1.
    Post Data Transaction to Faspay
  2. 2.
    Push to Pay
  3. 3.
    Callback/Return URL
  4. 4.
    Payment Notification

1. Post Data Transaction

Post data transaction should be done from merchant backend, the detail API reference can be find Here
This is example of post data transaction for Sakuku channel
1
{
2
"request": "Post Data Transaksi",
3
"merchant_id": "99999",
4
"merchant": "FASPAY STORE",
5
"bill_no": "20201222024304",
6
"bill_reff": "20200324_02-2286704_336",
7
"bill_date": "2020-12-19 06:04:29",
8
"bill_expired": "2020-12-19 07:04:29",
9
"bill_desc": "Payment Online Via Faspay",
10
"bill_currency": "IDR",
11
"bill_gross": "100000",
12
"bill_miscfee": "100000",
13
"bill_total": "200000",
14
"cust_no": "01",
15
"cust_name": "tester",
16
"payment_channel": "812",
17
"pay_type": "01",
18
"msisdn": "8562927907",
19
"email": "[email protected]",
20
"terminal": "10",
21
"billing_address": "Jl Sabang 37",
22
"billing_address_city": "Jakarta",
23
"billing_address_region": "DKI Jakarta",
24
"billing_address_state": "Indonesia",
25
"billing_address_poscode": "10170",
26
"billing_address_country_code": "ID",
27
"receiver_name_for_shipping": "Tompi",
28
"shipping_address": "Jl. Sabang 37",
29
"shipping_address_city": "Jakarta",
30
"shipping_address_region": "DKI Jakarta",
31
"shipping_address_state": "Indonesia",
32
"shipping_address_poscode": "10170",
33
"item": {
34
"id": "A001",
35
"product": "Invoice #2286704",
36
"qty": "1",
37
"amount": "100000",
38
"payment_plan": "01",
39
"merchant_id":"99999",
40
"tenor": "00"
41
},
42
"reserve1": "",
43
"reserve2": "",
44
"signature": "92c41cf28825f8065530f09726b3c6f0bd2e218e"
45
}
Copied!
Post Data Transaction response
You will get the post data response like the following
1
{
2
"response": "Transmisi Info Detil Pembelian",
3
"trx_id": "9999981200980185",
4
"merchant_id": "99999",
5
"merchant": "FASPAY STORE",
6
"bill_no": "20201222024304",
7
"bill_items": {
8
"id": "A001",
9
"product": "Invoice #2286704",
10
"qty": "1",
11
"amount": "100000",
12
"payment_plan": "01",
13
"merchant_id": "99999",
14
"tenor": "00"
15
},
16
"response_code": "00",
17
"response_desc": "Sukses",
18
"redirect_url" : "https://dev.faspay.co.id/pws/100003/0830000010100000/92c41cf28825f8065530f09726b3c6f0bd2e218e?trx_id=9999981200980185&merchant_id=99999&bill_no=20201222024304"
19
}
Copied!

2. Push To Pay

Push to Pay is a proccess to push ovo's customer number
There's two option to do this process :
  • Redirect to faspay's page so the customer can input the ovo's number and submit to ovo's side, to do this just use redirect_url that retrieved from Post Data Transaction response (JSON Format) or follow the detail API reference Here
  • Create your own page so the customer can input the ovo's number on merchant's website and submit it to faspay.
How to Submit ovo's number to faspay will explained bellow :
After Post data transaction proccess please post detail bellow to faspay's URL Endpoint
Environment
URL Endpoint
Parameter
Type
Description
trx_id
Alfanumeric
transaction unix id from post data transaction
ovo_number
Numercit
customer's number already register on OVO
signature
Alfanumeric
sha1(md5(user_id.password.trx_id))
Sample code for Push To Pay from merchant's side
1
<?php
2
3
4
$user_id = 'bot12345';
5
$passw = '[email protected]';
6
$trx_id = '9999981256572178';
7
$signature = sha1(md5($user_id.$passw.$trx_id));
8
9
$post = array('trx_id' => $trx_id,
10
'ovo_number' => '08817482255',
11
'signature' => $signature
12
13
);
14
15
$string = '<form method="post" name="form" action="https://dev.faspay.co.id/pws/ovo_direct">';
16
if ($post != null) {
17
foreach ($post as $name=>$value) {
18
$string .= '<input type="hidden" name="'.$name.'" value="'.$value.'">';
19
}
20
}
21
22
23
$string .= '</form>';
24
25
$string .= '<script> document.form.submit();</script>';
26
27
echo $string;
28
exit;
29
30
31
?>
Copied!

3. Callback/Return URL

After the customer completes the payment via OVO's apps, faspay 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

4. 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
Last modified 11mo ago
Copy link