接入 Bitget Wallet Pay 支付能力

本章描述如何间接或直接唤起 Bitget Wallet Pay，让用户体验提升更上一层楼。

1. 如何直接接入唤起 Bitget Wallet Pay

从视频上看，用户只需输入金额并点击按钮，就可以直接唤起 Bitget Wallet Pay，过程丝滑。

当然，你也可以在站外打开。

1.1 完整接入Bitget Wallet Pay流程

实现唤起 Bitget Wallet Pay 的前提是需要接入 Bitget Wallet Pay接口文档。
具体流程：商户侧发起支付 ->Bitget Wallet Pay->支付成功->回调链接。
商户可以通过接入回调实现，实时监听订单状态。

1.1.1 创建BGW订单

创建订单接口文档，参数较多，接入方如何控制订单走 Bitget Wallet Pay 呢？答案的关键是 payMethod1 字段，它需要传入 BGW。


// js 伪代码
// 假设你已有以下变量：
const appId = 'your_app_id';
const mchTxnId = '商户侧订单ID';
const apiKey = 'your_api_key'; // x-api-key
const apiSecret = 'your_api_secret'; // 用于签名的密钥
const url = 'https://api.paydify.com/payment/payin/v1/createPayment';
const requestBody = {
  appId,
  mchTxnId,
  txnAmount: '100.00',
  currency: 'USDT',
  checkoutMode: 1,
  payMethod1: 'BGW'
};
fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': apiKey,
      'x-api-timestamp': timestamp,
      'x-api-signature': signature
    },
    body: bodyString
  })
   .then(res => res.json())
    .then(data => {
      console.log('创建支付返回：', data);
      if (data.status === 0) {
        // 可跳转到支付链接
        window.location.href = data.data.httplink;
      } else {
        console.error('支付失败:', data.msg);
      }
    })

在创建订单成功后，会返回 deeplink 和 httplink 两种字段来唤起 Bitget Wallet Pay。那么 deeplink 和 httplink 的区别又是什么

1.1.2 唤起收银台

deeplink 是一个 bitkeep:// 开头的协议，无法通过 href 或 window.open 等方式打开。如果商户在站内，商户可安装 @bitget-wallet/utils 依赖用于跳转 deeplink 唤起收银台。如果商户在站外，需要使用 Bitget Wallet deeplink 唤起app并打开收银台。具体demo代码如下


import { transfer } from "@bitget-wallet/utils";
const link = data.deeplink;
if (/(BitKeep)/i.test(navigator.userAgent)) {
  // 站内
  transfer(link);
} else {
  // 站外
  window.open(`https://bkcode.vip/?deep_link_value=${link}`, "_blank");
}

如果觉得上述步骤麻烦，可以直接使用 httplink 唤起收银台，但是相比 deeplink 会稍慢


 const link = data.deeplink
 window.open(link, '_blank')

2 支付提交

支付提交后会进入订单状态页，实时获取支付结果。

2.1 查看订单详情

在历史订单中查看订单详情

Preview

2.2 如何查看历史订单

可以分别通过 payHome 和购物中心进入历史订单

Preview