Retention Messaging API của Apple đưa lời nhắn của bạn lên màn hình hủy, nhưng yêu cầu hoàn tiền không bao giờ đi qua đó

Người đăng ký chạm Cancel trên iPhone giờ đây có thể thấy một lời nhắn do bạn chọn, một gói rẻ hơn hoặc một khoản giảm giá, trước khi họ xác nhận. Đó là Retention Messaging API của Apple, và đây là lần đầu tiên nhà phát triển có tiếng nói trên chính màn hình hủy của Apple. Nó vẫn là bản phát hành trước mà bạn phải xin tham gia. Nó cũng có một ranh giới cứng, rất quan trọng nếu bạn quan tâm đến hoàn tiền: nó nói chuyện với những người sắp ngừng trả tiền, không phải với những người đòi lại tiền. Các yêu cầu đó đến Apple bằng một con đường khác.

Retention Messaging API của Apple làm gì

Retention Messaging API là một dịch vụ server-to-server. Bạn tải nội dung lời nhắn và hình ảnh lên Apple từ trước, Apple duyệt chúng, rồi bạn chọn lời nhắn đã được duyệt nào sẽ hiện cho người đăng ký khi họ sắp hủy một gói đăng ký tự động gia hạn. Tài liệu của Apple liệt kê bốn loại lời nhắn:

• Lời nhắn văn bản, có thể có các gạch đầu dòng.
• Lời nhắn văn bản kèm hình ảnh.
• Lời nhắn đổi gói, gợi ý một gói đăng ký khác trong cùng nhóm đăng ký.
• Lời nhắn ưu đãi khuyến mãi, đưa ra mức giá giảm ở cùng cấp hoặc cấp khác, dùng một ưu đãi khuyến mãi bạn thiết lập trong App Store Connect và ký trên server của bạn.

Lời nhắn xuất hiện sau khi khách hàng chạm Cancel Subscription trên trang chi tiết gói đăng ký. Sau đó Apple hiển thị trang Confirm Cancellation. Khách hàng vẫn có thể hủy, chạm Keep Subscription, hoặc nhận ưu đãi hay gói mà bạn gợi ý. Bạn không thể giấu lối ra, và Apple yêu cầu nhà phát triển không tải lên nội dung gây hiểu lầm hoặc không chính xác.

Lời nhắn mặc định và luồng thời gian thực

Có hai cách vận hành. Cách đơn giản là lời nhắn mặc định: văn bản, có hoặc không có hình ảnh hay gạch đầu dòng, gán cho từng sản phẩm và từng ngôn ngữ. Cách phong phú hơn là luồng thời gian thực, trong đó Apple gọi endpoint Get Retention Message trên server của bạn và bạn trả lời bằng một ID lời nhắn. Chỉ luồng thời gian thực mới hiển thị được lời nhắn đổi gói và ưu đãi khuyến mãi.

Trên thực tế, lời nhắn mặc định không phải là tùy chọn. Apple dùng chúng làm phương án dự phòng mỗi khi lệnh gọi thời gian thực thất bại, và hoàn toàn không hiển thị lời nhắn giữ chân nào cho một sản phẩm ở bất kỳ ngôn ngữ nào thiếu lời nhắn mặc định.

Apple cho server của bạn biết gì trong lệnh gọi thời gian thực

Yêu cầu là một JWS do App Store ký. Khi giải mã, nó chứa originalTransactionId, appAppleId, productId, userLocale, một requestIdentifier dạng UUID, environment và signedDate. Apple yêu cầu bạn kiểm tra appAppleId có khớp với ứng dụng của bạn hay không và không trả lời nếu không khớp. Phần hữu ích là originalTransactionId, vì nó cho phép bạn tra cứu người đăng ký này thực sự đã làm gì trong ứng dụng trước khi chọn điều cần nói.

Lời nhắn giữ chân xuất hiện ở đâu, và không xuất hiện ở đâu

Apple đặt lời nhắn trên một màn hình duy nhất, bước Confirm Cancellation sau khi khách hàng chạm Cancel Subscription, chẳng hạn từ Apple Account > Subscriptions hoặc từ trang của một gói đăng ký trên App Store. Màn hình đó quyết định lần gia hạn tiếp theo có diễn ra hay không. Nó không đụng đến số tiền đã thu.

