扫码支付

扫码支付只需要服务端 SDK ，拿到二维码链接后的流程由商户自行设计，目前 剪刀手 支持支付宝扫码 (当面付) 和微信扫码，可参考以下流程：

1.服务端调用 Server-SDK 封装的创建支付 Charge 的方法请求 剪刀手 。

2.剪刀手 响应你的服务端请求，返回 支付 Charge 对象，在 Charge 对象中有 credential 字段，该字段中包含可以生成二维码的alipay_qr或wx_pub_qr链接。

3.商户需要截取出alipay_qr或wx_pub_qr的链接并自行生成二维码，显示在你的 PC 端或任意你需要展示二维码的平台。

4.在 剪刀手 管理平台配置 Webhooks 的 charge.succeeded 事件。支付完成时，剪刀手 会主动以 POST 方式向你配置在管理平台上的 Webhooks 通知地址发送支付结果，服务端的订单状态请根据 Webhooks 通知更新。

5.同时，建议在处理逻辑中添加主动查询机制：如果在可接受的时间范围内没有收到 Webhooks 通知，你也可以调用 Server-SDK 封装的查询方法，主动向 剪刀手 发起请求来获得订单状态，该查询结果可以作为交易结果。

---

注意事项

1.剪刀手 没有针对扫码提供客户端 SDK ，所以请不要将服务端拿到的 charge 传给 剪刀手 的 Client-SDK ，会出现报错 no_such_channel。

2.支付完成后，第三方渠道不会给你的客户端任何结果，所以你需要设计客户端主动轮询服务端查询扫码的支付结果。

线下扫码

「线下扫码」渠道的场景描述如下：

1.用户主扫：channel 为 isv_qr，商户针对某一笔订单／商品生成二维码显示在终端，用户使用支付宝／微信进行扫码支付（该二维码分渠道，支付宝只能扫支付宝对应产生的二维码，微信只能扫微信对应产生的二维码）。

2.用户被扫：channel 为 isv_scan ，用户展示支付宝／微信中的付款码，商户使用扫描设备扫描。

3.固定码：channel 为 isv_wap，商户展示一个固定码（实际就是支付页面的链接）在终端，用户使用微信／支付宝扫码，进入一个支付页面，在该支付页面输入金额（此处可省略），点击支付按钮之后，如果使用微信扫码的就直接调起微信支付，使用支付宝扫码的就直接调起支付宝支付。

其中，isv_qr和isv_scan只需要服务端 SDK，isv_wap需要服务端 SDK 和客户端 H5 SDK。

---

注意事项

1.使用isv_qr和isv_scan渠道时，请不要将服务端拿到的 Charge 传给 剪刀手 的 Client-SDK。

2.请勿直接使用客户端支付结果作为最终判定订单状态的依据，由于 剪刀手 没有参与你的客户端和第三方渠道的交互，无法保证客户端支付结果的安全性，建议订单状态的更新对比客户端的渠道同步回调信息和服务端的 剪刀手 Webhooks 通知来确定是否修改。

撤销

此接口仅接受 isv_scan、isv_wap、isv_qr 渠道的订单调用，在订单状态不明时可以调用该接口撤销订单。对于未成功付款的订单进行撤销，则关闭交易。调用此接口后用户后期不能支付成功。 注： 对于成功付款的订单请使用 退款 接口进行退款处理。

---

注意事项

1.isv_scan、isv_wap、isv_qr渠道可在交易产生当天调用撤销接口。

2.对于成功付款的订单请使用 退款 接口进行退款处理。只有针对未支付或状态不明的订单，我们建议你调用撤销接口。

3.若接入的是中信银行的线下扫码，则撤销接口仅支持isv_scan。

红包

商户想给用户发送微信红包福利时，可以看这里的流程：

剪刀手 红包 Redenvelope 功能只需要服务端 SDK，目前仅支持微信红包。

1.服务端调用 Server-SDK 封装的发送红包的方法请求 剪刀手 。

2.剪刀手 响应你的服务端请求，返回红包 Redenvelope 对象，此时订单状态为 pending，此时仅代表发送红包请求成功，不代表红包成功发送与拆开；使用剪刀手 测试模式发起的红包请求，必须主动调用红包查询接口查询订单状态才能触发 Webhooks 回调。

3.在 剪刀手 管理平台配置 Webhooks 的 red_envelope.sent 和 red_envelope.received 事件。红包发送成功时，剪刀手 会主动以 POST 方式向你配置在管理平台上的 Webhooks 通知地址发送红包发送和接收结果。

4.同时，建议在处理逻辑中添加主动查询机制：如果在可接受的时间范围内没有收到 Webhooks 通知，你也可以调用 Server-SDK 封装的查询方法，主动向 剪刀手 发起请求来获得订单状态，该查询结果可以作为交易结果。

---

注意事项

1.发送频率规则：每分钟发送红包数量不能超过 1800 个；

2.红包规则：单个红包金额介于人民币 1 元 ~ 200 元之间；同一个红包只能发送给一个用户；红包发放后 24 小时未被领取，将退回商户账户。

3.确保可用余额充足。发放现金红包将扣除商户的可用余额,可用余额并不是微信支付交易额，需要预先充值，确保可用余额充足。

企业付款

商户需要给用户打款转账时，可以参考如下的流程图。剪刀手 企业付款 Transfer 功能只需要服务端 SDK 。目前企业付款 Transfer 接口支持的渠道请参考 企业付款 channel 参数 ，剪刀手 管理平台支持 批量企业付款 操作，且提供 批量企业付款的接口。

1.服务端调用 Server-SDK 封装的企业付款 Transfer 的方法请求 剪刀手 。

