小程序支付

商户已有微信或支付宝小程序，用户通过好友分享或扫描二维码在微信或支付宝内打开小程序时，可以调用支付完成下单购买的流程。

集成说明

商户必须先拥有一个小程序，请按照微信和支付宝的规范开发小程序。商户不需要在微信、支付宝开通小程序支付功能，只需要对接PayCloud的API，获取到支付参数，然后调起小程序支付控件，即可完成支付。

用户完成支付后，商家可以收到PayCloud的支付通知，商家也可以主动调用查询订单接口获取支付结果。在获得付款结果后，PayCloud会同步并更新订单信息给商户，以完成剩余的商品和服务。

注意事项

请确保调用此接口时已经开通线上支付权限。 微信小程序里请不要出现支付宝等其他支付方式，否则可能会导致用户无法支付。

用户付款流程

步骤1：用户通过分享或扫描二维码进入商户小程序，用户选择购买，完成选购流程。

步骤2：调起微信或支付宝支付控件，用户开始输入支付密码。

步骤3：密码验证通过，支付成功。商户后台得到支付成功的通知。

步骤4：返回商户小程序，显示购买成功。

微信小程序支付示意图：

开发指引

API列表

我们提供了一组REST API，请参阅下表，这些API提供了几种语言的SDK，请访问SDK章节。

API名称	说明
小程序支付下单	通过此API提交付款订单
取消订单	通过此API关闭未付款订单，如果已经付款，则向用户退款
提交退款申请	如果您通过此API提交退款请求，但退款没有立即到达，您可以调用退款查询API来获取退款的进度。
查询支付订单	通过该API查询正向交易订单的交易结果（消费/预授权/预授权完成）
查询退款订单	通过此API查询退款交易订单（消费取消/预授权取消/消费退款/预授权完成退款）的交易结果
交易结果通知	交易完成后，通知商家，告知商家交易结果

微信小程序调起支付

根据商户提交的资料，我们会在微信为你报备商户信息，开通支付。同时需要绑定微信支付商户号和小程序AppID，请告知Newage支持人员你的小程序AppID。

微信支付官方提供了如何调起小程序支付控件的过程和示例代码，具体请参考 开发指引和小程序调起支付。

微信文档中提及的 【统一下单】 API，请使用 PayCloud 提供的【小程序支付下单】API。作为微信支付在日本地区的官方服务商，我们已经集成了微信支付的功能，屏蔽了接入微信支付的复杂过程，你只需要通过我们的API获取下单参数，然后调起微信支付即可。

PayCloud 小程序支付接口返回参数 pay_params是一个JSON对象，示例结构如下：

{
    "timeStamp":"1414561699",
    "nonceStr":"5K8264ILTKch16CQ2502SI8ZNMTM67VS",
    "package":"prepay_id=123456789",
    "signType":"MD5",
    "paySign":"C380BEC2BFD727A4B6845133519F3AD6"
}

支付宝客户端调起支付

支付宝客户端调起小程序支付相对比较简单，只需要请求我们的下单API，获取到返回支付参数，返回支付参数是一个https链接地址，跳转到该链接地址即可。

PayCloud 小程序支付接口返回参数 pay_params是一个JSON对象，示例结构如下：

{
    "paymentUrl":"https://pay.alipay.com/minipay/129010778.html?tradeno=20210926001099101518"
}

paymentUrl是支付宝的收银台地址，你只需要在自己的小程序中显示该网页即可。