线上资金授权冻结接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/fund/auth/order/app/freeze
注意:
请使用sdkExecute方法发起请求！
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | ORDER_ALREADY_CLOSED | 授权失败，本笔授权订单已关闭 | 更换商户授权资金订单号后，重新发起请求 |
| 400 | FREEZE_ALREADY_SUCCESS | 授权失败，授权订单已经冻结成功，请勿重复授权 | 确认该笔预授权信息是否为当前付款方的，如果是则认为授权成功，如果不是则更换商家授权资金订单号后，重新发起请求 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 请立即调用查询订单API，查询当前订单的状态，并根据订单状态决定下一步的操作 |
| 400 | ORDER_ALREADY_FINISH | 授权失败，本笔授权订单已经完结，无法再进行资金操作 | 更换商家授权资金订单号后，重新发起请求 |
| 400 | EXIST_FORBIDDEN_WORD | 授权失败，订单信息中包含违禁词 | 修改订单信息后，重新发起请求 |
| 400 | ILLEGAL_ARGUMENT | 授权失败，预授权冻结参数异常或参数缺失，请顾客刷新付款码后重新收款 | 检查请求参数，修改后重新发起请求 |
| 400 | ACCESS_FORBIDDEN | 授权失败，本商户没有权限使用该产品，建议顾客使用其他方式付款 | 未签约合同或者合同已到期 |
| 400 | PAYEE_NOT_EXIST | 授权失败，收款方账号不存在 | 确认该收款方账号是注册过的支付宝账号 |
| 400 | PAYER_NOT_EXIST | 授权失败，获取顾客账户信息失败 | 顾客重新登录支付宝后，再发起请求 |
| 400 | PAYER_USER_STATUS_LIMIT | 授权失败，顾客账户暂时无法支付，建议顾客使用其他方式付款 | 买家支付宝账户受限，请登录支付宝认证升级，详情咨询 4007585858 |
| 400 | PAYEE_USER_STATUS_LIMIT | 授权失败，收款方账号异常 | 卖家支付宝账户受限，请登录支付宝认证升级，详情咨询 4007585858 |
| 400 | CURRENCY_VERIFICATION_FAIL | 币种校验失败 | 确认标价币种、结算币种正确后重新发起请求 |
| 400 | RESTRICTED_MERCHANT_INDUSTRY | 商户所属行业MCC单笔订单金额限制 | 请商户与支付宝客服确认行业MCC订单金额限制信息 |
| 400 | FOREX_ID_VERIFICATION_FAIL | 用户身份校验失败 | 请确认用户为大陆身份证认证用户 |
| 400 | PRODUCT_AMOUNT_LIMIT_ERROR | 购汇额度校验失败 | 请与客服确认用户购汇额度信息 |
| 400 | SECONDARY_MERCHANT_STATUS_ERROR | 商户状态异常 | 请商户与支付宝客服联系确认 |
| 400 | USER_IDENTITY_INFO_VALIDATE_FAIL | 用户实名信息校验失败 | 用户实名信息校验失败，请确认当前用户与支付宝用户是否匹配。 |
| 400 | USER_ACCOUNT_VALIDATE_FAIL | 用户账号校验失败 | 用户账号信息校验失败，请确认当前用户与支付宝用户是否匹配。 |
| 400 | SUB_MERCHANT_ORG_ID_ERROR | 间联模式下，传入的二级商户的机构id为空或错误 | 间联模式下，传入正确的机构id |
| 400 | SUB_MERCHANT_LEVEL_ERROR | 间联商户等级校验错误 | 间联商户等级校 验错误，请提高间联商户的等级 |
| 400 | SUB_MERCHANT_NO_PERMISSION | 间联商户无权使用该产品 | 商户暂时不符合产品的使用场景 |
| 400 | MERCHANT_STATUS_ERROR | 商户状态错误 | 商户状态异常，请联系支付宝核实 |
关联异步通知
触发通知类型
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| fund_auth_freeze | 资金预授权冻结成功 | 1 |
| fund_auth_freeze.closed | 资金预授权订单关闭 | 0 |
| fund_auth_freeze.init | 资金预授权订单创建 | 0 |
触发通知示例
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/fund/auth/order/app/freeze' \
--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 '{
"notify_url":"http://api.test.alipay.net/atinterface/receive_notify.htm",
"out_order_no":"8077735255938023",
"out_request_no":"8077735255938032",
"order_title":"XX租车押金",
"amount":0.01,
"product_code":"PRE_AUTH_ONLINE",
"payee_user_id":"2088102000275795",
"payee_logon_id":"159****5620",
"timeout_express":"2d",
"enable_pay_channels":"[{\"payChannelType\":\"PCREDIT_PAY\"},{\"payChannelType\":\"MONEY_FUND\"}]",
"disable_pay_channels":"[{\"payChannelType\":\"OPTIMIZED_MOTO\"},{\"payChannelType\":\"BIGAMOUNT_CREDIT_CARTOON\"}]",
"identity_params":"{\"identity_hash\":\"acc2b92ffc5ed9b472faa19748f10045c30434132784f774b00216a56b8841c6\"}",
"extra_param":"{\"category\":\"CHARGE_PILE_CAR\",\"serviceId\":\"2020042800000000000001450466\"}",
"business_params":"{\"outRiskInfo\":\"{\\\"mcCreateTradeTime\\\":\\\"2022-03-11 12:46:09\\\",\\\"extraAccountCertnoLastSix\\\":\\\"000011\\\",\\\"mobileOperatingPlatform\\\":\\\"ios\\\",\\\"sysVersion\\\":\\\"15.4.2\\\",\\\"mcCreateTradeIp\\\":\\\"11.110.111.43\\\"}\"}",
"deposit_product_mode":"POSTPAY",
"post_payments":[
{
"name":"租金",
"amount":"0.01",
"description":"2元/小时，99元封顶"
}
]
}'响应示例响应示例
{
"auth_no":"2014070800002001550000014417",
"out_order_no":"4977164666634053",
"operation_id":"2014070800032850551",
"out_request_no":"2014070700166653",
"amount":0.01,
"status":"SUCCESS",
"gmt_trans":"2014-09-15 11:23:04",
"payer_user_id":"2088102000275885",
"pre_auth_type":"CREDIT_AUTH",
"credit_amount":0.01,
"fund_amount":0.01,
"trans_currency":"USD"
}请求参数
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
返回响应
修改于 2023-11-23 02:45:43