alipay.fund.trans.uni.transfer(单笔转账接口) 在线调试(沙箱环境)

单笔转账接口是基于支付宝的资金处理能力,为了满足支付宝商家的转账需求,针对有部分开发能力的商家,提供通过API接口完成企业自身支付宝账户到支付宝账户、企业自身支付宝账户到银行卡的转账功能。 适用于:C2C现金红包的红包领取、B2C现金红包的红包发放、B2C单笔转账到支付宝账户、B2C单笔转账到银行卡等。

公共参数

请求地址

环境HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do

公共请求参数

参数 类型 是否必填最大长度描述示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.fund.trans.uni.transfer
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 344 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
app_auth_token String 40 详见应用授权概述
biz_content String 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
out_biz_no String 必选 64 商户端的唯一订单号,对于同一笔转账请求,商户需保证该订单号唯一。 201806300001
trans_amount Price 必选 20 订单总金额,单位为元,精确到小数点后两位,STD_RED_PACKET产品取值范围[0.01,100000000];
TRANS_ACCOUNT_NO_PWD产品取值范围[0.1,100000000]
23.00
product_code String 必选 64 业务产品码,
收发现金红包固定为:STD_RED_PACKET;
单笔无密转账到支付宝账户固定为:TRANS_ACCOUNT_NO_PWD;
单笔无密转账到银行卡固定为:TRANS_BANKCARD_NO_PWD
STD_RED_PACKET
biz_scene String 可选 64 描述特定的业务场景,可传的参数如下:
PERSONAL_COLLECTION:C2C现金红包-领红包;
DIRECT_TRANSFER:B2C现金红包、单笔无密转账到支付宝/银行卡
PERSONAL_COLLECTION
order_title String 可选 64 转账业务的标题,用于在支付宝用户的账单里显示 营销红包
original_order_id String 可选 64 原支付宝业务单号。C2C现金红包-红包领取时,传红包支付时返回的支付宝单号;B2C现金红包、单笔无密转账到支付宝/银行卡不需要该参数。 20190620110075000006640000063056
payee_info Participant 必选 收款方信息
identity String 必填 64 参与方的唯一标识 2088123412341234
identity_type String 必填 64 参与方的标识类型,目前支持如下类型:
1、ALIPAY_USER_ID 支付宝的会员ID
2、ALIPAY_LOGON_ID:支付宝登录号,支持邮箱和手机号格式
ALIPAY_USER_ID
name String 可选 256 参与方真实姓名,如果非空,将校验收款支付宝账号姓名一致性。当identity_type=ALIPAY_LOGON_ID时,本字段必填。 黄龙国际有限公司
remark String 可选 200 业务备注 红包领取
business_params String 可选 2048 转账业务请求的扩展参数,支持传入的扩展参数如下:
1、sub_biz_scene 子业务场景,红包业务必传,取值REDPACKET,C2C现金红包、B2C现金红包均需传入;

2、withdraw_timeliness为转账到银行卡的预期到账时间,可选(不传入则默认为T1),取值T0表示预期T+0到账,取值T1表示预期T+1到账,因到账时效受银行机构处理影响,支付宝无法保证一定是T0或者T1到账;
{"sub_biz_scene":"REDPACKET"}

响应参数

参数 类型 是否必填 最大长度 描述 示例值
out_biz_no String 必填 64 商户订单号 201808080001
order_id String 必填 32 支付宝转账订单号 20190801110070000006380000250621
pay_fund_order_id String 选填 32 支付宝支付资金流水号 20190801110070001506380000251556
status String 选填 32 转账单据状态。
SUCCESS:成功(对转账到银行卡的单据, 该状态可能变为退票[REFUND]状态);
FAIL:失败(具体失败原因请参见error_code以及fail_reason返回值);
DEALING:处理中;
REFUND:退票;
SUCCESS
trans_date String 必填 30 订单支付时间,格式为yyyy-MM-dd HH:mm:ss 2019-08-21 00:00:00

