获取authorization
- {domain}/online/v3/secure-pay
Request
参数名 |
M/C/O |
描述 |
callbackUrl |
O |
客户端网页同步回调地址,支付完成后同步跳转,显示支付结果 |
ipnUrl |
M |
交易结果异步通知地址 |
amount |
M |
金额,字符串 |
currency |
M |
标价币种 |
settleCurrency |
M |
结算币种 |
description |
O |
订单描述 |
note |
O |
附言 |
reference |
M |
商户系统交易请求流水号 |
terminal |
M |
交易类型 |
vendor |
M |
支付/收款方式 |
verifySign |
API请求签名 |
|
{
"amount": "100",
"callbackUrl": "https://example.com/webhook?transactionNo={transactionNo}&status={status}&amount={amount}&time={time}&reference={reference}¬e={note}",
"currency": "USD",
"description": "029e9b9b0b4e5cae68bf559b6333f466",
"ipnUrl": "https://example.com/webhook",
"merchantNo": "202333",
"note": "029e9b9b0b4e5cae68bf559b6333f466",
"reference": "029e9b9b0b4e5cae68bf559b6333f466",
"settleCurrency": "USD",
"storeNo": "301854",
"terminal": "YIP",
"vendor": "creditcard",
"verifySign": "ece4311b16c46435af3fb974ddbc2d43"
}
Response
- authorization是用来在付款页面调用braintree js sdk,用户填信用卡信息
- HTML付款页面示例
参数名 |
M/C/O |
描述 |
authorization |
M |
令牌,用于调用braintree JS SDK |
transactionNo |
M |
订单号 |
{
"result":
{
"amount": "100.00",
"authorization": "eyJraWQiOiJ6dSIsImFsZyI6IlJTMjU2In0.eyJmbHgiOnsicGF0aCI6Ii9mbGV4L3YyL3Rva2VucyIsImRhdGEiOiJkVnc4amZSc2ZFQVI2VWlyVFBWcVhCQUFFR09OZkVZZmNxVjZyeUttOHU4LzhYVnZzN01Edmt1NzBCQXZxR09zSWZVOVcwT21KNVVWM3N6bHIxekh5K01RMWxQMDZZYnh4Y0Y3cDhnUWVOeUhhaEZNamUxQnBydW5tMVppYjZnWDA3amQiLCJvcmlnaW4iOiJodHRwczovL3Rlc3RmbGV4LmN5YmVyc291cmNlLmNvbSIsImp3ayI6eyJrdHkiOiJSU0EiLCJlIjoiQVFBQiIsInVzZSI6ImVuYyIsIm4iOiJzUnR5Y0lvcU1aRmVEMGM2bG9VbFZ4NWdoaDlLX0w5bm11dllhdkRVVV9TdTVHRGFmZmt4NGRqM0MzQ2pwRlZMUkFrdXJ4LTYxd0U3ZlJ6RTJLY3F0QlZsdWQxbTdKdXFISVdxU0tPRlNEQkJROFp5TVBIUV9HRktXQjdVZjhWWWtGOGs3M19FWm91Sl9xODhsM2RqeGFucnZkbGdKZ3hGdE5JYjNadkdpQnRWVzdCMGdrQ1FFejdURnhRdURUVGZNcXNNUVJIUV9qRDlPUnZ1Uk1USWItOHBsaXQzZzJpTkxVOGg1dVBibGw1SHFpeG5PdTgybUhQRzhDeUpqQ3VWeEp3WFVkNGpSR3lGOURCM0k5SzFzNDEtbjNLdm83UWo1VXBPdl9PWm9GODAtNVBqTEpEYldmYm5sWExwTmxJXzU4TE5xWkI4Xzlua3hjV2UwcTY2b3ciLCJraWQiOiIwOFFHcmRRUkY3amJGRTBqTlIwMlBJSVFXMWpxM25BdyJ9fSwiY3R4IjpbeyJkYXRhIjp7ImNsaWVudExpYnJhcnkiOiJodHRwczovL3Rlc3RmbGV4LmN5YmVyc291cmNlLmNvbS9taWNyb2Zvcm0vYnVuZGxlL3YxL2ZsZXgtbWljcm9mb3JtLm1pbi5qcyIsInRhcmdldE9yaWdpbnMiOlsiaHR0cHM6Ly9tYXBpLnl1YW5zZmVyLnl1bmtlZ3Vhbi5jb20iLCJodHRwczovL2NuMi5idXhpdWR1bi5jb20iLCJodHRwczovL3Quc2VhcGlnLmNvIl0sIm1mT3JpZ2luIjoiaHR0cHM6Ly90ZXN0ZmxleC5jeWJlcnNvdXJjZS5jb20ifSwidHlwZSI6Im1mLTEuMC4wIn1dLCJpc3MiOiJGbGV4IEFQSSIsImV4cCI6MTY2NjIzODk3NiwiaWF0IjoxNjY2MjM4MDc2LCJqdGkiOiJYZDRERkpjbWhhTlFDelZ5In0.NdmRXIJEFqOFbYudB3Cm7xky5bqu5TiXnliGizaMbe3MvrnuHmEjmWo_eS4tjeUbDvx6iw8T2hDnnJEZXf6B6UKhTM5n40tl8mh4k0Rp-JXsvKeG-rvfzuN6IpPAdFwfKxGvAFahT5_hv38l0TjKlr_4eJs-LR-F3WY_-FmnUmbZMVzGvNPE01g_JB77j1l48hSbjv7uV3PR5_3j40cqRsQe2OTgutJxen7p2JrVcURHYKs1vZNG5o8nyXo06rIQKCZU4FR0lF2RymO336IjcjLMQebvVGFndSB7KnODQru9f4qAwzSkYCxLSUa0p7U7DdRIldOsw4-svP70-NKLBQ",
"currency": "USD",
"reference": "029e9b9b0b4e5cae68bf559b6333f466",
"timestamp": "2022-10-20T03:54:36Z",
"transactionNo": "302605577756087512"
},
"ret_code": "000100",
"ret_msg": "success"
}
确认付款
- {domain}/creditpay/v3/process
Request
name |
value |
Credit Card |
credit_card |
PayPal |
paypal_account |
Venmo |
venmo_account |
Google Pay |
android_pay_card |
Apple Pay |
apple_pay_card |
SAMSUNG Pay |
samsung_pay_card |
参数名 |
M/C/O |
描述 |
deviceData |
M |
braintree sdk获取到的客户端设备信息,参见html示例代码| |
paymentMethod |
M |
支付方式 |
paymentMethodNonce |
M |
支付令牌,从braintree sdk获取得到 |
transactionNo |
M |
订单号,从secure-pay返回得到 |
addressLine1 |
O |
address line 1 |
addressLine2 |
O |
address line 2 |
city |
O |
city |
state |
O |
state |
postalCode |
O |
邮编 |
country |
O |
country |
countryCode |
O |
countryCode, e.g. CN |
email |
O |
email |
firstName |
O |
firstName |
lastName |
O |
lastName |
{
"addressLine1": "123 main st",
"addressLine2": "",
"city": "Hometown",
"country": "United States of America",
"countryCode": "US",
"deviceData": "{\"correlation_id\":\"536e2d7c63f918ae8b2eb0cb5ee1eee3\"}",
"email": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"merchantNo": "202333",
"paymentMethod": "credit_card",
"paymentMethodNonce": "tokencc_bf_ks72qn_fwtdcm_56ynkm_ckx8n2_2z2",
"postalCode": "90012",
"state": "CA",
"storeNo": "301854",
"transactionNo": "302607078131745403",
"verifySign": "91a7786e708668ca35a5197bbea237cc"
}
Response
{
"result":
{
"reference": "31d59e06821dbf31e14569f44bac976a",
"amount": "100.00",
"supUserid": "1111",
"transactionNo": "302607078131745403",
"vendorId": "b2sewrxq",
"currency": "USD",
"paymentTime": "2022-10-20T04:19:56Z",
"status": "success"
},
"ret_msg": "success",
"ret_code": "000100"
}