Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

订阅结果通知

当订阅创建成功或失败时，Antom 会使用此接口将订阅结果发送给商家。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：


注意：将每个字段（除数组外）的数据类型设置为字符串。这意味字段值必须使用双引号（" "）括起来。例如：

  • 如果字段的数据类型为整数属性，且其值为 20，设置为 "20"。
  • 如果字段的数据类型为布尔属性，且其值为 true，设置为 "true"。

入参

subscriptionRequestId String  REQUIRED

商家为识别订阅请求而分配的专属 ID。

更多信息：

  • 最大长度：64 字符

subscriptionId String  REQUIRED

Antom 为识别订阅而分配的专属 ID。

更多信息：

  • 最大长度：64 字符

subscriptionStatus String  REQUIRED

订阅状态。有效值包括：

  • ACTIVE: 表示订阅已生效。
  • TERMINATED: 表示订阅已被终止。

更多信息：

  • 最大长度：32 字符

subscriptionNotificationType String  REQUIRED

关于订阅的通知类型。

  • CREATE: 表示订阅已创建。
  • CHANGE: 表示订阅已更改。
  • CANCEL: 表示订阅被取消，服务在当前订阅期结束后不再提供。
  • TERMINATE: 表示订阅被终止，不再提供服务。

更多信息：

  • 最大长度：32 字符

subscriptionStartTime Datetime  REQUIRED

订阅生效的日期和时间。

更多信息：

  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

subscriptionEndTime Datetime  REQUIRED

订阅结束的日期和时间。

更多信息：

  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

periodRule PeriodRule object REQUIRED

订阅周期规则，用于定义订阅的计费周期。

Show child parameters

出参

result Result object REQUIRED

发送给 Antom 来确认已收到通知的固定值。

Show child parameters
API Explorer

请求

Case
Subscription creation notification
请求体

响应

响应体

结果处理逻辑

收到 Antom 的通知后，请您发送以下含有固定数值的报文给 Antom，确认已收到 Antom 的通知。

Sample Code

如果由于操作问题或网络问题未能及时向 Antom 返回此消息，Antom 将在 24 小时内自动最多重试发送通知八次，直至收到正确的响应为止。发送间隔如下：0 秒，2 分钟，10 分钟，10 分钟，1 小时，2 小时，6 小时和 15 小时。