通用场景
pc场景创建资金单据并支付
公共请求参数
业务请求参数
out_biz_no必选string(64)
【描述】商户端的唯一订单号，对于同一笔转账请求，商户需保证该订单号唯一。
【示例值】2018062800001
trans_amount必选price(16)
【描述】订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,9999999999999.99]
【示例值】8.88
product_code必选string(64)
【描述】销售产品码，商家和支付宝签约的产品码
【示例值】std_app_transfer
biz_scene必选string(64)
【描述】描述特定的业务场景，比如对党费缴纳场景需走党费专户
【示例值】party_membership_dues
payee_info特殊可选participant
【描述】收款方信息
identity必选string(64)
【描述】参与方的唯一标识
【示例值】testaccount@alipay.com
identity_type必选string(64)
【描述】参与方的标识类型，目前支持如下类型：
1、alipay_user_id 支付宝的会员id
2、alipay_logon_id：支付宝登录号，支持邮箱和手机号格式
3、alipay_open_id：支付宝openid
【枚举值】
支付宝的会员id: alipay_user_id
支付宝登录号: alipay_logon_id
支付宝openid: alipay_open_id
【示例值】alipay_open_id
bankcard_ext_info｜银行卡的附加信息描述特殊可选bankcardextinfo(2048)
【描述】如果identity_type为bankcard_no需传递该参数，涉及属性如下： inst_name 银行卡卡开户银行 inst_province 银行所在省份 inst_city 银行所在市 inst_branch_name 收款银行所属支行 bank_code 银行卡支行联行号 account_type 银行卡账户类型 1:对公 2：对私
inst_name必选string(64)
【描述】机构名称
【示例值】招商银行
account_type必选string(2)
【描述】收款账户类型。
1：对公（在金融机构开设的公司账户）,如果银行卡为对公，必须传递省市支行信息或者联行号
2：对私（在金融机构开设的个人账户）
【枚举值】
公司: 1
个人: 2
【示例值】1
inst_province可选string(64)
【描述】银行所在省份
【示例值】江苏省
inst_city可选string(64)
【描述】收款银行所在市
【示例值】南京市
inst_branch_name可选string(128)
【描述】收款银行所属支行
【示例值】新街口支行
bank_code可选string(32)
【描述】银行支行联行号
【示例值】123456
name可选string(128)
【描述】参与方真实姓名，如果非空，将校验收款支付宝账号姓名一致性。当identity_type=alipay_logon_id时，本字段必填。
【示例值】黄龙国际有限公司
merchant_user_info可选string(2048)
【描述】商户端的用户信息描述，目前可指定如下属性：
merchant_user_id：商户端的用户唯一id
merchant_user_name：商户端的用户名
merchant_user_nickname：商户端的用户昵称
merchant_user_mobile：商户端的手机号
【示例值】{"merchant_user_id":"test"}
ext_info可选string(2048)
【描述】描述参与方信息的扩展属性，使用前请与支付宝工程师确认
【示例值】{"alipay_anonymous_uid":"test"}
remark可选string(200)
【描述】转账备注
【示例值】报销款201806
order_id可选string(64)
【描述】支付宝订单号，仅批量有密场景下生效
【示例值】202001160013496991
payer_info可选participant
【描述】付款方信息
identity必选string(64)
【描述】参与方的唯一标识
【示例值】testaccount@alipay.com
identity_type必选string(64)
【描述】参与方的标识类型，目前支持如下类型：
1、alipay_user_id 支付宝的会员id
2、alipay_logon_id：支付宝登录号，支持邮箱和手机号格式
3、alipay_open_id：支付宝openid
【枚举值】
支付宝的会员id: alipay_user_id
支付宝登录号: alipay_logon_id
支付宝openid: alipay_open_id
【示例值】alipay_open_id
bankcard_ext_info｜银行卡的附加信息描述特殊可选bankcardextinfo(2048)
【描述】如果identity_type为bankcard_no需传递该参数，涉及属性如下： inst_name 银行卡卡开户银行 inst_province 银行所在省份 inst_city 银行所在市 inst_branch_name 收款银行所属支行 bank_code 银行卡支行联行号 account_type 银行卡账户类型 1:对公 2：对私
inst_name必选string(64)
【描述】机构名称
【示例值】招商银行
account_type必选string(2)
【描述】收款账户类型。
1：对公（在金融机构开设的公司账户）,如果银行卡为对公，必须传递省市支行信息或者联行号
2：对私（在金融机构开设的个人账户）
【枚举值】
公司: 1
个人: 2
【示例值】1
inst_province可选string(64)
【描述】银行所在省份
【示例值】江苏省
inst_city可选string(64)
【描述】收款银行所在市
【示例值】南京市
inst_branch_name可选string(128)
【描述】收款银行所属支行
【示例值】新街口支行
bank_code可选string(32)
【描述】银行支行联行号
【示例值】123456
name可选string(128)
【描述】参与方真实姓名，如果非空，将校验收款支付宝账号姓名一致性。当identity_type=alipay_logon_id时，本字段必填。
【示例值】黄龙国际有限公司
merchant_user_info可选string(2048)
【描述】商户端的用户信息描述，目前可指定如下属性：
merchant_user_id：商户端的用户唯一id
merchant_user_name：商户端的用户名
merchant_user_nickname：商户端的用户昵称
merchant_user_mobile：商户端的手机号
【示例值】{"merchant_user_id":"test"}
ext_info可选string(2048)
【描述】描述参与方信息的扩展属性，使用前请与支付宝工程师确认
【示例值】{"alipay_anonymous_uid":"test"}
order_title可选string(128)
【描述】转账订单的标题，用于在收银台和消费记录展示
【示例值】党费-201806
time_expire可选string(16)
【描述】支付绝对超时时间，格式为yyyy-mm-dd hh:mm
【示例值】2018-03-23 19:15
refund_time_expire可选string(16)
【描述】自动退款绝对超时时间，格式为yyyy-mm-dd hh:mm
【示例值】2019-12-31 10:05
passback_params可选string(256)
【描述】公用回传参数，如果请求时传递了该参数，则异步通知商户时会回传该参数。
【示例值】{"merchantbiztype":"peerpay"}
business_params可选string(2048)
【描述】json格式，传递业务扩展参数，使用前请与支付宝工程师联系！
【示例值】{"merchant_payer_id":"1234567890","merchant_payer_phone:"15012341234"}
常见请求示例
默认示例
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipayfundtranspagepayrequest request = new alipayfundtranspagepayrequest();
request.setbizcontent("{"
" \"out_biz_no\":\"2018062800001\","
" \"trans_amount\":\"8.88\","
" \"product_code\":\"std_app_transfer\","
" \"biz_scene\":\"party_membership_dues\","
" \"remark\":\"报销款201806\","
" \"order_id\":\"202001160013496991\","
" \"payer_info\":{"
" \"identity\":\"testacco*******pay.com\","
" \"identity_type\":\"alipay_open_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\\\":\\\"test\\\"}\","
" \"ext_info\":\"{\\\"alipay_anonymous_uid\\\":\\\"test\\\"}\""
" },"
" \"payee_info\":{"
" \"identity\":\"testacco*******pay.com\","
" \"identity_type\":\"alipay_open_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\\\":\\\"test\\\"}\","
" \"ext_info\":\"{\\\"alipay_anonymous_uid\\\":\\\"test\\\"}\""
" },"
" \"order_title\":\"党费-201806\","
" \"time_expire\":\"2018-03-23 19:15\","
" \"refund_time_expire\":\"2019-12-31 10:05\","
" \"passback_params\":\"{\\\"merchantbiztype\\\":\\\"peerpay\\\"}\","
" \"business_params\":\"{\\\"merchant_payer_id\\\":\\\"1234567890\\\",\\\"merchant_payer_phone:\\\"15012341234\\\"}\""
"}");
alipayfundtranspagepayresponse response = alipayclient.pageexecute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}说明：本示例仅供参考。
公共响应参数
业务响应参数
out_biz_no必选string(64)
【描述】商户端的唯一订单号
【示例值】201806300001
status必选string(64)
【描述】success：转账成功；
wait_pay：转账订单等待支付；
closed：订单超时关闭，截止订单支付超时时间(time_expire)仍未支付，单据状态会变更为closed；
【示例值】success
order_id特殊可选string(32)
【描述】该笔转账在支付宝系统内部的单据id
【示例值】20180629110070001502040007320562
响应示例
正常示例
异常示例
说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| payee_not_exist | 收款方不存在 | 收款方不存在，请商户重新输入收款方账户信息 |