Yêu cầu hoàn tiền là một hành động riêng. Trang hỗ trợ của Apple đưa khách hàng đến reportaproblem.apple.com, nơi họ chọn "Request a refund" (Yêu cầu hoàn tiền), chọn lý do và mục cần hoàn, rồi chờ 24 đến 48 giờ để có cập nhật. Trong ứng dụng của bạn, beginRefundRequest của StoreKit mở bảng hoàn tiền của Apple, và Apple cho biết App Store cần tối đa 48 giờ để chấp thuận hoặc từ chối. Không con đường nào đi qua màn hình Confirm Cancellation.

Lời nhắn giữ chân có ngăn được yêu cầu hoàn tiền không?

Không. Yêu cầu hoàn tiền không bao giờ đến màn hình nơi lời nhắn nằm. Có một chi tiết trong tài liệu thông báo của Apple làm rõ điều này. Khi khách hàng yêu cầu hoàn tiền qua ứng dụng của bạn bằng API yêu cầu hoàn tiền, Apple tự tắt tự động gia hạn và gửi DID_CHANGE_RENEWAL_STATUS với subtype AUTO_RENEW_DISABLED. Một khách hàng hủy từ trang cài đặt Subscriptions cũng tạo ra đúng type và subtype đó. Server của bạn thấy một thông báo cho hai khách hàng rất khác nhau, và chỉ một trong hai người đã thấy lời nhắn giữ chân của bạn.

Nếu yêu cầu hoàn tiền tiếp tục, kênh bằng chứng là CONSUMPTION_REQUEST. Apple gửi nó cho yêu cầu hoàn tiền ở mọi loại sản phẩm, và bạn có 12 giờ để trả lời bằng Send Consumption Information. Bạn chỉ được trả lời nếu khách hàng đã đồng ý. Sau đó, quyết định của Apple đến dưới dạng thông báo REFUND, hoặc REFUND_DECLINED nếu Apple từ chối một khoản hoàn tiền mà khách hàng bắt đầu trong ứng dụng của bạn.

Google Play có API lời nhắn khi hủy không?

Không có trong tài liệu vòng đời gói đăng ký của Google. Người đăng ký Google Play hủy từ trung tâm gói đăng ký của Play, vẫn giữ quyền truy cập đến hết chu kỳ thanh toán hiện tại, và có thể chạm Resubscribe để hoàn tác trước thời điểm đó, điều Google gọi là khôi phục (restore). Bạn chỉ biết chuyện này sau đó qua thông báo SUBSCRIPTION_CANCELED, và trường userInitiatedCancellation trong resource gói đăng ký cho biết lý do người dùng rời đi. Tạm dừng (pause), mà Google cho biết được bật mặc định cho mọi gói đăng ký, là cách tích hợp sẵn chính của Google để giảm tỷ lệ rời bỏ tự nguyện.

Về phía hoàn tiền, Google Play có kênh bằng chứng riêng. PendingRefundReviewNotification đến khi một chargeback cần nhà phát triển xem xét, và bạn có 24 giờ để trả lời qua orders.reviewrefund. Với các đơn hàng đặt sau ngày 3 tháng 8 năm 2026, khi chargeback thành công, Google chuyển sang nhà phát triển khoản giá mua, trừ phí dịch vụ của Play, cộng với phí chargeback của ngân hàng.

Màn hình hủy khiến bạn tốn bao nhiêu tiền

Lời nhắn giữ chân trông có vẻ miễn phí. Thực ra không, và hóa đơn đến từ ba chỗ.

Chi phí tính toán cho mỗi lượt xem trang

Apple gọi endpoint của bạn khi một người đăng ký đang hoạt động xem trang chi tiết gói đăng ký có nút Cancel, không chỉ khi họ hủy. Mỗi lượt truy cập là một yêu cầu mà server của bạn phải xác thực, tra cứu và trả lời trong 700 ms, nếu không Apple sẽ dùng lời nhắn mặc định. Điều đó loại bỏ các hàm cold start đôi khi mất hai giây. Bạn trả tiền cho năng lực xử lý luôn sẵn sàng, cộng với các lần đọc cơ sở dữ liệu và lệnh gọi API bên thứ ba trả phí mà logic quyết định của bạn thực hiện cho mỗi yêu cầu.

