你当前的浏览器版本过低,请您升级至IE9以上版本,以达到最佳效果,谢谢!X
TOP

返回开发文档

该文档用于第三方 App 或业务系统创建微信提现链接、查询提现状态,以及接收异步通知。

运营账户开放提现接口

资金规则

  • 运营账户余额独立于下单余额、结算余额,只用于开放平台提现链接。
  • 创建提现链接时立即冻结运营余额,用户未确认前不会扣除冻结款。
  • 单笔最大金额默认 200 元,由 op_withdraw_maxmoney 配置控制。
  • 微信查询到 SUCCESS 后才消耗冻结金额;查询到失败、取消或退回后解冻。
  • 商户的 out_request_no 必须唯一;重复请求会返回原提现链接,保证幂等。

签名规则

接口使用商户后台 API 密钥签名,规则与易支付接口一致:

  1. 去掉 signsign_type 和空值参数。
  2. 参数名按 ASCII 升序排序。
  3. 拼成 k=v&k2=v2
  4. 末尾直接拼接商户 API 密钥后取 32 位小写 MD5。

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签名
statusstatus_text说明
0LINK_CREATED链接已创建,运营余额已冻结,用户未提交微信确认
1SUBMITTING用户已提交,正在请求微信
2WAIT_USER_CONFIRM微信已受理,等待用户在微信确认或处理中
3SUCCESS微信确认成功,冻结金额已扣除
4FAIL提现失败,冻结金额已解冻

异步通知

当提现进入 SUCCESSFAIL 后,系统会 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,由用户亲自确认收款。
  • 链接过期且未提交微信时,系统定时任务会自动解冻运营余额。