转账业务单据查询接口

开发环境

http://dev-cn.your-api-server.com

GET

/v3/alipay/fund/trans/common/query

alipay.fund.trans.common

商户可通过该接口查询转账业务单据的状态，主要应用于统一转账接口(alipay.fund.trans.uni.transfer)、无线转账接口(alipay.fund.trans.app.pay)、单笔转账到支付宝账户接口（alipay.fund.trans.toaccount.transfer）

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://dev-cn.your-api-server.com/v3/alipay/fund/trans/common/query?product_code&biz_scene&out_biz_no&order_id&pay_fund_order_id'

响应示例

200 - 成功示例

{
    "order_id": "20190801110070000006380000250621",
    "pay_fund_order_id": "20190801110070001506380000251556",
    "out_biz_no": "201808080001",
    "trans_amount": "付款金额，单位为元，精确到小数点后两位：32.00",
    "status": "SUCCESS",
    "pay_date": "2013-01-01 08:08:08",
    "arrival_time_end": "2013-01-01 08:08:08",
    "order_fee": "0.02",
    "error_code": "PAYEE_CARD_INFO_ERROR",
    "fail_reason": "收款方银行卡信息有误",
    "sub_order_error_code": "MID_ACCOUNT_CARD_INFO_ERROR",
    "sub_order_fail_reason": "收款方银行卡信息有误",
    "sub_order_status": "FAIL",
    "settle_serial_no": "2023052993044491260542090100400"
}

请求参数

Query 参数

product_code

string

可选

销售产品码，商家和支付宝签约的产品码，如果传递了out_biz_no则该字段为必传。可传值如下： STD_RED_PACKET：现金红包 TRANS_ACCOUNT_NO_PWD：单笔无密转账到支付宝账户 TRANS_BANKCARD_NO_PWD：单笔无密转账到银行卡

biz_scene

string

可选

描述特定的业务场景，如果传递了out_biz_no则该字段为必传。可取的业务场景如下： PERSONAL_PAY：C2C现金红包-发红包； PERSONAL_COLLECTION：C2C现金红包-领红包； REFUND：C2C现金红包-红包退回； DIRECT_TRANSFER：B2C现金红包、单笔无密转账

out_biz_no

string

可选

商户转账唯一订单号，发起转账来源方定义的转账单据ID。本参数和order_id（支付宝转账单据号）、pay_fund_order_id（支付宝支付资金流水号）三者不能同时为空。当三者同时传入时，将用pay_fund_order_id（支付宝支付资金流水号）进行查询，忽略其余两者；当本参数和支付宝转账单据号同时提供时，将用支付宝转账单据号进行查询，忽略本参数。

order_id

string

可选

支付宝转账单据号。本参数和out_biz_no（商户转账唯一订单号）、pay_fund_order_id（支付宝支付资金流水号）三者不能同时为空。当三者同时传入时，将用pay_fund_order_id（支付宝支付资金流水号）进行查询，忽略其余两者；当本参数和pay_fund_order_id（支付宝支付资金流水号）同时提供时，将用支付宝支付资金流水号进行查询，忽略本参数；当本参数和out_biz_no（商户转账唯一订单号）同时提供时，将用本参数进行查询，忽略商户转账唯一订单号。

pay_fund_order_id

string

可选

支付宝支付资金流水号。本参数和支付宝转账单据号、商户转账唯一订单号三者不能同时为空。当本参数和out_biz_no（商户转账唯一订单号）、order_id（支付宝转账单据号）同时提供时，将用本参数进行查询，忽略其余两者；当本参数和order_id（支付宝转账单据号）同时提供时，将用本参数进行查询，忽略支付宝转账单据号；当本参数和out_biz_no（商户转账唯一订单号）同时提供时，将用本参数进行查询，忽略商户转账唯一订单号。

返回响应

🟢200common response

application/json

Body

deduct_bill_info

string

可选

商户查询代扣订单信息时返回其在代扣请求中传入的账单属性