Khoản giảm giá là doanh thu bạn chọn không thu

Một ưu đãi khuyến mãi giữ được người đăng ký là tiền thật được giữ lại. Một ưu đãi đến tay người vốn dĩ vẫn sẽ ở lại chỉ là giảm giá thuần túy. Đây là một ví dụ minh họa, không phải số liệu chuẩn. Gói tháng $9.99 được giảm nửa giá trong ba tháng sẽ mất $14.99 cho mỗi ưu đãi được chấp nhận. Nếu cứ ba người chấp nhận thì có một người vẫn sẽ ở lại với giá đầy đủ, một nghìn lượt chấp nhận tốn khoảng $5,000 tiền giảm giá trao cho những người chưa bao giờ cần nó. Phía bên kia của sổ sách là những người đăng ký thật sự đang định rời đi.

Khoản hoàn tiền mà một lối ra khó chịu kéo theo

Apple luôn giữ nút Cancel Subscription trên trang, nên bạn không thể giữ chân ai bằng cách gài bẫy, nhưng bạn vẫn có thể gây phiền. Một khách hàng cảm thấy bị ép còn một lựa chọn khác, đó là yêu cầu Apple trả lại khoản phí gần nhất. Khi hoàn tiền thực sự xảy ra, tiền quay về, còn chi phí tính toán, lưu trữ, lệnh gọi API và mọi khoản hoa hồng affiliate gắn với người đăng ký đó vẫn đã tiêu. Đó là những chi phí mà không lời nhắn giữ chân nào thu hồi được.

Cách dùng lời nhắn giữ chân mà không làm tăng tỷ lệ hoàn tiền

Hãy coi màn hình hủy là nơi để chính xác, không phải để khéo léo. Vài quy tắc sau giúp bạn đứng đúng phía của ranh giới hoàn tiền:

• Quyết định theo từng người đăng ký. Dùng originalTransactionId trong yêu cầu của Apple để tra cứu mức sử dụng gần đây. Đưa giảm giá hoặc gói rẻ hơn cho người có dùng sản phẩm. Gửi lời nhắn ngắn và trung thực cho người đã nhiều tuần không mở ứng dụng.
• Giữ câu trả lời nhanh. Tính trước quyết định mỗi khi dữ liệu sử dụng thay đổi, để bản thân yêu cầu chỉ là một lần tra cứu, nằm gọn trong 700 ms.
• Viết lời nhắn mặc định cho mọi sản phẩm và mọi ngôn ngữ. Nếu thiếu, một lệnh gọi thất bại đồng nghĩa với không có lời nhắn nào.
• Theo dõi sát AUTO_RENEW_DISABLED. Nếu một CONSUMPTION_REQUEST theo sau cho cùng originalTransactionId, bạn đang nhìn thấy một yêu cầu hoàn tiền, không phải một lần hủy, và đồng hồ 12 giờ đã bắt đầu chạy.
• Trả lời mọi CONSUMPTION_REQUEST mà bạn được phép trả lời. RefundHalt gửi cho Apple dữ liệu tiêu dùng chính xác trong khung 12 giờ và trả lời yêu cầu xem xét chargeback của Google Play trong vòng 24 giờ, vì đó là hai thời điểm duy nhất mà mỗi cửa hàng hỏi đến phía bạn.

Có đáng xin Apple quyền truy cập không?

Nếu bạn bán gói đăng ký tự động gia hạn và đã xử lý App Store Server Notifications V2, câu trả lời có lẽ là có. Màn hình hủy là nơi cuối cùng bạn có thể tiếp cận một người đăng ký trước khi họ đi, và một lần đổi gói tốn ít hơn so với mất hẳn họ. Chỉ cần dự trù ngân sách cho một endpoint trả lời ở mọi lượt xem trang gói đăng ký, và đặt hàng phòng thủ hoàn tiền của bạn ở nơi hoàn tiền thực sự diễn ra.