请求示例

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayFundTransUniTransferRequest request = new AlipayFundTransUniTransferRequest();
request.setBizContent("{" +
"\"out_biz_no\":\"201806300001\"," +
"\"trans_amount\":23.00," +
"\"product_code\":\"STD_RED_PACKET\"," +
"\"biz_scene\":\"PERSONAL_COLLECTION\"," +
"\"mutiple_currency_detail\":{" +
"\"payment_amount\":\"100.00\"," +
"\"payment_currency\":\"CNY\"," +
"\"trans_amount\":\"10.00\"," +
"\"trans_currency\":\"CNY\"," +
"\"settlement_amount\":\"10.00\"," +
"\"settlement_currency\":\"CNY\"," +
"\"ext_info\":\"key=value\"" +
"    }," +
"\"order_title\":\"营销红包\"," +
"\"original_order_id\":\"20190620110075000006640000063056\"," +
"\"payer_info\":{" +
"\"identity\":\"208812*****41234\"," +
"\"identity_type\":\"ALIPAY_USER_ID\"," +
"\"name\":\"黄龙国际有限公司\"," +
"\"bankcard_ext_info\":{" +
"\"inst_name\":\"招商银行\"," +
"\"account_type\":\"1\"," +
"\"inst_province\":\"江苏省\"," +
"\"inst_city\":\"南京市\"," +
"\"inst_branch_name\":\"新街口支行\"," +
"\"bank_code\":\"123456\"" +
"      }," +
"\"merchant_user_info\":\"{\\\"merchant_user_id\\\":\\\"123456\\\"}\"," +
"\"ext_info\":\"{\\\"alipay_anonymous_uid\\\":\\\"2088123412341234\\\"}\"" +
"    }," +
"\"payee_info\":{" +
"\"identity\":\"208812*****41234\"," +
"\"identity_type\":\"ALIPAY_USER_ID\"," +
"\"name\":\"黄龙国际有限公司\"," +
"\"bankcard_ext_info\":{" +
"\"inst_name\":\"招商银行\"," +
"\"account_type\":\"1\"," +
"\"inst_province\":\"江苏省\"," +
"\"inst_city\":\"南京市\"," +
"\"inst_branch_name\":\"新街口支行\"," +
"\"bank_code\":\"123456\"" +
"      }," +
"\"merchant_user_info\":\"{\\\"merchant_user_id\\\":\\\"123456\\\"}\"," +
"\"ext_info\":\"{\\\"alipay_anonymous_uid\\\":\\\"2088123412341234\\\"}\"" +
"    }," +
"\"remark\":\"红包领取\"," +
"\"business_params\":\"{\\\"withdraw_timeliness\\\":\\\"T0\\\",\\\"sub_biz_scene\\\":\\\"REDPACKET\\\"}\"," +
"\"passback_params\":\"{\\\"merchantBizType\\\":\\\"peerPay\\\"}\"" +
"  }");
AlipayFundTransUniTransferResponse response = alipayClient.certificateExecute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

