使用实时通知

实时通知 (RTN) 是服务器到服务器的消息，可将应用内购买事件相关信息通知到应用的后端服务器。此页面介绍了如何在开发者控制台中注册和验证终端节点，如何更改或删除终端节点，以及如何处理亚马逊发送的消息。

设置实时通知

要注册新的终端节点，亚马逊会向该终端节点发送一条确认消息，其中包含确认令牌。您需要从该消息中复制令牌并将其粘贴到控制台中的Confirmation token（确认令牌）字段，以完成设置。新终端节点必须完成验证，才能接收通知。

在开发者控制台中设置RTN

1. 登录开发者控制台。
2. 在顶部导航栏中，选择我的应用。
3. 在列表中找到您的应用，选择菜单图标 ，然后选择应用服务。
4. 在实时通知部分中，选择添加终端节点。
5. 在用于接收亚马逊应用商店通知的URL中输入您应用的HTTPS终端节点，然后选择提交。
6. 从亚马逊发送到您的终端节点的确认消息中检索确认令牌。
7. 将令牌粘贴到Confirmation token（确认令牌）字段中，然后选择Confirm（确认）。

令牌的有效期为自通知发送时间起48小时。如果令牌过期或确认消息未送达，请参阅重新发送过期或丢失的令牌。提交有效令牌后，终端节点状态变为Verified（已验证），并开始接收通知。

升级旧终端节点

旧终端节点是指已经收到通知，但其设置尚未完成验证，因此需要进行确认的终端节点。要升级旧终端节点，必须通过请求新的确认令牌并提交来对其进行验证。对旧终端节点进行验证不会造成任何中断。该终端节点会持续接收通知，但只有在您确认令牌后，才会变更为已完成验证的状态。

对旧终端节点进行验证

1. 登录开发者控制台。
2. 在顶部导航栏中，选择我的应用。
3. 在列表中找到您的应用，选择菜单图标 ，然后选择应用服务。
4. 在实时通知部分中，找到带有要求您对其进行验证的横幅的终端节点。
5. 选择Resend（重新发送），向终端节点发送新的确认令牌。
6. 从亚马逊发送到您的终端节点的确认消息中检索确认令牌。
7. 将令牌粘贴到Confirmation token（确认令牌）字段中，然后选择Confirm（确认）。

令牌的有效期为自通知发送时间起48小时。如果令牌过期，请参阅重新发送过期或丢失的令牌。提交有效令牌后，终端节点状态变更为Verified（已验证）。

重新发送过期或丢失的令牌

确认令牌的有效期为自通知发送时间起48小时。如果令牌过期或确认消息未送达，请申请新令牌。这既适用于正在验证中的新终端节点，也适用于等待验证的旧终端节点。

申请新的确认令牌

1. 登录开发者控制台。
2. 在顶部导航栏中，选择我的应用。
3. 在列表中找到您的应用，选择菜单图标 ，然后选择应用服务。
4. 在实时通知部分中，找到等待验证的终端节点。
5. 选择Resend（重新发送）以发送确认消息，其中包含新令牌。
6. 从亚马逊发送到您的终端节点的确认消息中检索新令牌。
7. 将令牌粘贴到Confirmation token（确认令牌）字段中，然后选择Confirm（确认）。

更改RTN终端节点

如果需要将通知转移到其他HTTPS URL，请更改RTN终端节点。在确认新的终端节点之前，当前终端节点会持续接收通知，因此递送不会间断。

更改RTN终端节点

1. 登录开发者控制台。
2. 在顶部导航栏中，选择我的应用。
3. 在列表中找到您的应用，选择菜单图标 ，然后选择应用服务。
4. 在实时通知部分中，选择添加终端节点，然后选择编辑。
5. 选择Add a new URL（添加新URL），或选择之前已注册的终端节点。
6. 选择提交。
7. 从亚马逊发送到新终端节点的确认消息中检索确认令牌。
8. 将令牌粘贴到Confirmation token（确认令牌）字段中，然后选择Confirm（确认）。

在您提交有效的确认令牌之前，新终端节点的状态为Under Verification（验证中）。在确认新终端节点之前，先前终端节点会持续接收实时通知。令牌的有效期为自通知发送时间起48小时。如果令牌过期或确认消息未送达，请参阅重新发送过期或丢失的令牌。

提交有效令牌后，新终端节点状态变为Verified（已验证），并开始接收通知。

删除RTN终端节点

如果您不想再通过某个RTN终端节点对应的URL接收通知，请删除该终端节点。

删除RTN终端节点

1. 登录开发者控制台。
2. 在顶部导航栏中，选择我的应用。
3. 在列表中找到您的应用，选择菜单图标 ，然后选择应用服务。
4. 在实时通知部分中，选择添加终端节点，然后选择编辑。
5. 找到相应的URL，然后选择删除。
6. 在显示的确认对话框中选择删除。

检查终端节点的状态

您可以在开发者控制台的实时通知部分中检查终端节点的状态。

查看终端节点状态

1. 登录开发者控制台。
2. 在顶部导航栏中，选择我的应用。
3. 在列表中找到您的应用，选择菜单图标 ，然后选择应用服务。
4. 转到实时通知部分，查看任意消息。要查看已注册终端节点及其状态，请选择添加终端节点。

开发者控制台会显示终端节点的状态，并且可能会附上有关所需操作的消息。下表介绍了终端节点的参考状态以及它们在控制台中的显示方式。

参考状态	描述	您在控制台中看到的内容
Active (Unauthenticated)	收到通知但尚未完成确认令牌验证的旧终端节点。 待完成操作： 按照升级旧终端节点中所述进行验证。	提示您对终端节点进行验证的横幅 Confirmation token（确认令牌）字段可用（使用Resend（重新发送）获取令牌） 表示该URL正在接收实时通知
Under Verification	正在等待确认的新终端节点或已更改终端节点。在您输入确认令牌之前，该URL不会接收通知。 待完成操作： 提交在终端节点收到的确认令牌。	表示已向终端节点发送验证请求的横幅 Confirmation token（确认令牌）字段可用 URL标记为Under Verification（验证中） 表示该URL没有在接收实时通知
Active (Authenticated)	已完成确认令牌验证并接收通知的终端节点。	URL标记为Verified（已验证） 表示该URL正在接收实时通知

处理通知消息

为防止发生欺骗攻击，必须对亚马逊签名进行验证，以核实消息的真实性。有关更多信息，请参阅Amazon SNS消息签名验证。

如果使用亚马逊AWS SDK，则HTTPS POST和签名验证会由其为您处理。

如果未使用亚马逊AWS SDK，请遵循Amazon SNS消息签名验证中所述Amazon SNS消息格式解析指南，处理HTTPS POST请求和签名验证步骤。

RTN确认消息

当您注册或更改终端节点时，亚马逊会向该终端节点发送一条确认消息，其中包含确认令牌。要确认终端节点，请从消息中检索令牌，然后将其粘贴到开发者控制台的Confirmation token（确认令牌）字段中。有关完整流程，请参阅设置实时通知。有关确认消息的示例，请参阅确认消息。

令牌的有效期为自通知发送时间起48小时。如果令牌过期或确认消息未送达，请参阅重新发送过期或丢失的令牌。

通知

您的终端节点需要向该POST请求返回200响应代码状态。如果无法访问您的服务器，或返回4xx代码，则不会重试该消息。

如果您的终端节点未在15秒超时限制内做出响应，或返回200–4xx代码之外的响应，则视为消息递送失败并将重试该消息。

---

Last updated: 2026年10月8日