- 支付
- 私域
- 公域
- 营销
- 资金
- 会员
- 信用
- 安全
- 其他
ISV向商户发起应用授权邀约
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/open/auth/appauth/invite/create
错误码#
公共错误码#
业务错误码#
状态码 | 错误码 | 错误描述 | 解决方案 |
---|---|---|---|
400 | PARAM_NOEXIST_ISV_APPID | ISV AppId不存在 | 检查调用openapi的appid是否正确 |
400 | ISV_PUNISHED | ISV账号被处罚 | 检查ISV账号是否有被处罚等异常 |
400 | ISV_APP_PUNISHED | ISV应用被处罚 | 检查发起调用的应用是否被处罚 |
400 | APP_NOT_FOUND | 指定的商户应用不存在 | 检查是否指定了错误的商户应用auth_app_id |
400 | APPAUTH_RELATION_NOT_EXIST | 指定的商户应用未授权给当前ISV应用 | 检查指定的商户应用的授权状态,无法对未授权的应用发起邀约 |
400 | REDIRECT_URI_ERROR | 回调地址错误 | 指定的回调地址(redirect_url)需要与应用配置的回调地址一致 |
400 | PARAM_STATE_INVALID | state参数错误 | 检查state参数,长度不能超过100,且必须在base64的字符集中 |
400 | APPAUTH_INVITE_LIMIT | 应用授权邀约数量超限 | 超过对指定auth_app_id的每日邀约次数限制,请次日再尝试。 |
400 | SYSTEM_ERROR | 系统繁忙 | 内部错误,请稍后重试 |
400 | ISV_APP_NOT_ONLINE | ISV应用未上线 | 检查第三方应用状态,需要是已上线状态 |
400 | AUTHED_APP_ISNOT_ALLOWED_ROLE | 应用不能作为被授权方 | 使用其它第三方应用发起调用 |
400 | APPAUTH_INVITE_FREQUENT | 应用授权邀约过于频繁 | 对同一商户的授权邀约过于频繁,请稍后再试 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/auth/appauth/invite/create' \
--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 '{
"auth_app_id":"2021003146698562",
"redirect_url":"https://example.com",
"state":"MDAyMDIy"
}'
响应示例响应示例
{
"task_page_url":"https://example.com"
}
请求参数
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
auth_app_id
string
必需
redirect_url
string
可选
state
string
可选
示例
返回响应
🟢200成功
application/json
Body
task_page_url
string
必需
修改于 2023-11-23 05:58:54