Hoàn tiền App Store: nhà phát triển thấy gì

Trên App Store, Apple là bên chấp nhận hay từ chối hoàn tiền, không bao giờ là nhà phát triển. Khách hàng gửi yêu cầu trên trang của Apple hoặc ngay trong app của bạn. Nếu bạn đã kết nối thông báo máy chủ của Apple, bạn nhận thông báo CONSUMPTION_REQUEST lúc khách gửi yêu cầu, rồi REFUND hoặc REFUND_DECLINED khi có quyết định. Ở giữa, bạn có 12 giờ để gửi dữ liệu sử dụng và mong muốn của mình, với điều kiện khách hàng đã đồng ý.

Một lần hoàn tiền được chấp nhận sẽ gỡ giao dịch mua khỏi quyền truy cập đang hoạt động của khách và hiện số âm trong báo cáo doanh số của bạn. Bài này đi qua từng bước, những gì bạn có thể gửi cho Apple, và những gì bạn được phép làm trước các yêu cầu lạm dụng. Các quy tắc lấy từ trang của Apple, đọc lại ngày 3 tháng 11 năm 2026. Trường hợp thực tế đến từ một cảnh báo mình gắn vào các app của mình hồi tháng 10.

Ai quyết định hoàn tiền trên App Store?

Apple, và chỉ Apple. Trang hỗ trợ của Apple mô tả hành trình của khách: đăng nhập reportaproblem.apple.com, chọn "Request a refund", nêu lý do, rồi chọn giao dịch liên quan. Apple khuyên khách chờ 24 đến 48 giờ để có phản hồi.

Khách cũng có thể yêu cầu hoàn tiền ngay trong app của bạn. StoreKit cung cấp một bảng yêu cầu cho việc này, có từ iOS 15. Apple khuyên gọi nó từ phần cài đặt tài khoản hoặc menu trợ giúp. Bảng này hiển thị giao dịch và danh sách lý do, và Apple mất tối đa 48 giờ để quyết định.

Trong cả hai trường hợp, bạn không phải duyệt gì cả. Bạn chỉ có thể cung cấp thông tin và một mong muốn, là một trong nhiều tiêu chí Apple dùng để quyết định.

Mỗi bên thấy gì, từng bước một

Bước	Phía khách hàng	Phía nhà phát triển
Yêu cầu	Biểu mẫu của Apple hoặc bảng trong app	Thông báo CONSUMPTION_REQUEST
Trong vòng 12 giờ	Chờ	Có thể gửi dữ liệu sử dụng
Trong vòng 48 giờ	Apple phản hồi	Thông báo REFUND hoặc REFUND_DECLINED
Sau khi chấp nhận	Tiền trả về phương thức thanh toán	Giao dịch bị gỡ khỏi quyền truy cập, số lượng âm
Sau khi khiếu nại	Apple hủy lần hoàn tiền	Thông báo REFUND_REVERSED, cần khôi phục truy cập

App Store Connect chỉ cho bạn thấy các lần hoàn tiền đã được chấp nhận, trong Sales and Trends. Bản thân yêu cầu chỉ đến qua thông báo máy chủ. Không có chúng, bạn chỉ biết chuyện hoàn tiền sau khi nó đã xảy ra.

Các thông báo máy chủ khi hoàn tiền

App Store Server Notifications V2 gửi năm loại hữu ích ở đây. Bạn nhận chúng trên địa chỉ HTTPS khai báo trong App Store Connect, một cho production và một cho sandbox.

Thông báo	Ý nghĩa	Việc bạn làm
CONSUMPTION_REQUEST	Khách yêu cầu hoàn tiền	Phản hồi trong 12 giờ, nếu có sự đồng ý
REFUND	Apple đã hoàn tiền giao dịch	Gỡ nội dung hoặc quyền truy cập đã hoàn tiền
REFUND_DECLINED	Apple đã từ chối yêu cầu	Không làm gì, quyền truy cập giữ nguyên
REFUND_REVERSED	Apple hủy lần hoàn tiền sau khi khách khiếu nại	Khôi phục những gì bạn đã gỡ
REVOKE	Một giao dịch chia sẻ qua Family Sharing không còn khả dụng	Gỡ quyền truy cập của thành viên gia đình

Máy chủ của bạn phải phản hồi bằng mã HTTP từ 200 đến 206. Theo trang về phản hồi thông báo, nếu không, Apple thử lại năm lần, sau 1, 12, 24, 48 rồi 72 giờ kể từ lần thử trước. Trong sandbox, Apple chỉ gửi một lần.

Consumption API: những gì bạn có thể nói với Apple

Khi yêu cầu đến, bạn có thể phản hồi bằng Send Consumption Information. Quy tắc gói trong một câu của Apple: "Respond within 12 hours of receiving the CONSUMPTION_REQUEST notification." Phiên bản 2 của API áp dụng cho mọi loại sản phẩm, kể cả gói đăng ký.

Các trường của request:

Trường	Bắt buộc	Điều nó nói với Apple
customerConsented	Có	Khách đã đồng ý chia sẻ dữ liệu
deliveryStatus	Có	Giao dịch đã được giao và hoạt động, hoặc lý do chưa được giao
sampleContentProvided	Có	Có bản dùng thử, trích đoạn hoặc mô tả trước khi mua
consumptionPercentage	Không	Phần đã sử dụng, từ 0 đến 100 000 tương ứng 0 đến 100 %
refundPreference	Không	Mong muốn của bạn: DECLINE, GRANT_FULL hoặc GRANT_PRORATED

Hai điểm quan trọng. Nếu deliveryStatus không phải DELIVERED, phần đã sử dụng phải bằng 0. Và với hoàn tiền theo tỷ lệ cho gói đăng ký, bạn bỏ trống phần đã sử dụng: Apple tự tính.

Sự đồng ý là điều kiện của mọi thứ. Apple viết: "You must obtain valid consent from the customer before sharing their personal data with Apple in the Send Consumption Information API." Không có sự đồng ý, bạn không phản hồi. Apple cũng cấm dùng cửa sổ theo dõi quảng cáo để xin sự đồng ý này: "Don't use the AppTrackingTransparency prompt to obtain consent".

Nếu bạn dùng RevenueCat

Với RevenueCat, chính RevenueCat nhận thông báo của Apple và phản hồi yêu cầu, bằng Refund Control. Bạn chọn một trong bốn chính sách: ưu tiên hoàn tiền toàn phần, ưu tiên từ chối, chỉ gửi dữ liệu sử dụng, hoặc không phản hồi.

Bật chia sẻ dữ liệu đồng nghĩa với việc xác nhận bạn đã có sự đồng ý của khách hàng. RevenueCat tự nói rõ: "Enabling consumption data sharing confirms that you obtained consent from your Customers." Họ cũng khuyên chỉ dùng "Prefer no refund" cho một nhóm cụ thể, và cảnh báo khi mong muốn này áp dụng cho phần lớn khách hàng của bạn.

Để nhận thông báo cả trên máy chủ riêng, RevenueCat có trường "Apple Server Notification Forwarding URL" trong phần cài đặt app. Nó được mô tả trong trang về thông báo của Apple của họ. Đây là cách mình đang dùng. Cách dựng gói đăng ký với RevenueCat có trong RevenueCat và gói đăng ký in-app iOS.

Ảnh hưởng đến doanh thu và gói đăng ký

Về quyền truy cập. Theo tài liệu về currentEntitlements, "Products that the App Store has refunded or revoked don't appear in the current entitlements". Nếu app của bạn kiểm tra quyền bằng currentEntitlements, quyền truy cập đã hoàn tiền tự biến mất. Giao dịch mang ngày và lý do bị thu hồi, trong revocationDate và revocationReason.

Về báo cáo. Theo trợ giúp báo cáo doanh số, một lần hoàn tiền hiện với số lượng và giá khách trả là số âm. Với gói đăng ký, trang về dữ liệu đăng ký tính hoàn tiền toàn phần và một phần vào các sự kiện, và trừ chúng khỏi số lượng hằng ngày.

Về uy tín. Guideline 5.6.4 liệt kê yêu cầu hoàn tiền quá nhiều là một dấu hiệu chất lượng kém. Tỷ lệ hoàn tiền cao không chỉ là mất tiền: Apple có thể dựa vào đó để đánh giá việc bạn tuân thủ quy tắc ứng xử.

Trường hợp của mình: cảnh báo gắn vào các app

Ngày 12 tháng 10 năm 2026, mình gắn một cảnh báo vào các app của mình. RevenueCat chuyển tiếp thông báo của Apple đến một route trên devoria.fr. Route này kiểm tra chữ ký của Apple, rồi gửi cho mình một cảnh báo, không kèm số tiền. Mình muốn thấy yêu cầu ngay lúc nó đến, chứ không chỉ kết quả.

Ngày 18 tháng 10, yêu cầu thật đầu tiên đến từ TradaZen, app mô phỏng giao dịch của mình. Một gói đăng ký năm, thanh toán khi hết 7 ngày dùng thử miễn phí. Lý do được nêu: mua nhầm. Ba bài học:

1. Cùng một yêu cầu có thể đến nhiều lần. Mình nhận cùng một cảnh báo ba lần trong cùng tối. Từ đó, mỗi cảnh báo được lọc trùng theo loại thông báo và mã giao dịch.
2. Quyết định đến trong chưa tới một ngày. Apple từ chối khoảng 22 giờ sau khi có yêu cầu. Khách vẫn giữ quyền truy cập.
3. Bị từ chối chưa phải là hết. Cùng khách đó gửi lại yêu cầu hai ngày sau, trên cùng giao dịch.

Một yêu cầu "mua nhầm" khi hết thời gian dùng thử không thắng được bằng câu trả lời gửi Apple. Nó phải được phòng ngừa trên paywall, trước lần thanh toán đầu tiên.

