ShopeePay Jump App Integration Guide

The basic integration process of ShopeePay QRIS channel will be explained below.

Integration Step

1. Post Data Transaction to Faspay

2. Redirect to ShopeePay App

3. Callback/Return URL

4. Payment Notification

1. Post Data Transaction

Post data transaction should be done from merchant backend, the detailed API reference can be found Here

This is an example of post data transaction for ShopeePay Jump App channel

{
   "request": "Post Data Transaction",
   "merchant_id": "99999",
   "merchant": "Sophia Store",
   "bill_no": "20201222024626",
   "bill_reff": "20200324_02-2286704_336",
   "bill_date": "2020-12-19 06:04:29",
   "bill_expired": "2020-12-19 07:04:29",
   "bill_desc": "Payment Online Via Faspay",
   "bill_currency": "IDR",
   "bill_gross": "100000",
   "bill_miscfee": "100000",
   "bill_total": "200000",
   "cust_no": "01",
   "cust_name": "John Doe",
   "payment_channel": "713",
   "pay_type": "01",
   "msisdn": "8562927907",
   "email": "[e-mail]",
   "terminal": "10",
   "billing_address": "Jl Sabang 37",
   "billing_address_city": "Jakarta",
   "billing_address_region": "DKI Jakarta",
   "billing_address_state": "Indonesia",
   "billing_address_poscode": "10170",
   "billing_address_country_code": "ID",
   "receiver_name_for_shipping": "John Doe",
   "shipping_address": "Jl. Sabang 37",
   "shipping_address_city": "Jakarta",
   "shipping_address_region": "DKI Jakarta",
   "shipping_address_state": "Indonesia",
   "shipping_address_poscode": "10170",
   "item": {
      "id": "A001",
      "product": "Invoice #2286704",
      "qty": "1",
      "amount": "100000",
      "payment_plan": "01",
      "merchant_id":"99999",
      "tenor": "00"
   },
   "reserve1": "",
   "reserve2": "",
   "signature": "676a826d180a0a6cad33ff58c09a2377893850ca"
}

B. Post Data Transaction Response

You will get the post data response like the following

{
   "response": "Transmission of Purchase Detail Info",
   "trx_id": "7139999900001222",
   "merchant_id": "99999",
   "merchant": "Sophia Store",
   "bill_no": "20201222024626",
   "bill_items": {
      "id": "A001",
      "product": "Invoice #2286704",
      "qty": "1",
      "amount": "100000",
      "payment_plan": "01",
      "merchant_id": "99999",
      "tenor": "00"
   },
   "response_code": "00",
   "response_desc": "Success",
   "deeplink": "shopeeid://main?apprl=%2Frn%2FTRANSFER_PAGE%3Fnavigate_url%3Dhttps%253A%252F%252Fwsa.uat.wallet.airpay.co.id%252Fwallet%252Fpay%253Ftoken%253DdFhkbmR1bTBIamhWlQPIZ0f7oKyb2LpWA2bjwpjSd0LzNudnDjHVBQmeh8s",
   "web_url": "https://wsa.uat.wallet.airpay.co.id/universal-link/wallet/pay?deep_and_deferred=1&token=dFhkbmR1bTBIamhWlQPIZ0f7oKyb2LpWA2bjwpjSd0LzNudnDjHVBQmeh8s",
   "redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/676a826d180a0a6cad33ff58c09a2377893850ca?trx_id=7139999900001222&merchant_id=99999&bill_no=20201222024626"
}

2. Redirect to ShopeePay App

To redirect customer to ShopeePay app, use the URL (deeplink/web_url) retrieved from post data transaction API response. Then customer can be redirected via server-side redirect, using javascript like window.location=[deeplink], or using an HTML link <a href="[web_url]">Pay with ShopeePay</a>.

3. Callback/Return URL

After the customer completes the payment via ShopeePay's apps, Faspay automatically redirect customer to callback/return URL. Please provide the URL and make sure it's already registered on Faspay system. For the detailed reference can be found Here

4. Payment Notification

Payment notification from Faspay to Merchant backend will also be triggered in event of transaction status getting updated, to ensure merchant is securely informed. Please provide the URL and make sure it's already registered on Faspay system

The detailed API reference can be found here