2.剪刀手 响应你的服务端请求，返回企业付款 Transfer 对象，此时订单状态为 pending 仅代表企业付款请求成功，并不代表企业付款成功。

3.在 剪刀手 管理平台配置 Webhooks 的 transfer.succeeded 事件。企业付款成功时，剪刀手 会主动以 POST 方式向你配置在管理平台上的 Webhooks 通知地址发送企业付款的结果，此时 Transfer 对象中 status 字段值为 paid，表示企业付款完成。

4.同时，建议在处理逻辑中添加主动查询机制：如果在可接受的时间范围内没有收到 Webhooks 通知，你也可以调用 Server-SDK 封装的查询方法，主动向 剪刀手 发起请求来获得订单状态，该查询结果可以作为交易结果。

---

微信企业付款

关于微信企业付款，请注意以下几点：

1.微信企业付款支持向指定微信用户的 open_id 付款。

2.发送微信企业付款将扣除商户的可用余额,可用余额并不是微信支付交易额，需要预先充值，确保可用余额充足。 查看可用余额、充值、提现请登录 微信支付商户平台 ，进入资金管理菜单，进行操作。

3.付款资金将进入目标用户的零钱（微信—我—钱包—零钱），微信支付会有零钱入账消息的通知，零钱收支明细会展示相应记录。

---

银联电子代付

关于银联电子代付，请注意以下几点：

1.限额:单笔限额 1000 元;单日限额 20000 元;单日不超过 50 笔（上线后可根据实际需求申请提高额度）

2.商户在发起代付请求前，请确定其第三方机构企业账户金额充足，确保代付顺利完成。

3.建议商户对新增的未实名认证的收款人，先进行实名认证，减小风险。

4.目前支持的收款人银行为：工行、农行、中行、建行、交行、招商银行、光大银行、中信银行、浦发银行、广发银行、民生银行、兴业银行、平安银行等。

退款

用户完成付款后在商家同意的情况下需要退款时，剪刀手 的管理平台提供了退款功能，也可以通过 剪刀手 Server SDK 发起退款：

剪刀手 退款 Refund 功能只需要服务端 SDK，所以需要你在客户端为用户设计退款入口。

1.服务端调用 Server-SDK 封装的发起退款方法请求 剪刀手 。

2.剪刀手 响应你的服务端请求，返回退款 Refund 对象，请求是否成功可以根据返回的 Refund 中的 failure_msg 来判断。如果该字段为空则代表退款请求成功，不代表退款已经成功到账。

3.在 剪刀手 管理平台配置 Webhooks 的 refund.succeeded 事件。退款成功时，剪刀手 会主动以 POST 方式向你配置在管理平台上的 Webhooks 通知地址发送退款结果。

4.同时，建议在处理逻辑中添加主动查询机制：在可接受的时间范围内，如果你服务端没有收到 Webhooks 的通知或退款失败，你也可以调用 Server-SDK 封装的查询方法，主动向 剪刀手 发起请求来获得退款状态，该查询结果可以作为交易结果。

---

注意事项

1.使用 剪刀手 退款功能的前提是你已经通过 剪刀手 支付接口完成付款。

2.如果未通过 剪刀手 进行退款（即直接从渠道的平台退款），则 剪刀手 不会同步渠道退款状态。

3.若退款订单较多，可使用 剪刀手 管理平台上的批量退款功能 或者 API 接口 批量退款 。

支付宝退款

用户完成付款后在商家同意的情况下需要退款时，剪刀手 的管理平台提供了退款功能，也可以通过 剪刀手 Server SDK 发起退款。由于支付宝 1.0(mapi) 接口的退款流程有异于其他渠道，以下为支付宝 1.0 接口退款流程的特别说明（支付宝 2.0 "openapi" 接口的退款请直接参考 退款）：

剪刀手 退款 Refund 功能只需要使用服务端 SDK，所以需要你在客户端为用户设计退款入口。

1.服务端调用 Server-SDK 封装的创建退款方法请求 剪刀手 。

2.剪刀手 响应你的服务端请求，返回 退款 Refund 对象。 Refund 对象中的 failure_msg 字段包含支付宝退款链接。

3.商户需要截取 failure_msg 中的退款链接并点击链接进入支付宝退款页面，需要商家输入支付宝支付密码完成退款。注意：支付宝退款链接当日有效，隔日作废，需要重新请求 退款查询 接口或者重新请求 创建退款 接口，均会返回新的链接。

4.在 剪刀手 管理平台配置 Webhooks 的 refund.succeeded 事件。退款完成时，剪刀手 会主动以 POST 方式向你配置在管理平台上的 Webhooks 通知地址发送退款结果。

在可接受的时间范围内，如果你服务端没有收到 Webhooks 的通知或退款失败，你也可以调用 Server-SDK 封装的查询方法，主动向 剪刀手 发起请求来获得退款状态，该查询结果可以作为交易结果。

---

注意事项

1.使用 剪刀手 退款功能的前提是你已经通过 剪刀手 支付接口完成付款。

2.支付宝已付款订单在 3 个月内均可以退款；微信允许交易时间在 1 年内的订单进行退款；其他支付渠道均为 1 个月内可退款，超过 1 个月则渠道不允许退款。

3.如果未通过 剪刀手 进行退款（即直接从渠道的平台退款），则不会同步渠道退款状态。

4.调用 剪刀手 退款接口返回的支付宝退款链接当日有效，隔日作废，需要重新请求 退款查询 接口或者重新请求 创建退款 接口，均会返回新的链接。

5.支付宝当面付（即 alipay_qr）渠道的退款属于免密退款，不需要以上步骤。