op_withdraw_maxmoney 配置控制。SUCCESS 后才消耗冻结金额;查询到失败、取消或退回后解冻。out_request_no 必须唯一;重复请求会返回原提现链接,保证幂等。接口使用商户后台 API 密钥签名,规则与易支付接口一致:
sign、sign_type 和空值参数。k=v&k2=v2。PHP 示例:
ksort($data);
$signStr = '';
foreach ($data as $key => $value) {
if ($key !== 'sign' && $key !== 'sign_type' && $value !== '') {
$signStr .= $key . '=' . $value . '&';
}
}
$sign = md5(substr($signStr, 0, -1) . $merchantKey);
请求地址:https://tpay.xiaotiandianjing.com/openapi.php
| 参数 | 必填 | 说明 |
|---|---|---|
| act | 是 | 固定 balance |
| pid | 是 | 商户 ID |
| sign | 是 | 签名 |
{
"code": 0,
"msg": "succ",
"pid": 1001,
"op_balance": "100.00",
"op_freeze": "20.00"
}
请求地址:https://tpay.xiaotiandianjing.com/openapi.php
| 参数 | 必填 | 说明 |
|---|---|---|
| act | 是 | 固定 create_withdraw_link |
| pid | 是 | 商户 ID |
| out_request_no | 是 | 商户请求号,6-64 位,仅支持字母数字、_、- |
| money | 是 | 金额,最多两位小数,单笔最大 200 |
| openid | 否 | 收款用户 OpenID;不传则用户打开链接后填写 |
| notify_url | 否 | 异步通知地址,必须 HTTPS |
| desc | 否 | 提现备注,最多 32 字 |
| sign | 是 | 签名 |
{
"code": 0,
"msg": "succ",
"out_request_no": "APP202606230001",
"out_bill_no": "202606232030001000112345",
"money": "20.00",
"status": 0,
"status_text": "LINK_CREATED",
"withdraw_url": "https://tpay.xiaotiandianjing.com/withdraw.php?token=...",
"package_info": null,
"expiretime": "2026-06-23 20:40:00",
"notify_status": 0,
"notify_time": null
}
请求地址:https://tpay.xiaotiandianjing.com/openapi.php
| 参数 | 必填 | 说明 |
|---|---|---|
| act | 是 | 固定 withdraw_query |
| pid | 是 | 商户 ID |
| out_request_no | 是 | 商户请求号 |
| sign | 是 | 签名 |
| status | status_text | 说明 |
|---|---|---|
| 0 | LINK_CREATED | 链接已创建,运营余额已冻结,用户未提交微信确认 |
| 1 | SUBMITTING | 用户已提交,正在请求微信 |
| 2 | WAIT_USER_CONFIRM | 微信已受理,等待用户在微信确认或处理中 |
| 3 | SUCCESS | 微信确认成功,冻结金额已扣除 |
| 4 | FAIL | 提现失败,冻结金额已解冻 |
当提现进入 SUCCESS 或 FAIL 后,系统会 POST 到 notify_url。商户返回包含 success 的文本即视为通知成功,否则同步任务会继续重试。
| 参数 | 说明 |
|---|---|
| pid | 商户 ID |
| out_request_no | 商户请求号 |
| out_bill_no | 平台微信提现单号 |
| money | 金额 |
| status | 状态码 |
| status_text | 状态文本 |
| result | 结果说明 |
| withdraw_url | 提现链接 |
| timestamp | 通知时间戳 |
| sign | 签名 |
商户收到通知后也应使用同样签名规则验签,并以查询接口结果为准做最终对账。
建议每分钟请求一次:
https://tpay.xiaotiandianjing.com/wxtransfer_sync.php?key=902961
这个任务负责查询微信最终状态、成功扣冻结款、失败解冻、回调商户。
第三方 App 创建链接后,把 withdraw_url 发给用户。用户需要在微信内打开链接:
openid,用户可直接点击“在微信确认收款”。openid,页面会要求填写 OpenID 后再生成微信确认信息。package_info 后会调用微信 requestMerchantTransfer,由用户亲自确认收款。