AITalker 用户支付接口

能力

你的产品能获得什么

👤 用户体系

微信扫码 / QR 登录，一键授权、自动注册。支持手机号绑定，打通微信账号和手机号，历史数据自动合并不丢失。

💳 微信支付

支持 JSAPI 支付（微信内调起）和 Native 支付（扫码付）。创建订单、查单、退款全部封装好了。支付成功后自动回调你的服务器更新订单状态。

具体来说

🔐

JWT 鉴权登录后拿 Token，24 小时有效，所有请求带 Bearer 头即可。

📱

QR / 微信扫码登录用户扫码 → 自动登录或注册。纯前端集成，3 步接入。无需密码，不弹窗授权。

🔗

账号自动合并先扫码登录的用户绑定手机号时，自动识别老账号，openid 迁移，不丢积分不丢订单。

📞

手机号绑定前端调微信手机号组件，中台帮你解密。打通微信和手机号身份。

🧾

订单管理创建支付、查单状态、发起退款，三个接口搞定。金额统一用分，不会算错。

🔄

回调通知用户付完钱，微信通知中台，中台验证签名后转发你的服务器。失败自动重试 10 次。

接入

三步开始用

找管理员拿 API Key

联系 AITalker 获取（邮箱 Aitalker001@163.com / 微信 aitalker00）。这个 Key 是服务端用的，绝对不能放前端代码里。

前端配微信域名白名单

服务号后台 → 公众号设置 → 功能设置。需要加三处：
JS接口安全域名（JSAPI 支付需要）、网页授权域名（微信登录需要，填 userpay.aitalker.vip）、业务域名（防安全提示）。

调接口

接入方不需要实现密码注册/登录——本中台仅支持微信 / QR 扫码登录。用户扫码后自动注册或登录，返回 JWT Token。
有两种支付接入方式，根据你的产品选：
有后端服务（Server B）→ 用 X-API-Key 鉴权调 /api/pay/create，需要传 user_id。
纯前端应用（如 1 元建站）→ 用 JWT Token 鉴权调 /api/pay/create-for-app，不需要 API Key，不需要传 user_id，用户 ID 自动从登录 Token 提取。
具体参数和示例点下面按钮复制给 AI 编程助手，它会帮你写代码。

谁适合用

你在开发 AITalker 旗下的新产品（课程平台、数字人服务、小程序等），需要用户注册登录和收钱能力，但又不想从头对接微信支付 SDK、不想维护用户表，接这个中台就行。

前提条件

产品有独立的前端页面（网页或小程序）
用 AITalker 的企业服务号（wx39730950cba48927）和微信支付商户号（1683673373）
JSAPI 支付需要用户在微信内打开你的页面
Native 支付（扫码付）不需要微信环境，任意浏览器都能用

账号合并

用户不会丢数据

用户先扫码登录（自动创建账号、绑定 openid），之后绑定手机号时中台会自动检测——

如果这个手机号已经有一个老账号，且老账号还没绑微信 → 自动合并，openid 迁到老账号上，新号删除。用户的历史积分、订单全都在
如果老账号已经绑了别的微信 → 拒绝绑定，不会乱
如果新产生的账号已有支付订单 → 拒绝合并，提示联系客服处理

你的产品端不用管这些，中台自动处理。你只管拿到 user_id 之后用 JWT 管理会话就行。