首页分享开发接入

开发接入

来源：花匠小妙招时间：2024-11-14 12:59

参数

类型

最大长度

是否必填

参数说明

out_biz_no

String

必选

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

trans_amount

String

必选

订单总金额，单位为元，不支持千位分隔符，精确到小数点后两位，取值范围[0.1,100000000]。
注意：最小可传金额 0.1 元，最大可传金额 100000000 元，如超过最小或最大金额限制，可能会导致金额超限等接口报错。
示例值：1.68

product_code

String

必选

销售产品码。单笔无密转账固定为 TRANS_ACCOUNT_NO_PWD。

biz_scene

String

必选

业务场景。单笔无密转账固定为 DIRECT_TRANSFER。

payee_info

Participant

必选

收款方信息。

└ identity_type

String

必选

收款方的标识类型，目前支持如下枚举：
●ALIPAY_USER_ID：支付宝会员的用户 ID，可通过获取会员信息能力获取。
●ALIPAY_LOGON_ID：支付宝登录号，支持邮箱和手机号格式。
●ALIPAY_OPEN_ID：支付宝会员的用户 ID，可通过获取会员信息能力获取。

└ identity

String

必选

收款方的标识 ID。
●当 identity_type=ALIPAY_USER_ID 时，填写支付宝用户 ID。
●当 identity_type=ALIPAY_LOGON_ID 时，填写支付宝登录号。
●当 identity_type=ALIPAY_OPEN_ID 时，填写支付宝用户 ID。

└ name

String

256

可选

收款方真实姓名。如果非空，将校验收款支付宝账号姓名一致性。
当 identity_type=ALIPAY_LOGON_ID 时，本字段必填。若传入该属性，则在支付宝回单中将会显示这个属性。

order_title

String

必选

转账业务的标题，用于在支付宝用户的账单里显示。
示例值：201905代发

remark

String

200

可选

业务备注。
示例值：201905代发

business_params

String

2048

可选

转账业务请求的扩展参数，支持传入的扩展参数如下：
●payer_show_name_use_alias：是否展示付款方别名，可选，收款方在支付宝账单中可见。枚举支持：
○true：展示别名，将展示商家支付宝在商家平台商户信息画板 > 商户基本信息页面配置的商户别名。
○false：不展示别名。默认为 false。
示例值：{"payer_show_name_use_alias":"true"}