{
    "alipay_fund_trans_uni_transfer_response": {
        "code": "10000",
        "msg": "Success",
        "out_biz_no": "201808080001",
        "order_id": "20190801110070000006380000250621",
        "pay_fund_order_id": "20190801110070001506380000251556",
        "status": "SUCCESS",
        "trans_date": "2019-08-21 00:00:00"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

{
    "alipay_fund_trans_uni_transfer_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

公共错误码

错误码错误描述解决方案
INVALID_PARAMETER 参数有误参数有误 请根据入参说明检查请求参数合法性。
SYSTEM_ERROR 系统繁忙 可能发生了网络或者系统异常,导致无法判定准确的转账结果。此时,商户不能直接当做转账成功或者失败处理,可以考虑采用相同的out_biz_no重发请求,或者通过调用“(alipay.fund.trans.order.query)”来查询该笔转账订单的最终状态。
EXCEED_LIMIT_SM_AMOUNT 单笔额度超限 请根据接入文档检查amount字段
EXCEED_LIMIT_MM_AMOUNT 月累计金额超限 请根据接入文档说明检查本月请求总金额+本次请求金额是否超限。
PAYCARD_UNABLE_PAYMENT 付款账户余额支付功能不可用 请付款账户登录支付宝账户开启余额支付功能。
PAYER_STATUS_ERROR 付款账号状态异常 请检查付款方是否进行了自助挂失,如果无,请联系支付宝客服检查用户状态是否正常。
PAYER_CERTIFY_CHECK_FAIL 付款方人行认证受限 付款方请升级认证等级。
PAYER_STATUS_ERROR 付款方用户状态不正常 请检查付款方是否进行了自助挂失,如果无,请联系支付宝客服检查用户状态是否正常。
PAYER_BALANCE_NOT_ENOUGH 付款方余额不足 支付时间点付款方余额不足,请向付款账户余额充值后再原请求重试。
PAYER_USER_INFO_ERROR 付款用户姓名或其它信息不一致 检查付款用户姓名payer_real_name与真实姓名一致性。
PAYMENT_INFO_INCONSISTENCY 两次请求商户单号一样,但是参数不一致 如果想重试前一次的请求,请用原参数重试,如果重新发送,请更换单号。
CARD_BIN_ERROR 收款人银行账号不正确 请确认收款人银行账号正确性,要求为借记卡卡号。
PAYEE_CARD_INFO_ERROR 收款方卡信息错误 请联系收款方确认卡号与姓名一致性。
INST_PAY_UNABLE 资金流出能力不具备 可能由于银行渠道在维护或无T0渠道,与联系支付宝客服确认。
MEMO_REQUIRED_IN_TRANSFER_ERROR 根据监管部门的要求,单笔转账金额达到50000元时,需要填写付款理由 请填写remark或memo字段。
PERMIT_CHECK_PERM_IDENTITY_THEFT 您的账户存在身份冒用风险,请进行身份核实解除限制 您的账户存在身份冒用风险,请进行身份核实解除限制
REMARK_HAS_SENSITIVE_WORD 转账备注包含敏感词,请修改备注文案后重试 转账备注包含敏感词,请修改备注文案后重试
EXCEED_LIMIT_DM_AMOUNT 日累计额度超限 请根据接入文档说明检查本日请求总金额+本次请求金额是否超限。
NO_ACCOUNT_RECEIVE_PERMISSION 没有该账户的收款权限 请更改收款账号
BALANCE_IS_NOT_ENOUGH 付款方余额不足 请更换付款方或者充值后再重试
NO_ACCOUNT_PAYMENT_PERMISSION 没有该账户的支付权限 请更换付款方再重试
INVALID_PARAMETER 参数有误参数有误 请根据入参说明检查请求参数合法性
PAYER_NOT_EXIST 付款方不存在 请更换付款方再重试
PRODUCT_NOT_SIGN 产品未签约 请签约产品之后再使用该接口
SYSTEM_ERROR 系统繁忙 请联系支付宝工程师排查
PAYMENT_TIME_EXPIRE 请求已过期 请求单据已过期,重新发起一笔。
PAYEE_NOT_EXIST 收款用户不存在 请换收款方账号再重试。
PAYEE_ACCOUNT_STATUS_ERROR 收款方账号异常 请换收款方账号再重试。
PERMIT_NON_BANK_LIMIT_PAYEE 收款方未完善身份信息或未开立余额账户,无法收款 根据监管部门的要求,收款方未完善身份信息或未开立余额账户,无法收款
PERMIT_NON_BANK_LIMIT_PAYEE 收款方未完善身份信息或未开立余额账户,无法收款 根据监管部门的要求,收款方未完善身份信息或未开立余额账户,无法收款
PAYEE_TRUSTEESHIP_ACC_OVER_LIMIT 收款方托管子户累计收款金额超限 收款方托管子户累计收款金额超限,请绑定支付宝后完成收款。
NO_PERMISSION_ACCOUNT 无权限操作当前付款账号 无权限操作当前付款账号
TRUSTEESHIP_ACCOUNT_NOT_EXIST 托管子户查询不存在 托管子户查询不存在
PAYEE_ACCOUNT_NOT_EXSIT 收款账号不存在 请检查收款方支付宝余额账号是否存在
ORDER_NOT_EXIST original_order_id错误 原单据不存在 original_order_id数据错误,原单据不存在
PAYEE_USERINFO_STATUS_ERROR 收款方用户状态不正常 收款方用户状态不正常无法用于收款
PAYMENT_MONEY_NOT_ENOUGH 可用金额为0或不足 资金池领取金额为0或转账金额超过资金池里可使用的金额,比如红包领取 领取金额大于可领取的金额
TRUSTEESHIP_RECIEVE_QUOTA_LIMIT 收款方收款额度超限,请绑定支付宝账户 收款方收款额度超限,请绑定支付宝账户。
SECURITY_CHECK_FAILED 本次请求有风险 本次请求有风险导致失败
NO_ORDER_PERMISSION orinal_order_id错误,不具有操作权限 orinal_order_id错误,不具有操作权限
ORDER_STATUS_INVALID 原始单据状态异常,不可操作 orinal_order_id对应的原始单据状态异常,不可继续操作
PERM_AML_NOT_REALNAME_REV 根据监管部门的要求,需要收款用户补充身份信息才能继续操作 请联系收款方登录支付宝站内或手机客户端补充身份信息
PERM_AML_NOT_REALNAME_REV 根据监管部门的要求,需要收款用户补充身份信息才能继续操作 请联系收款方登录支付宝站内或手机客户端补充身份信息
USER_AGREEMENT_VERIFY_FAIL 用户协议校验失败 确认入参中协议号是否正确
PAYER_NOT_EQUAL_PAYEE_ERROR 托管场景提现收付款方账号不一致 请检查收付款方账号是否一致
EXCEED_LIMIT_DC_RECEIVED 收款方单日收款笔数超限 收款方向同一个付款用户每日只能收款固定的笔数,超限后请让用户第二天再收。
PAYER_PERMLIMIT_CHECK_FAILURE 付款方限权校验不通过不允许支付 付款方限权校验不通过不允许支付,联系支付宝客服检查付款方受限原因。
PAYEE_ACC_OCUPIED 收款方登录号有多个支付宝账号,无法确认唯一收款账号 收款方登录号有多个支付宝账号,无法确认唯一收款账号,请收款方变更登录号或提供其他支付宝账号进行收款。
PAYER_PAYEE_CANNOT_SAME 收付款方不能相同 收付款方不能是同一个人,请修改收付款方信息
PERMIT_CHECK_PERM_LIMITED 根据监管部门的要求,请补全您的身份信息解除限制 根据监管部门的要求,请补全您的身份信息解除限制
PERMIT_CHECK_PERM_LIMITED 根据监管部门的要求,请补全您的身份信息解除限制 根据监管部门的要求,请补全您的身份信息解除限制
RESOURCE_LIMIT_EXCEED 请求超过资源限制 发起请求并发数超出支付宝处理能力,请降低请求并发
INVALID_PAYER_ACCOUNT 付款方不在设置的付款账户列表中 请核对付款方是否在销售方案付款账户列表中
EXCEED_LIMIT_DM_MAX_AMOUNT 超出单日转账限额 超出单日转账限额
EXCEED_LIMIT_PERSONAL_SM_AMOUNT 超出转账给个人支付宝账户的单笔限额 超出转账给个人支付宝账户的单笔限额
EXCEED_LIMIT_UNRN_DM_AMOUNT 收款账户未实名,超出其单日收款限额 收款账户未实名,超出其单日收款限额
INVALID_CARDNO 无效的收款卡号 无效的收款卡号,请确认
RELEASE_USER_FORBBIDEN_RECIEVE 支付宝手机号二次放号禁止收款 联系收款用户,更换支付宝账号后收款
PAYEE_USER_TYPE_ERROR 不支持的收款用户类型 不支持的收款用户类型,请联系收款用户,更换支付宝账户后收款
EXCEED_LIMIT_SM_MIN_AMOUNT 请求金额低于单笔最小转账金额 请修改转账金额。
PERMIT_CHECK_RECEIVE_LIMIT 您的账户限制收款,请咨询95188电话咨询 请咨询95188电话咨询
NOT_IN_WHITE_LIST 您的请求不在白名单范围内 您的请求不在白名单范围内,请咨询95188电话咨询
MONEY_PAY_CLOSED 付款账号余额关闭 付款账号余额关闭,请拨打95188咨询
NO_AVAILABLE_PAYMENT_TOOLS 您当前无法支付,请咨询95188 您当前无法支付,请咨询95188
PAYEE_NOT_RELNAME_CERTIFY 收款方未实名认证 收款方未实名认证
OVERSEA_TRANSFER_CLOSE 您无法进行结汇业务,请联系95188 您无法进行结汇业务,请联系95188
PAYMENT_FAIL 支付失败 支付失败
onlineServer