注意

API计划在未来的版本移除，建议对接新版的签约接口。

请求地址

POST https://sandbox-acquirer-payment.pingpongx.com/v4/authorization/prepare

POST https://acquirer-payment.pingpongx.com/v4/authorization/prepare

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

请求参数

公共请求参数

暂无数据

请求参数

字段名称	类型	必填	描述
requestId	String(64)	M	唯一请求号
merchantUserId	String(256)	M	会员ID，用户在商户网站的会员ID
payMethod	String	M	支持的枚举: Boost GCash TNG eWallet DANA Kakaopay True Money AlipayHK Alipay Rabbit LINE Pay
authRedirectUrl	String(255)	M	授权完成重定向地址
notifyUrl	String(255)	M	商户通知地址
device.orderTerminal	Object	M	设备参数： 01-H5 02-PC 04-IOS 05-ANDROID

请求示例

{
 "accId": "2023042011040310224447",
 "clientId": "2023042011040310224",
 "signType": "SHA256",
 "sign": "{{Sign}}",
 "version": "1.0",
 "bizContent": {
  "requestId": "{{requestId}}",
  "merchantUserId": "12604896051315",
  "payMethod": "AlipayHK",
  "authRedirectUrl": "https://www.baidu.com",
  "notifyUrl":"https://test-auth-Debit.pingpongx.com/qa/result.html",
  "device": {
   "orderTerminal": "02"
  }
 }
}

响应参数

参数字段	参数属性	参数说明
sign	M	签名值
bizContent.authUrl	O	认证链接
signType	M	签名方式
code	O	结果状态码
description	O	结果描述

响应示例

{
 "bizContent": "{\"authUrl\":\"https://g.alipayplus.com/page/aplus-linker/acwallet/authorization.html?scopes=AGREEMENT_PAY%2CUSER_LOGIN_ID&bizContent=%7B%22acquirerId%22%3A%22Z02TE5520000000A%22%2C%22authClientDisplayName%22%3A%22test%22%2C%22authClientId%22%3A%222023042011040310224%22%2C%22authClientName%22%3A%22szh%22%2C%22authRedirectUrl%22%3A%22https%3A%2F%2Fg.alipayplus.com%2Fpage%2Fac-auth-payment%2Fresult%2Fmobile%2Findex.html%3FloadMode%3D2%26callbackType%3DCommon%26terminalType%3DWEB%26referenceAgreementId%3D1694413063671527%26authRequestId%3D2023091119091305000450000302302%26pspId%3D102216000000000000A%26clientId%3DT_4GGO000000000001%22%2C%22authState%22%3A%221694413063671527%22%2C%22customerBelongsTo%22%3A%22ALIPAY_HK%22%2C%22pspId%22%3A%22102216000000000000A%22%2C%22referenceAgreementId%22%3A%221694413063671527%22%2C%22referenceMerchantId%22%3A%222023042011040310224%22%2C%22scopes%22%3A%5B%22AGREEMENT_PAY%22%2C%22USER_LOGIN_ID%22%5D%2C%22terminalType%22%3A%22WEB%22%7D&source=AlipayConnect&needCallback=false\"}",
 "sign": "2F901F145332A2EBBD37771355DD299979507077AF03E991ABC25EBB9EC626AA",
 "signType": "SHA256"
}