# 扫码支付

## 产品说明

用户扫描商户展示在各种场景的二维码进行支付。

1. 商户根据微信支付的规则，为不同商品生成不同的二维码，展示在各种场景，用于用户扫描购买。步
2. 用户使用微信“扫一扫”扫描二维码后，获取商品支付信息，引导用户完成支付
3. 用户确认支付，输入支付密码
4. 支付完成后会提示用户支付成功（如图6.5），商户后台得到支付成功的通知，然后进行发货处理。

![](https://2528669792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWJY3r4PKWU5CQc2DBztL%2Fuploads%2F7cDEULpAcrat1GcERNt0%2Fimage.png?alt=media\&token=08b6ed3b-a15f-4280-abfd-8fcc7f671598)

![](https://2528669792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWJY3r4PKWU5CQc2DBztL%2Fuploads%2FBGSJsWIy5Ta9WOyyCqDB%2Fimage.png?alt=media\&token=eef00f0f-c28b-4e92-869d-b01f5ddace26)

## 业务流程说明

1. 商户后台系统根据用户选购的商品生成订单。
2. 用户确认支付后调用UseePay微信支付（Server To Server）生成预支付交易；
3. 微信支付系统收到请求后生成预支付交易单，并返回交易会话的二维码链接code\_url。
4. 商户后台系统根据返回的code\_url生成二维码。
5. 用户打开微信“扫一扫”扫描二维码，完成支付
6. UseePay 异步通知(notifyUrl)商户系统订单完成
7.  未收到支付通知的情况，商户后台系统调用[【查询订单API】](https://useepay.gitbook.io/developer/reference/api-reference-xin-yong-ka/order/order-detail)
8. 商户确认订单已支付后给用户发货

## 微信扫码支付wechat\_native

<mark style="color:green;">`POST`</mark> `USEEPAY_PATH/api`

#### Headers

| Name                                           | Type   | Description                       |
| ---------------------------------------------- | ------ | --------------------------------- |
| content-type<mark style="color:red;">\*</mark> | String | application/x-www-form-urlencoded |

#### Request Body

| Name                                              | Type         | Description                                                                                                                 |
| ------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| transactionType<mark style="color:red;">\*</mark> | String       | <p></p><p></p><p>交易类型 : <strong>pay</strong> </p>                                                                           |
| version<mark style="color:red;">\*</mark>         | String(5)    | 目前固定为 1.0 (5)                                                                                                               |
| signType<mark style="color:red;">\*</mark>        | String       | 商户生成签名字符串所使用的签名算法类型，目前支持：RSA/MD5                                                                                            |
| merchantNo<mark style="color:red;">\*</mark>      | String(16)   | 商户号                                                                                                                         |
| transactionId<mark style="color:red;">\*</mark>   | String(64)   | 商户订单号                                                                                                                       |
| transactionExpirationTime                         | String(6)    | 可选，默认为20分钟 .范围1-20                                                                                                          |
| appId<mark style="color:red;">\*</mark>           | String (128) | 网站域名                                                                                                                        |
| amount<mark style="color:red;">\*</mark>          | String(12)   | 支付金额，单位为对应币种的最小货币单位[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei)              |
| currency<mark style="color:red;">\*</mark>        | String(3)    | 3 位 ISO 大写字母货币代码[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei) 目前仅支持HKD        |
| notifyUrl<mark style="color:red;">\*</mark>       | String(512)  | [异步通知](https://useepay.gitbook.io/developer/reference/notify/notifyurl)                                                     |
| echoParam                                         | String(256)  | 回声参数，响应报文会原样返回                                                                                                              |
| payerInfo<mark style="color:red;">\*</mark>       | String       | Json格式的String 付款方信息, 请下方                                                                                                    |
| orderInfo                                         | String       | json string, 订单信息, 请参考下方                                                                                                    |
| userInfo                                          | String       | json string, 消费者信息, 请参考[消费者信息](https://useepay.gitbook.io/developer/reference/api-reference/parameter-description#userinfo) |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "codeUrl": "weixin://wxpay/bizpayurl?pr=qCJcd2azz",
    "amount": "2",
    "resultCode": "pending",
    "sign": "1213b8dd73dff60c62e6c12d7000d32f",
    "errorCode": "3200",
    "transactionId": "202201180239183",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012201181439650764",
    "echoParam": "echoParam",
    "signType": "MD5",
    "currency": "HKD",
    "merchantNo": "500000000007264"
}
```

{% endtab %}
{% endtabs %}

## 请求参数详情说明

### payerInfo

| 参数                                | 必选 | 类型          | 说明                   |
| --------------------------------- | -- | ----------- | -------------------- |
| paymentMethod                     | Y  | String      | 目前固定为 wechat\_native |
| authorizationMethod               | Y  | String      | 固定为 cvv              |
| [billingAddress](#billingaddress) | N  | Json String | 账单地址                 |

### orderInfo

| 参数              | 必选 | 类型          | 说明                                                                                                                                                              |
| --------------- | -- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| subject         | Y  | String（128） | 订单标题，可以是商品名称                                                                                                                                                    |
| goodsInfo       | N  | array       | 商品信息, 请参考 [goodsInfo](https://useepay.gitbook.io/developer/reference/local-pay-ben-di-hua/ben-di-hua-jie-kou/dian-zi-qian-bao/wechat-hk/broken-reference)       |
| shippingAddress | N  | object      | 收货地址, 请参考 [shippingAddress](https://useepay.gitbook.io/developer/reference/local-pay-ben-di-hua/ben-di-hua-jie-kou/dian-zi-qian-bao/wechat-hk/broken-reference) |

## 返回参数说明

| 字段              | 是否必须 | 描述                                                                                                                                             |
| --------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| codeUrl         | N    | wechat支付url, 当请求成功时存在                                                                                                                          |
| amount          | Y    | 订单金额                                                                                                                                           |
| currency        | Y    | 3 位 ISO 大写字母货币代码[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei)                                    |
| errorCode       | Y    | 错误码（详见 错误码 errorCode）                                                                                                                          |
| errorMsg        | Y    | 错误码消息描述                                                                                                                                        |
| echoParam       | N    | 回声参数，响应报文会原样返回                                                                                                                                 |
| sign            | Y    | 签名                                                                                                                                             |
| transactionId   | Y    | 商户订单号                                                                                                                                          |
| transactionType | Y    | 支付类型 pay                                                                                                                                       |
| reference       | N    | USEEPAY 订单号                                                                                                                                    |
| resultCode      | Y    | 业务结果（详见 [业务结果码](https://useepay.gitbook.io/developer/reference/resultcode)）**判断交易是否成功的依据** 当前交易涉及的&#x6709;**:** succeed,pending,failed, closed |

## 时序图

![](https://2528669792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWJY3r4PKWU5CQc2DBztL%2Fuploads%2FYJAxvFt2SDOkulrwYDsP%2F%E6%94%AF%E4%BB%98%E6%97%B6%E5%BA%8F%E5%9B%BE.jpg?alt=media\&token=b53ec336-394c-4fe0-ad7a-410f232ed9f7)

商户也可以调用[UseePay订单查询](https://useepay.gitbook.io/developer/reference/api-reference-xin-yong-ka/order/order-detail)接口查询支付最终结果

## 二、Redirect&#x20;

## 微信扫码支付收银台模式 wechat\_native

<mark style="color:green;">`POST`</mark> `USEEPAY_PATH/cashier`

#### Headers

| Name                                           | Type   | Description                       |
| ---------------------------------------------- | ------ | --------------------------------- |
| content-type<mark style="color:red;">\*</mark> | String | application/x-www-form-urlencoded |

#### Request Body

| Name                                              | Type         | Description                                                                                                                 |
| ------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| transactionType<mark style="color:red;">\*</mark> | String       | <p></p><p></p><p>交易类型 : <strong>pay</strong> </p>                                                                           |
| version<mark style="color:red;">\*</mark>         | String(5)    | 目前固定为 1.0 (5)                                                                                                               |
| signType<mark style="color:red;">\*</mark>        | String       | 商户生成签名字符串所使用的签名算法类型，目前支持：RSA/MD5                                                                                            |
| merchantNo<mark style="color:red;">\*</mark>      | String(16)   | 商户号                                                                                                                         |
| transactionId<mark style="color:red;">\*</mark>   | String(64)   | 商户订单号                                                                                                                       |
| transactionExpirationTime                         | String(6)    | 可选，默认为20分钟 .范围1-20                                                                                                          |
| appId<mark style="color:red;">\*</mark>           | String (128) | 网站域名                                                                                                                        |
| amount<mark style="color:red;">\*</mark>          | String(12)   | 支付金额，单位为对应币种的最小货币单位[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei)              |
| currency<mark style="color:red;">\*</mark>        | String(3)    | 3 位 ISO 大写字母货币代码[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei) 目前仅支持HKD        |
| notifyUrl<mark style="color:red;">\*</mark>       | String(512)  | [异步通知](https://useepay.gitbook.io/developer/reference/notify/notifyurl)                                                     |
| echoParam                                         | String(256)  | 回声参数，响应报文会原样返回                                                                                                              |
| payerInfo<mark style="color:red;">\*</mark>       | String       | Json格式的String 付款方信息, 请下方                                                                                                    |
| orderInfo                                         | String       | json string, 订单信息, 请参考下方                                                                                                    |
| userInfo                                          | String       | json string, 消费者信息, 请参考[消费者信息](https://useepay.gitbook.io/developer/reference/api-reference/parameter-description#userinfo) |
| autoRedirect                                      | String       | 是否自动跳转 'false', 'true' 默认为'true'                                                                                            |

{% tabs %}
{% tab title="200: OK " %}

```javascript
```

{% endtab %}
{% endtabs %}

### 2.2 请求参数详情说明

#### 2.2.1 payerInfo

| 参数                                | 必选 | 类型          | 说明                   |
| --------------------------------- | -- | ----------- | -------------------- |
| paymentMethod                     | Y  | String      | 目前固定为 wechat\_native |
| authorizationMethod               | Y  | String      | 固定为 cvv              |
| [billingAddress](#billingaddress) | N  | Json String | 账单地址                 |

#### 2.2.2 orderInfo

| 参数              | 必选 | 类型          | 说明                                                                                                                                                              |
| --------------- | -- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| subject         | Y  | String（128） | 订单标题，可以是商品名称。这个最终会提现在微信支付账单中                                                                                                                                    |
| goodsInfo       | N  | array       | 商品信息, 请参考 [goodsInfo](https://useepay.gitbook.io/developer/reference/local-pay-ben-di-hua/ben-di-hua-jie-kou/dian-zi-qian-bao/wechat-hk/broken-reference)       |
| shippingAddress | N  | object      | 收货地址, 请参考 [shippingAddress](https://useepay.gitbook.io/developer/reference/local-pay-ben-di-hua/ben-di-hua-jie-kou/dian-zi-qian-bao/wechat-hk/broken-reference) |

### 2.3 返回参数说明

| 字段              | 是否必须 | 描述                                                                                                                                                       |
| --------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| redirectUrl     | N    | wechat支付url, 当resultCode为recevied时存在                                                                                                                     |
| amount          | Y    | 订单金额                                                                                                                                                     |
| currency        | Y    | 3 位 ISO 大写字母货币代码[(详见 ISO 4217)](https://useepay.gitbook.io/developer/gui-fan-xing-shuo-ming/huo-bi-dan-wei)                                              |
| errorCode       | Y    | 错误码（详见 错误码 errorCode）                                                                                                                                    |
| errorMsg        | Y    | 错误码消息描述                                                                                                                                                  |
| echoParam       | N    | 回声参数，响应报文会原样返回                                                                                                                                           |
| sign            | Y    | 签名                                                                                                                                                       |
| transactionId   | Y    | 商户订单号                                                                                                                                                    |
| transactionType | Y    | 支付类型 pay                                                                                                                                                 |
| reference       | N    | USEEPAY 订单号                                                                                                                                              |
| resultCode      | Y    | 业务结果（详见 [业务结果码](https://useepay.gitbook.io/developer/reference/resultcode)）**判断交易是否成功的依据** 当前交易涉及的&#x6709;**:** succeed,pending,failed, closed, recevied |