取消授权

授权完成后,您需为买家提供授权协议取消功能,主要原因如下:

  • 保障买家对其授权协议的自主管理权,允许买家根据个人账户安全策略或服务使用需求,随时终止已建立的授权关系。
  • 同一 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 全球商家账户侧取消授权。