docs/braintree.md

# 获取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|M|API请求签名|

```json
{
    "amount": "100",
    "callbackUrl": "https://example.com/webhook?transactionNo={transactionNo}&status={status}&amount={amount}&time={time}&reference={reference}&note={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付款页面示例](./static/braintree-sample.html)

|参数名|M/C/O|描述|
|---|---|---|
|authorization|M|令牌，用于调用braintree JS SDK|
|transactionNo|M|订单号|

```json
{
    "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|

```json
{
    "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

```json
{
    "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"
}
```