MiniAppPayApi (rx-wecom-sdk 1.2.0 API)

```
public interface MiniAppPayApi
```
小程序接入对外收款
本接口适用于在由企业微信向微信发出的小程序中使用对外收款账户进行收款。

Since:

2023 /7/6 16:24

Author:

dax

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`io.reactivex.rxjava3.core.Single<WeComResponse>`	`closeOrder(MchIdAndOutTradeNo request)` 关闭订单
`io.reactivex.rxjava3.core.Single<GenericResponse<String>>`	`createOrder(MiniPayRequest request)` 小程序下单
`io.reactivex.rxjava3.core.Single<okhttp3.ResponseBody>`	`downloadBill(String downloadUrl, String authorization)` 下载对账单
`io.reactivex.rxjava3.core.Single<BillResponse>`	`getBill(BillRequest request)` 交易账单申请
`io.reactivex.rxjava3.core.Single<PayOrderDetailResponse>`	`getOrder(MchIdAndOutTradeNo request)` 查询订单
`io.reactivex.rxjava3.core.Single<RefundDetailResponse>`	`getRefundDetail(MchIdAndOutRefundNo request)` 查询退款
`io.reactivex.rxjava3.core.Single<GenericResponse<String>>`	`getSign(PaySignRequest request)` 获取支付签名
`io.reactivex.rxjava3.core.Single<RefundResponse>`	`refund(RefundRequest request)` 申请退款

- Method Detail
  - createOrder
```
@POST(value="miniapppay/create_order")
io.reactivex.rxjava3.core.Single<GenericResponse<String>> createOrder(@Body
                                                                                                             MiniPayRequest request)
```
    小程序下单
    商户系统先调用该接口通过企微后台生成预支付交易单，返回正确的预支付交易会话标识后再按小程序场景生成交易串调起支付。
    
    Parameters:
    
    request - the request
    
    Returns:
    
    the generic response
  - getOrder
```
@POST(value="miniapppay/get_order")
io.reactivex.rxjava3.core.Single<PayOrderDetailResponse> getOrder(@Body
                                                                                                      MchIdAndOutTradeNo request)
```
    查询订单
    商户可以通过商户订单号查询订单，获取订单状态等信息，完成下一步的业务逻辑。
    需要调用查询接口的情况
    - 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知。
    - 调用支付接口后，返回系统错误或未知交易状态情况。
    - 调用关单或撤销接口API之前，需确认支付状态。
    Parameters:
    
    request - the request
    
    Returns:
    
    the order
  - closeOrder
```
@POST(value="miniapppay/close_order")
io.reactivex.rxjava3.core.Single<WeComResponse> closeOrder(@Body
                                                                                                 MchIdAndOutTradeNo request)
```
    关闭订单
    订单生成后不能马上调用关单接口，最短调用时间间隔为5分钟。
    以下情况需要调用关单接口
    - 商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付
    - 系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口
    Parameters:
    
    request - the request
    
    Returns:
    
    the we com response
  - getSign
```
@POST(value="miniapppay/get_sign")
io.reactivex.rxjava3.core.Single<GenericResponse<String>> getSign(@Body
                                                                                                     PaySignRequest request)
```
    获取支付签名
    商户系统获取完预支付交易会话标识（prepay_id）后，在小程序端调用wxsdk前，需要调用本接口获取到必要的签名字段，再调起微信支付。
    
    Parameters:
    
    request - the request
    
    Returns:
    
    the sign
  - refund
```
@POST(value="miniapppay/refund")
io.reactivex.rxjava3.core.Single<RefundResponse> refund(@Body
                                                                                         RefundRequest request)
```
    申请退款
    当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，企业微信将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家账户上。
    1. 交易时间超过一年的订单无法提交退款。
    2. 企业微信退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号。
    3. 请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次，单笔订单请求频率限制：1qpm，即单笔订单每分钟申请退款请求次数不超过1次。
    4. 每个支付订单的部分退款次数不能超过50次。
    5. 申请退款接口的返回仅代表业务的受理情况，具体退款是否成功，需要通过退款查询接口获取结果。
    Parameters:
    
    request - the request
    
    Returns:
    
    the refund response
  - getRefundDetail
```
@POST(value="miniapppay/get_refund_detail")
io.reactivex.rxjava3.core.Single<RefundDetailResponse> getRefundDetail(@Body
                                                                                                                   MchIdAndOutRefundNo request)
```
    查询退款
    退款有一定延时，用零钱支付的退款20分钟内到账，银行卡支付的退款3个工作日后重新查询退款状态。
    
    Parameters:
    
    request - the request
    
    Returns:
    
    the refund detail
  - getBill
```
@POST(value="miniapppay/get_bill")
io.reactivex.rxjava3.core.Single<BillResponse> getBill(@Body
                                                                                          BillRequest request)
```
    交易账单申请
    按天提供交易账单文件，服务商可以通过该接口获取账单文件的下载地址。文件内包含交易相关的金额、时间、营销等信息，供商户核对订单、退款、银行到账等情况。
    
    Parameters:
    
    request - the request
    
    Returns:
    
    the bill
  - downloadBill
```
@GET
io.reactivex.rxjava3.core.Single<okhttp3.ResponseBody> downloadBill(@Url
                                                                         String downloadUrl,
                                                                         @Header(value="Authorization")
                                                                         String authorization)
```
    下载对账单
    文件说明
    交易账单文件内包含：明细数据表头、明细数据内容、汇总数据表头、汇总数据四个部分，每个字段使用英文逗号 , 间隔，明细数据内容每个字段前会增加1个字符 ` 用于避免获取的内容被excel展示为科学计数法的格式、丢失数据细节
    
    Parameters:
    
    downloadUrl - the download url
    
    authorization - the authorization
    
    Returns:
    
    the response body
    
    See Also:
    
    交易账单申请, 对账单示例

Interface MiniAppPayApi

Method Summary

Method Detail

createOrder

getOrder

closeOrder

getSign

refund

getRefundDetail

getBill

downloadBill