钱包支付的流行，现在很多钱包也支持订阅支付。比如中国的支付宝和微信，马来西亚的Boost和Touch 'n Go等；

电子钱包一键支付是一种自动扣款工具，通常用于数字钱包或移动支付应用程序中。当用户允许这种功能时，钱包应用程序会从其绑定的银行账户或信用卡中自动扣除所需金额来支付特定的账单或交易。这种方式可以帮助用户避免忘记付款或延迟还款，同时也更加方便快捷。

• 优点：使用简单，用户通过钱包授权后，可由商户自行维护计划，定期来请求扣款。不支持chargeback
• 缺点：欧美国家覆盖不足（欧美主要使用信用卡，钱包使用不多）

已支持的电子钱包

钱包名	支持验证方式	Token有效期	限额
Boost	APP: 重定向授权 WAP: 登录授权 Web: 扫描授权	长期	每笔交易限额 RM 1,000 月交易限额 RM 2,000
GCash	APP: 重定向授权 WAP: 登录授权 Web: 扫描授权	两年	账户类型 每日支出限额 每月支出限额 Basic 无支出限制 PHP 10,000 Fully Verified 无支出限制 PHP 100,000 GCash Jr. PHP 10,000 PHP 10,000 GCash Plus/Enterprise PHP 100,000 无支出限制 Platium PHP 500,000 PHP 1,000,000
TNG eWallet	APP: 重定向授权 WAP: 登录授权 Web: 扫描授权	两年	方案 月交易限额 年度交易限额 Lite RM 2,000 RM 24,000 Pro RM 5,000 RM 60,000 Premium RM 25,000 RM 300,000
DANA	APP: 重定向授权 WAP: 登录授权 Web: 扫描授权	十年	账户类型 每笔交易限额 每日交易限额 KYC IDR 10,000,000 IDR 20,000,000 NonKYC IDR 2,000,000 IDR 20,000,000
Kakao Pay	APP: 重定向授权 Web: 扫描授权	长期	单笔交易限：KRW 2,000,000
TrueMoney Wallet	APP: 重定向授权 WAP: 登录授权 Web: 扫描授权	两年	KYC Level 每笔交易限额 每日限额 每月限额 KYC 2.5 (Online) THB 10,000 / THB 50,000 KYC 3.1 (Online) THB 30,000 THB 50,000 / KYC 3.1 (Offline) THB 10,000 THB 10,000 / KYC 4 (Online) THB 30,000 THB 50,000 / KYC 4 (Offline) THB 50,000 THB 100,000 /
AlipayHK	APP: 重定向授权 Web: 扫描授权	长期	方案 每笔交易限额 年度交易限额 Lite HKD 3,000 HKD 25,000 Pro HKD 5,000 HKD 100,000 Premium HKD 50,000 HKD 200,000
Alipay	APP: 重定向授权 Web: 扫描授权	长期	支付宝的付款限额取决于商家与支付宝的业务协议。根据风险管理政策，默认情况下，每笔交易的限额为人民币500元。
Rabbit LINE Pay	APP: 重定向授权 WAP: 登录授权 Web: 扫描授权	长期	最高交易额（每笔） THB 50,000

对接流程

授权流程

以下是需要集成的API清单

认证接口
授权接口

1. 调用 认证接口 获取钱包认证链接，用户访问认证链接完成认证之后跳转到重定向地址，商家获取重定向地址里面的授权码code；
2. 调 授权接口 ，传入第一步获取的code，获取支付凭证token；
   
   

• 绑定操作步骤如下图所示：
  
  
  
  
  

支付流程

以下是需要集成的API清单

统一下单接口

调 统一下单接口 传入token和bizType。

关键入参:

参数名	类型	是否必填	描述
tokenDetail.token	String	M	已有字段，传 授权接口 获取的token
bizType	String	M	已有字段，新增类型标识认证授权,固定传"CodeGrant"
merchantUserId	String	M	会员ID，用户在商户网站的会员ID

调用下单接口的时候入参中必须要传入merchantUserId，并且要和认证的时候传入的merchantUserId一致，否则会报错token不存在

统一下单接口入参示例如下：

