微信支付
通过微信支付节点可以调用微信支付相关 API 接口,帮助你在业务流程中轻松集成微信支付能力。
配置项说明
账号凭证
调用微信支付 API 时需要有必要的账号凭证信息。关于微信支付的账号凭证,可以查看 账号凭证 - 微信支付 章节。
方法
微信支付节点已接入以下微信支付 API,点击 API 名称链接可以查看微信支付完整 API 文档:
名称 | 描述 | 说明 |
---|---|---|
JSAPI 下单 | 通过本接口提交微信支付JSAPI支付订单 | 商户系统先调用该接口在微信支付服务后台生成预支付交易单,返回正确的预支付交易会话标识后再按Native、JSAPI、APP等不同场景生成交易串调起支付。 |
查询订单 - 微信支付订单号查询 | 通过此接口查询订单状态 | 商户可以通过查询订单接口主动查询订单状态,完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询,注意:查询订单可通过微信支付订单号和商户订单号两种方式查询,两种查询方式返回结果相同。 |
查询订单 - 商户订单号查询 | 通过此接口查询订单状态 | 商户可以通过查询订单接口主动查询订单状态,完成下一步的业务逻辑。查询订单状态可通过微信支付订单号或商户订单号两种方式查询,注意:查询订单可通过微信支付订单号和商户订单号两种方式查询,两种查询方式返回结果相同。 |
关闭订单 | 通过此接口关闭待支付订单 | 以下情况需要调用关单接口: 1、商户订单支付失败需要生成新单号重新发起支付,要对原订单号调用关单,避免重复支付; 2、系统下单后,用户支付超时,系统退出不再受理,避免用户继续,请调用关单接口。 |
申请退款 | 商户可以通过该接口将支付金额退还给买家 | 当交易发生之后一年内,由于买家或者卖家的原因需要退款时,卖家可以通过退款接口将支付金额退还给买家,微信支付将在收到退款请求并且验证成功之后,将支付款按原路退还至买家账号上。 |
查询单笔退款 | 提交退款申请后,通过调用该接口查询退款状态 | 提交退款申请后,通过调用该接口查询退款状态。退款有一定延时,建议在提交退款申请后1分钟发起查询退款状态,一般来说零钱支付的退款5分钟内到账,银行卡支付的退款1-3个工作日到账。 |
申请交易账单 | 商户可以通过该接口获取交易账单文件的下载地址 | 微信支付按天提供交易账单文件,商户可以通过该接口获取账单文件的下载地址。文件内包含交易相关的金额、时间、营销等信息,供商户核对订单、退款、银行到账等情况。 |
申请资金账单 | 商户可以通过该接口获取资金账单文件的下载地址 | 微信支付按天提供微信支付账户的资金流水账单文件,商户可以通过该接口获取账单文件的下载地址。文件内包含该账户资金操作相关的业务单号、收支金额、记账时间等信息,供商户进行核对。 |
方法入参
微信支付 API 的请求参数。通过【方法】小节中的链接可获取每个方法的参数解释说明。
警告
【JSAPI 下单】与【申请退款】在微信支付原始接口中的 appid
与 mchid
参数已包含在【账号凭证】中,无需重复传递。同时,notify_url
也已通过【通知回调接收方式】配置项指定,因此也无需传递。
通知回调接收方式
调用【JSAPI 下单】与【申请退款】方法时,需要指定通知回调接收方式。当用户支付完成后或商户退款完成后,微信会将结果通知以指定的接收方式发送。
接收方式包括:
- 工作流:使用工作流来接收微信支付通知回调。指定的工作流必须包含【收到微信支付事件推送时】 触发方式
- HTTP:使用普通 HTTP 接口来接收通知回调。