示例值:

{"bizDesc":"代扣账单属性","bizNos":"M{529316162343612472}","billSource":"账房","bizOrigNo":"529316162343612472","reqSystem":"PointCenter"}

error_code

string

可选

查询到的订单状态为FAIL失败或REFUND退票时，返回错误代码

示例值:

PAYEE_CARD_INFO_ERROR

fail_reason

string

可选

查询到的订单状态为FAIL失败或REFUND退票时，返回具体的原因。

示例值:

收款方银行卡信息有误

order_fee

string

可选

预计收费金额（元），转账到银行卡专用，数字格式，精确到小数点后2位，转账失败或转账受理失败不返回。

示例值:

0.02

order_id

string

可选

支付宝转账单据号，查询失败不返回。

示例值:

20190801110070000006380000250621

out_biz_no

string

商户订单号

可选

示例值:

201808080001

passback_params

string

商户回传参数

可选

示例值:

{"merchantBizType":"peerPay"}

pay_fund_order_id

string

可选

支付宝支付资金流水号，转账失败不返回。

示例值:

20190801110070001506380000251556

settle_serial_no

string

可选

金融机构发起签约类、支付类、差错类业务时，应为每笔业务分配唯一的交易流水号。31位交易流水号组成规则为：“8位日期”+“16位序列号”+“1位预留位”+“6位控制位”，其中： a）“8位日期”为系统当前日期，ISODate格式：“YYYYMMDD” b）“16位序列号”由金融机构生成，金融机构应确保该值在网联当日唯一 c）“1位预留位”由平台分配 d）“6位控制位”由金融机构通过平台获取例如：2023052993044491260542090100400

示例值:

2023052993044491260542090100400

status

string

可选

转账单据状态。可能出现的状态如下： SUCCESS：转账成功； WAIT_PAY：等待支付； CLOSED：订单超时关闭； FAIL：失败（适用于"单笔转账到银行卡"）； DEALING：处理中（适用于"单笔转账到银行卡"）； REFUND：退票（适用于"单笔转账到银行卡"）； alipay.fund.trans.app.pay涉及的状态： WAIT_PAY、SUCCESS、CLOSED alipay.fund.trans.refund涉及的状态：SUCCESS alipay.fund.trans.uni.transfer涉及的状态：SUCCESS、FAIL、DEALING、REFUND

示例值:

SUCCESS

sub_order_error_code

string

可选

特殊场景提供，当子单出现异常导致主单失败或者退款时，会提供此字段，用于透出子单具体的错误场景

示例值:

MID_ACCOUNT_CARD_INFO_ERROR

sub_order_fail_reason

string

可选

特殊场景提供，当子单出现异常导致主单失败或者退款时，会提供此字段，用于透出子单具体的错误场景

示例值:

收款方银行卡信息有误

sub_order_status

string

退款子单失败状态

可选

示例值:

FAIL

trans_amount

string

可选

付款金额，收银台场景下付款成功后的支付金额，订单状态为SUCCESS才返回，其他状态不返回。

示例值:

付款金额，单位为元，精确到小数点后两位：32.00

transfer_bill_info

string

可选

商户在查询代发订单信息时返回其在代发请求中传入的账单属性。

示例值:

{"bizDesc":"代扣账单属性","bizNos":"M{529316162343612472}","billSource":"账房","bizOrigNo":"529316162343612472","reqSystem":"PointCenter"}

arrival_time_end

string

可选

预计到账时间，转账到银行卡专用，格式为yyyy-MM-dd HH:mm:ss，转账受理失败不返回。注意：此参数为预计时间，可能与实际到账时间有较大误差，不能作为实际到账时间使用，仅供参考用途。

示例值:

{}

pay_date

string

可选

支付时间，格式为yyyy-MM-dd HH:mm:ss，转账失败不返回。

示例值:

{}

🔴500请求失败

单笔转账接口

现金红包无线支付接口