{
  "acquirerType": "PAY",
  "requestId": "{{requestId}}",
  "clientId": "2023042011040310224",
  "merchantUserId": "12604896051315",
  "accId": "2023042011040310224447",
  "amount": "3",
  "currency": "HKD",
  "tradeCountry":"HK",
  "tokenDetail": {
    "token": "1395b9f2304aaddedca0e7abcf3ffcf7a31502fd068d227437aa101a2ade50dd"
  },
  "paymentBrand": "AlipayHK",
  "bizType": "codeGrant",
  "merchantTransactionId": "{{merchantTransactionId}}",
  "paymentType": "DEBIT",
  "notificationUrl": "https://osdev.tke.midas.qq.com/card_payment_notify/pingpong/2018092714313010016147",
  "shopperResultUrl": "https://qq.com",
  "threeDSecure": "N",
  "jsGeneratedData": "",
  "billing": {
    "firstName": "Jamesbb",
    "lastName": "LeBronbb",
    "phone": "99023923023",
    "email": "3ds@pingpongx.com",
    "street": "收货人街道地址111111",
    "postcode": "0000000",
    "city": "Miami",
    "state": "FL",
    "country": "HK"
  },
  "signType": "SHA256",
  "sign": "{{Sign}}",
  "payType": "APM"
}

其他同现有APM支付参数即可

• 绑后支付操作步骤如下：
  
  
  
  
  

取消授权

发起取消授权有两种情况：

• 商户端调用API取消授权
• 钱包用户可以在钱包侧取消授权。

以下是需要集成的API清单

取消授权接口

如果需要取消授权，可以调 取消授权接口 ，取消之后token将会失效。

查询接口

支持两种场景的查询：

• 场景一：根据Token查Token详细信息；
• 场景二：根据MerchantUserID查该用户已绑定的Token (Array)。

以下是需要集成的API清单

查询接口

异步通知

以下三种情况会触发异步通知：

1. 用户授权成功；
2. 商家主动发起取消授权；
3. 用户在钱包侧发起取消授权。

参数必填属性说明:必填(M)，可选(O)，条件必填(C)。 POST JSON

参数字段	参数类型	参数属性	参数说明
clientId	String	M	PingPong 商户商户号
accId	String	M	PingPong定义的商户店铺唯一编号
merchantUserId	String	M	会员ID，用户在商户网站的会员ID
payMethod	String	M	支付方式
token	String	M	取消授权的token
notifyType	String	M	可能的值： ACCESS_TOKEN_CREATION-授权成功 ACCESS_TOKEN_CANCEL_OF_MERCHANT-商家主动发起取消授权 ACCESS_TOKEN_CANCEL_OF_MERCHANT_USER-用户在钱包侧发起取消授权
userLoginId	String	C	用户在钱包侧被脱敏的用户标识

当http code 为200的时候，表明商户已经收到报文，商户无需返回额外信息。 响应报文异常重试2次

通知内容示例：

{
  "clientId": "2020020315464510119",
  "accId": "2020020315464510119001",
  "merchantUserId": "12604896051315",
  "payMethod": "AlipayHK",
  "token": "0f002e9a4016c0e15246f76772f0a1995455ddfb1b9c6fe642ddb4efbfae81b9",
  "notifyType": "ACCESS_TOKEN_CREATION", 
  "userLoginId": "847***@qq.com"
}

{
  "clientId": "2020020315464510119",
  "accId": "2020020315464510119001",
  "merchantUserId": "12604896051315",
  "payMethod": "AlipayHK",
  "token": "0f002e9a4016c0e15246f76772f0a1995455ddfb1b9c6fe642ddb4efbfae81b9",
  "notifyType": "ACCESS_TOKEN_CANCEL_OF_MERCHANT" 
}

{
  "clientId": "2020020315464510119",
  "accId": "2020020315464510119001",
  "merchantUserId": "12604896051315",
  "payMethod": "AlipayHK",
  "token": "0f002e9a4016c0e15246f76772f0a1995455ddfb1b9c6fe642ddb4efbfae81b9",
  "notifyType": "ACCESS_TOKEN_CANCEL_OF_MERCHANT_USER"
}

// Make sure to add code blocks to your code group