单笔转账接口

单笔转账接口是基于支付宝的资金处理能力，为了满足支付宝商家的转账需求，针对有部分开发能力的商家，提供通过API接口完成企业自身支付宝账户到支付宝账户的转账功能。适用于：C2C现金红包的红包领取、B2C现金红包的红包发放、B2C单笔转账到支付宝账户等。
说明：本接口为公用接口，参数说明不针对特定产品。不同产品入参请参考对应产品文档。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/fund/trans/uni/transfer' \ --header 'Content-Type: application/json' \ --data-raw '{ "mutiple_currency_detail": { "ext_info": "key=value", "payment_amount": "100.00", "payment_currency": "CNY", "settlement_amount": "10.00", "settlement_currency": "CNY", "trans_amount": "10.00", "trans_currency": "CNY" }, "payee_info": { "bankcard_ext_info": { "account_type": "string", "bank_code": "string", "inst_branch_name": "string", "inst_city": "string", "inst_name": "string", "inst_province": "string" }, "ext_info": "string", "identity": "string", "identity_type": "string", "merchant_user_info": "string", "name": "string" }, "payer_info": { "bankcard_ext_info": { "account_type": "string", "bank_code": "string", "inst_branch_name": "string", "inst_city": "string", "inst_name": "string", "inst_province": "string" }, "ext_info": "string", "identity": "string", "identity_type": "string", "merchant_user_info": "string", "name": "string" }, "sign_data": { "ori_app_id": "2021000185629012", "ori_char_set": "UTF-8", "ori_out_biz_no": "商户订单号", "ori_sign": "EqHFP0z4a9iaQ1ep==", "ori_sign_type": "RSA2", "partner_id": "签名被授权方支付宝账号ID" }, "biz_scene": "DIRECT_TRANSFER", "business_params": "{\"sub_biz_scene\":\"REDPACKET\"}", "order_title": "转账标题", "original_order_id": "20190620110075000006640000063056", "out_biz_no": "201806300001", "passback_params": "{\"merchantBizType\":\"peerPay\"}", "product_code": "TRANS_ACCOUNT_NO_PWD", "remark": "单笔转账", "trans_amount": "23.00" }'

{ "order_id": "20190801110070000006380000250621", "out_biz_no": "201808080001", "pay_fund_order_id": "20190801110070001506380000251556", "settle_serial_no": "2023052993044491260542090100400", "status": "SUCCESS", "trans_date": {} }

请求参数

Body 参数application/json

mutiple_currency_detail

object (MutipleCurrencyDetail)

可选

ext_info

string

扩展字段

可选

示例值:

key=value

payment_amount

string

可选

支付金额，单位为该币种基础计价单位，如人民币为：元

示例值:

100.00

payment_currency

string

支付币种

可选

示例值:

CNY

settlement_amount

string

可选

清算金额，单位为该币种基础计价单位，如人民币为：元

示例值:

10.00

settlement_currency

string

清算币种

可选

示例值:

CNY

trans_amount

string

可选

转账金额，单位为该币种基础计价单位，如人民币为：元

示例值:

10.00

trans_currency

string

转账币种

可选

示例值:

CNY

payee_info

object (Participant)

可选

bankcard_ext_info

object (BankcardExtInfo)

可选

ext_info

string

可选

描述参与方信息的扩展属性，使用前请与支付宝工程师确认

identity

string

参与方的唯一标识

可选

identity_type

string

可选

参与方的标识类型，目前支持如下类型： 1、ALIPAY_USER_ID 支付宝的会员ID 2、ALIPAY_LOGON_ID：支付宝登录号，支持邮箱和手机号格式 3、ALIPAY_OPEN_ID：支付宝openid

merchant_user_info

string

可选

商户端的用户信息描述，目前可指定如下属性： merchant_user_id：商户端的用户唯一ID merchant_user_name：商户端的用户名 merchant_user_nickname：商户端的用户昵称 merchant_user_mobile：商户端的手机号

name

string

可选

参与方真实姓名，如果非空，将校验收款支付宝账号姓名一致性。当identity_type=ALIPAY_LOGON_ID时，本字段必填。

payer_info

object (Participant)

可选

sign_data

object (SignData)

可选

ori_app_id

string

可选

签名商户开放平台应用APPID

示例值:

2021000185629012

ori_char_set

string

可选

编码类型（大小写敏感）

示例值:

UTF-8

ori_out_biz_no

string

可选

ori_out_biz_no_001

示例值:

商户订单号

ori_sign

string

签名密文

可选

示例值:

EqHFP0z4a9iaQ1ep==

ori_sign_type

string

可选

签名算法（大小写敏感）

示例值:

RSA2

partner_id

string

可选

2088041181118800

示例值:

签名被授权方支付宝账号ID

biz_scene

string

可选

描述特定的业务场景，可传的参数如下： DIRECT_TRANSFER：单笔无密转账到支付宝，B2C现金红包; PERSONAL_COLLECTION：C2C现金红包-领红包

示例值:

DIRECT_TRANSFER

business_params

string

可选

转账业务请求的扩展参数，支持传入的扩展参数如下： sub_biz_scene 子业务场景，红包业务必传，取值REDPACKET，C2C现金红包、B2C现金红包均需传入

示例值:

{"sub_biz_scene":"REDPACKET"}

order_title

string

可选

转账业务的标题，用于在支付宝用户的账单里显示

示例值:

转账标题

original_order_id

string

可选

原支付宝业务单号。C2C现金红包-红包领取时，传红包支付时返回的支付宝单号；B2C现金红包、单笔无密转账到支付宝不需要该参数。

示例值:

20190620110075000006640000063056

out_biz_no

string

可选

商家侧唯一订单号，由商家自定义。对于不同转账请求，商家需保证该订单号在自身系统唯一。

示例值:

201806300001

passback_params

string

可选

公用回传参数，如果请求时传递了该参数，则异步通知商户时会回传该参数。

示例值:

{"merchantBizType":"peerPay"}

product_code

string

可选

业务产品码，单笔无密转账到支付宝账户固定为: TRANS_ACCOUNT_NO_PWD；收发现金红包固定为: STD_RED_PACKET；

示例值:

TRANS_ACCOUNT_NO_PWD

remark

string

业务备注

可选

示例值:

单笔转账

trans_amount

string

可选

订单总金额，单位为元，精确到小数点后两位，STD_RED_PACKET产品取值范围[0.01,100000000]； TRANS_ACCOUNT_NO_PWD产品取值范围[0.1,100000000]

示例值:

23.00

示例

返回响应

🟢200common response

application/json

Body

order_id

string

支付宝转账订单号

可选

示例值:

20190801110070000006380000250621

out_biz_no

string

商户订单号

可选

示例值:

201808080001

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（该笔转账交易成功）：成功； FAIL：失败（具体失败原因请参见error_code以及fail_reason返回值）； DEALING：处理中（转账到支付宝账户不涉及）； REFUND：退票（转账到支付宝账户不涉及）；

示例值:

SUCCESS

trans_date

string

可选

订单支付时间，格式为yyyy-MM-dd HH:mm:ss

示例值:

{}

🔴500请求失败