Hạn chế yêu cầu lạm dụng mà không vi phạm quy tắc

Những gì được phép:

• Phản hồi mỗi yêu cầu bằng dữ liệu chính xác, khi khách đã đồng ý.
• Nêu mong muốn có chọn lọc, ví dụ từ chối cho một giao dịch đã sử dụng hết, thay vì từ chối với tất cả mọi người.
• Gắn mỗi REFUND với một tài khoản khách hàng. Trang của Apple về thông báo hoàn tiền khuyến nghị việc này để phát hiện hoàn tiền lặp lại.
• Nói rõ khách mua gì trước khi mua. Guideline 3.1.2(c) yêu cầu mô tả người dùng nhận được gì với mức giá đó, trước khi mời họ đăng ký.

Những gì bị cấm:

• Gửi dữ liệu sai để yêu cầu bị từ chối, hoặc phản hồi khi chưa có sự đồng ý.
• Xin sự đồng ý qua cửa sổ theo dõi quảng cáo, điều Apple loại trừ rõ ràng.
• Gài bẫy khi mua. Guideline 5.6 cấm đẩy khách vào những giao dịch họ không muốn hoặc thu tiền cho thứ không được giao.
• Gây áp lực lên khách đang yêu cầu hoàn tiền. Cùng quy tắc đó đòi hỏi sự tôn trọng trong chăm sóc khách hàng, không đe dọa.

Đòn bẩy tốt nhất vẫn nằm ở phía trước: một paywall nêu rõ giá, ngày thanh toán đầu tiên và cách hủy. Các lỗi cần tránh có trong các lỗi paywall, và quy tắc dùng thử có trong dùng thử miễn phí trên App Store.

Kiểm thử trước khi lên production

Theo trang về kiểm thử yêu cầu hoàn tiền, sandbox và StoreKit testing trong Xcode đều chấp nhận yêu cầu hoàn tiền. Trong sandbox, lý do nào cũng dẫn đến chấp nhận tự động. Để mô phỏng từ chối, chọn "Other" và gõ DECLINE. Để hoàn tiền theo tỷ lệ, gõ GRANT_PRORATED. Trong sandbox, phản hồi dữ liệu sử dụng của bạn phải được gửi trong vòng năm phút.

Một gói đăng ký ít bị hoàn tiền hơn

iOS & Android Kit xuất phát từ code các app của mình, với onboarding, paywall và gói đăng ký đã được code sẵn, và đi qua bốn bước đến App Store, theo nhịp của bạn. Cách dựng đầy đủ có trên trang gói đăng ký in-app iOS, và quy tắc của Apple về gói đăng ký có trong guideline 3.1.2.

Trước khi ra mắt paywall, làm bài chẩn đoán miễn phí: nó cho bạn biết điều gì thật sự đang chặn dự án, và gửi bạn checklist chống bị Apple từ chối của mình.

Câu hỏi thường gặp

Nhà phát triển có thể từ chối hoàn tiền App Store không?

Không. Apple tự quyết. Bạn có thể gửi dữ liệu sử dụng và một mong muốn, ví dụ DECLINE, là một trong nhiều tiêu chí. Apple có tiếng nói cuối cùng.

Nhà phát triển có được báo khi có yêu cầu hoàn tiền không?

Có, nếu đã kết nối App Store Server Notifications V2. Apple gửi CONSUMPTION_REQUEST lúc có yêu cầu, rồi REFUND hoặc REFUND_DECLINED khi có quyết định. Không có thông báo, bạn chỉ thấy các lần hoàn tiền đã chấp nhận trong báo cáo.

Apple mất bao lâu để xử lý yêu cầu hoàn tiền?

Apple báo khách là 24 đến 48 giờ. Tài liệu StoreKit nói tối đa 48 giờ. Về phía bạn, bạn có 12 giờ để gửi dữ liệu sử dụng.

Quyền truy cập ra sao sau khi hoàn tiền?

Giao dịch đã hoàn tiền bị gỡ khỏi quyền truy cập đang hoạt động: StoreKit 2 không còn trả nó trong currentEntitlements. Nếu sau đó Apple hủy lần hoàn tiền, bạn nhận REFUND_REVERSED và phải khôi phục quyền truy cập.

Có cần sự đồng ý của khách để phản hồi Apple không?

Có. Apple yêu cầu sự đồng ý hợp lệ trước mọi việc chia sẻ dữ liệu qua Consumption API. Không có nó, bạn không phản hồi thông báo. Không được dùng cửa sổ theo dõi quảng cáo để xin sự đồng ý này.

Hoàn tiền có ảnh hưởng xấu đến app của mình không?

Có thể. Guideline 5.6.4 liệt kê yêu cầu hoàn tiền quá nhiều là dấu hiệu chất lượng kém, điều Apple có thể dựa vào để đánh giá việc tuân thủ quy tắc ứng xử.