# 支付后获取用户 Unionid 接口
调用本接口前需要用户完成支付,用户支付完成后,第三方平台可以代理小程序获取该用户的 unionid,无需用户授权。本接口支付后的五分钟内有效。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
# 请求地址
以下两种方式任选其一:
- 微信订单号:
GET https://api.weixin.qq.com/wxa/getpaidunionid?access_token=ACCESS_TOKEN&openid=OPENID&transaction_id=TRANSACTION_ID
- 商户订单号:
GET https://api.weixin.qq.com/wxa/getpaidunionid?access_token=ACCESS_TOKEN&openid=OPENID&mch_id=MCH_ID&out_trade_no=OUT_TRADE_NO
# 请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | String | 是 | 第三方平台接口调用令牌authorizer_access_token |
| openid | String | 是 | 支付用户唯一标识 |
| transaction_id | String | 否 | 微信订单号 |
| mch_id | String | 否 | 商户号,和商户订单号配合使用 |
| out_trade_no | String | 否 | 商户订单号,和商户号配合使用 |
# 返回参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| unionid | String | 用户唯一标识,调用成功后返回 |
| errcode | Number | 返回码 |
# 返回码说明
| 值 | 说明 |
|---|---|
| 0 | 请求成功 |
| -1 | 系统错误 |
| 40003 | openid 错误 |
| 89002 | 没有绑定开放平台账号 |
| 89300 | 订单无效 |
| 其他错误码 | 请查看全局错误码 |