转账查询
此接口用于查询转账订单的处理状态,可用于确认转账是否成功,以及获取转账失败的具体原因。
请求信息
请求URL | /api/transfer/query |
---|---|
请求方式 | POST |
请求参数
参数名 | 类型 | 必填 | 示例值 | 说明 |
---|---|---|---|---|
pid | Int | 是 | 1001 | 商户ID |
out_biz_no | String | 是 | 2016080615134334919 | 转账接口传入或返回的交易号 |
timestamp | String | 是 | 1721206072 | 当前时间戳,10位整数,单位秒 |
sign | String | 是 | 签名字符串,详见签名规则 | |
sign_type | String | 是 | RSA | 签名类型,默认为RSA |
返回参数
参数名 | 类型 | 示例值 | 说明 |
---|---|---|---|
code | Int | 0 | 返回状态码,0为成功,其它值为失败 |
msg | String | 返回信息,失败或成功时返回提示 | |
status | Int | 1 | 转账状态: 0:正在处理 1:转账成功 2:转账失败 |
errmsg | String | 收款方账户异常 | status=2 时才返回,转账失败原因 |
out_biz_no | String | 2016080615134334919 | 商户转账单号 |
orderid | String | 40001283951815782 | 支付宝/微信返回的转账单号 |
paydate | String | 2024-07-01 16:47:32 | 转账完成时间 |
amount | String | 100.00 | 转账金额,单位:元 |
cost_money | String | 100.50 | 从商户可用余额扣减的金额 |
remark | String | 佣金提现 | 转账备注 |
timestamp | String | 1721206072 | 当前时间戳,10位整数,单位秒 |
sign | String | 签名字符串,详见签名规则 | |
sign_type | String | RSA | 签名类型,默认为RSA |
返回示例
成功示例:
{
"code": 0,
"msg": "查询成功",
"status": 1,
"out_biz_no": "2016080615134334919",
"orderid": "40001283951815782",
"paydate": "2024-07-01 16:47:32",
"amount": "100.00",
"cost_money": "100.50",
"remark": "佣金提现",
"timestamp": "1721206072",
"sign": "xxxxx",
"sign_type": "RSA"
}
失败示例:
{
"code": 0,
"msg": "查询成功",
"status": 2,
"errmsg": "收款方账户异常",
"out_biz_no": "2016080615134334919",
"orderid": "40001283951815782",
"amount": "100.00",
"cost_money": "100.50",
"remark": "佣金提现",
"timestamp": "1721206072",
"sign": "xxxxx",
"sign_type": "RSA"
}
其他说明
注意事项
- 接口访问频率限制:每分钟最多10次。
- 建议在转账提交后等待1-2秒后再查询状态。
- 如果查询结果为"正在处理",建议间隔一段时间后再次查询。
- 转账失败时,系统会自动退还已扣除的金额。
- 转账成功后不支持退款操作。