现金红包无线支付接口

外部商户APP唤起快捷SDK创建现金红包单据并进行支付

错误码

公共错误码

业务错误码

状态码	错误码	错误描述	解决方案
400	INVALID_PARAMETER	参数有误参数有误	参数校验失败
400	PAYEE_NOT_EXIST	收款方不存在	收款方不存在

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/fund/trans/app/pay' \ --header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \ --header 'alipay-request-id: $requestid' \ --header 'Content-Type: application/json' \ --data-raw '{ "out_biz_no":"2018062800001", "trans_amount":8.88, "order_id":"20191001110076000006120015113294", "product_code":"STD_RED_PACKET", "biz_scene":"PERSONAL_PAY", "remark":"拼手气红包", "order_title":"钉钉拼手气红包", "time_expire":"2018-03-23 19:15", "refund_time_expire":"2018-11-08 10:00", "business_params":"{\"sub_biz_scene\":\"REDPACKET\",\"payer_binded_alipay_uid\":\"2088302510459335\"}" }'

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

out_biz_no

string

必需

商户端的唯一订单号，对于同一笔转账请求，商户需保证该订单号唯一。

trans_amount

number

必需

订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,9999999999999.99]

order_id

string

支付宝订单号

可选

product_code

string

必需

销售产品码，商家和支付宝签约的产品码。 STD_RED_PACKET：现金红包

biz_scene

string

必需

描述特定的业务场景，可传值如下： PERSONAL_PAY: 发红包

remark

string

支付备注

可选

order_title

string

可选

支付订单的标题，用于在收银台和消费记录展示

time_expire

string

可选

绝对超时时间，格式为yyyy-MM-dd HH:mm

refund_time_expire

string

可选

退款超时时间，格式yyyy-MM-dd HH:mm。到指定时间后，系统会自动触发退款，并原路退回到付款账户。如果指定了退款时间，必须早于销售方案里设置的最晚退款时间。

business_params

string

可选

JSON格式，传递业务扩展参数. 业务扩展字段，JSON格式。支持如下属性： sub_biz_scene 子场景，必填，传REDPACKET payer_binded_alipay_uid 创建红包的商户会员绑定的支付宝userId，必填

示例

返回响应

🟢200成功

application/json

Body

out_biz_no

string

商户端的唯一订单号

必需

order_id

string

必需

该笔转账在支付宝系统内部的单据ID

status

string

必需

SUCCESS：转账成功； WAIT_PAY：转账订单等待支付； CLOSED：订单超时关闭，截止订单支付超时时间(time_expire)仍未支付，单据状态会变更为CLOSED；

现金红包无线支付接口

错误码#

公共错误码#

业务错误码#

请求参数

返回响应

错误码

公共错误码

业务错误码