取消授权
授权完成后,您需为买家提供授权协议取消功能,主要原因如下:
- 保障买家对其授权协议的自主管理权,允许买家根据个人账户安全策略或服务使用需求,随时终止已建立的授权关系。
- 同一 Antom 全球商家账户在单一商户维度仅允许维持一个有效令牌。
如果买家在您的应用内取消授权,您需要调用 revoke 接口使支付方式的支付令牌失效。
在接口请求中传入该代扣服务对应的支付令牌(accessToken),接口调用成功后可使该支付令牌(accessToken)失效。以下是调用 revoke 接口的请求报文的代码示例:
copy
public static void Cancel() {
AlipayAuthRevokeTokenRequest alipayAuthRevokeTokenRequest = new AlipayAuthRevokeTokenRequest();
// replace with your accessToken
alipayAuthRevokeTokenRequest.setAccessToken("281010033AB2F588D14B43238637264FCA5Axxxx");
AlipayAuthRevokeTokenResponse alipayAuthRevokeTokenResponse = null;
try {
alipayAuthRevokeTokenResponse = CLIENT.execute(alipayAuthRevokeTokenRequest);
} catch (AlipayApiException e) {
String errorMsg = e.getMessage();
// handle error condition
}
}以下是请求报文的代码示例:
copy
{
"accessToken": "281010033AB2F588D14B43238637264FCA5Axxxx"
}以下是响应的代码示例:
copy
{
"result": {
"resultCode": "SUCCESS",
"resultMessage": "Success",
"resultStatus": "S"
}
}以下为响应报文中 result.resultStatus 字段可能返回的值,您可以根据指引进行处理:
result.resultStatus | 信息 | 后续操作 |
S | 取消授权成功。 | 无需进一步操作。 |
U | 取消授权结果未知。 | 保持 accessToken 不变重新调用接口以解决问题或者等待异步通知。如果问题未解决,请联系 Antom 技术支持。 |
F | 取消授权失败。 | 检查并验证当前接口所需的请求字段(包括头部字段和正文字段)是否正确传递并有效。 |
注意:
- 如果您未收到响应报文,可能是网络超时所致。保持 accessToken 不变重新调用接口以解决问题。如果问题未解决,请联系 Antom 技术支持。
- 目前不支持买家在 Antom 全球商家账户侧取消授权。