跳到主要内容

微信支付

通过微信支付节点可以调用微信支付相关 API 接口,帮助你在业务流程中轻松集成微信支付能力。

配置项说明

账号凭证

调用微信支付 API 时需要有必要的账号凭证信息。关于微信支付的账号凭证,可以查看 账号凭证 - 微信支付 章节。

方法

微信支付节点已接入以下微信支付 API,点击 API 名称链接可以查看微信支付完整 API 文档:

名称描述说明
JSAPI 下单通过本接口提交微信支付JSAPI支付订单商户系统先调用该接口在微信支付服务后台生成预支付交易单,返回正确的预支付交易会话标识后再按Native、JSAPI、APP等不同场景生成交易串调起支付。
查询订单 - 微信支付订单号查询通过此接口查询订单状态商户可以通过查询订单接口主动查询订单状态,完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询,注意:查询订单可通过微信支付订单号和商户订单号两种方式查询,两种查询方式返回结果相同。
查询订单 - 商户订单号查询通过此接口查询订单状态商户可以通过查询订单接口主动查询订单状态,完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询,注意:查询订单可通过微信支付订单号和商户订单号两种方式查询,两种查询方式返回结果相同。
关闭订单通过此接口关闭待支付订单以下情况需要调用关单接口: 1、商户订单支付失败需要生成新单号重新发起支付,要对原订单号调用关单,避免重复支付; 2、系统下单后,用户支付超时,系统退出不再受理,避免用户继续,请调用关单接口。
申请退款商户可以通过该接口将支付金额退还给买家当交易发生之后一年内,由于买家或者卖家的原因需要退款时,卖家可以通过退款接口将支付金额退还给买家,微信支付将在收到退款请求并且验证成功之后,将支付款按原路退还至买家账号上。
查询单笔退款提交退款申请后,通过调用该接口查询退款状态提交退款申请后,通过调用该接口查询退款状态。退款有一定延时,建议在提交退款申请后1分钟发起查询退款状态,一般来说零钱支付的退款5分钟内到账,银行卡支付的退款1-3个工作日到账。
申请交易账单商户可以通过该接口获取交易账单文件的下载地址微信支付按天提供交易账单文件,商户可以通过该接口获取账单文件的下载地址。文件内包含交易相关的金额、时间、营销等信息,供商户核对订单、退款、银行到账等情况。
申请资金账单商户可以通过该接口获取资金账单文件的下载地址微信支付按天提供微信支付账户的资金流水账单文件,商户可以通过该接口获取账单文件的下载地址。文件内包含该账户资金操作相关的业务单号、收支金额、记账时间等信息,供商户进行核对。

方法入参

微信支付 API 的请求参数。通过【方法】小节中的链接可获取每个方法的参数解释说明。

警告

【JSAPI 下单】与【申请退款】在微信支付原始接口中的 appidmchid 参数已包含在【账号凭证】中,无需重复传递。同时,notify_url 也已通过【通知回调接收方式】配置项指定,因此也无需传递。

通知回调接收方式

调用【JSAPI 下单】与【申请退款】方法时,需要指定通知回调接收方式。当用户支付完成后或商户退款完成后,微信会将结果通知以指定的接收方式发送。

接收方式包括:

  • 工作流:使用工作流来接收微信支付通知回调。指定的工作流必须包含【收到微信支付事件推送时】 触发方式
  • HTTP:使用普通 HTTP 接口来接收通知回调。