Deeplink

Deeplink (gọi đầy đủ là mobile deep link) là một công nghệ di động, hoạt động tương tự như đường dẫn website (URL). Deeplink này giúp điều hướng từ một ứng dụng di động (hoặc một website) tới một ứng dụng tài chính mà khách hàng muốn sử dụng để thanh toán và khi khách hàng thanh toán xong thì sẽ điều hướng trở lại ứng dụng của bạn.

Tài liệu về API

Chi tiết Deeplink yêu cầu, phản hồi và code mẫu

Xem chi tiết Deeplink API

Bắt đầu

Tìm hiểu về các thông tin để triển khai và cách thức hoạt động.

Bắt đầu

Các bước tích hợp Deeplink

Dưới đây là các bước để tích hợp Deeplink vào sản phẩm của bạn.

1. Lấy danh sách ứng dụng tài chính hỗ trợ deeplink /deeplink/apps.

2. Tạo một deeplinkUrl thanh toán dựa theo thông tin người nhận và ứng dụng muốn dùng để thanh toán. Xem chi tiết

3. Mở deeplinkUrl từ kết quả của API trên cho khách hàng của bạn.

4. Ứng dụng tài chính sẽ được mở và các thông tin thanh toán sẽ tự động được điền (với ứng dụng có trường autofill=1)

5. Khách hàng thanh toán thành công thì ứng dụng tài chính sẽ tự động hoặc nút bấm điều hướng về ứng dụng của bạn (với ứng dụng có trường autofill=1).

Gọi API

Lấy danh sách ứng dụng tài chính hỗ trợ deeplink

CURL

curl --location 'https://sandbox.bankhub.dev/deeplink/apps' \
--header 'X-BankHub-Api-Version: 2023-01-01' \
--header 'x-client-id: <CLIENT_ID_HERE>' \
--header 'x-secret-key: <SECRET_KEY_HERE>' \
--header 'Content-Type: application/json' \

Javascript (Axios)

 const axios = require('axios');

 let config = {
   method: 'get',
   maxBodyLength: Infinity,
   url: 'https://sandbox.bankhub.dev/deeplink/apps',
   headers: { 
     'Accept': 'application/json', 
     'x-client-id': '<x-client-id>', 
     'x-secret-key': '<x-client-id>'
   }
 };

 axios.request(config)
 .then((response) => {
   console.log(JSON.stringify(response.data));
 })
 .catch((error) => {
   console.log(error);
 });

thông tin

Xem chi tiết API, tại đây

Tạo deeplink thanh toán

CURL

  curl --location 'https://sandbox.bankhub.dev/deeplink' \
  --header 'X-BankHub-Api-Version: 2023-01-01' \
  --header 'x-client-id: <CLIENT_ID_HERE>' \
  --header 'x-secret-key: <SECRET_KEY_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
        "app": "ocb",
        "payeeAddress": "113366668888@icb",
        "payeeName": "NGUYEN VAN A",
        "amount": 1000,
        "transactionNote": "BH433423 test",
        "redirectUrl": "loathanhtoan://"
    }'

Javascript (Axios)

  const axios = require('axios');
  let data = JSON.stringify({
    "app": "ocb",
    "payeeAddress": "113366668888@icb",
    "payeeName": "NGUYEN VAN A",
    "amount": 1000,
    "transactionNote": "BH433423 test",
    "redirectUrl": "loathanhtoan://"
  });

  let config = {
    method: 'post',
    maxBodyLength: Infinity,
    url: 'https://sandbox.bankhub.dev/deeplink',
    headers: { 
      'Content-Type': 'application/json', 
      'Accept': 'application/json', 
      'x-client-id': '<x-client-id>', 
      'x-secret-key': '<x-client-id>'
    },
    data : data
  };

  axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

thông tin

Xem chi tiết API, tại đây