Offer code cho in-app purchase đã thay thế promo code của Apple, và mọi lượt đổi mã có trả phí vẫn có thể quay lại thành yêu cầu hoàn tiền
Offer code của Apple giờ đã áp dụng cho consumable, non-consumable và gói đăng ký không tự gia hạn, với giá miễn phí hoặc giảm giá. Bài viết giải thích cách một giao dịch offer code bị hoàn tiền đến server của bạn, chi phí bạn phải gánh về tính toán và payout, và những thiết lập giúp chiến dịch mã không biến thành lỗ hổng hoàn tiền.

Điểm chính
- Từ March 26, 2026, nhà phát triển không thể tạo promo code cho In-App Purchase trong App Store Connect nữa. Offer code của Apple thay thế chúng và hỗ trợ consumable, non-consumable, gói đăng ký không tự gia hạn và gói đăng ký tự động gia hạn.
- Một offer code của Apple có thể là Free Offer hoặc Paid Offer với giá đã giảm. Lượt đổi mã có trả phí là một giao dịch mua thật, nên khách hàng có thể yêu cầu Apple hoàn tiền như mọi giao dịch khác.
- Khi khách hàng đổi offer code cho consumable, non-consumable hoặc gói đăng ký không tự gia hạn, App Store Server Notifications V2 gửi ONE_TIME_CHARGE. Giao dịch đã ký mang offerType 3 và offerDiscountType ONE_TIME.
- Apple gửi CONSUMPTION_REQUEST khi khách hàng yêu cầu hoàn tiền cho bất kỳ loại sản phẩm nào, kể cả giao dịch mua bằng offer code. Nhà phát triển có 12 giờ để phản hồi qua Send Consumption Information, và chỉ khi khách hàng đồng ý.
- App Store Connect cho phép tối đa 10 offer code đang hoạt động mỗi ứng dụng, cùng tối đa 1 triệu mã dùng một lần và 1 triệu mã tùy chỉnh mỗi ứng dụng, mỗi quý, dùng chung cho tất cả In-App Purchase.
- Điều kiện đủ tư cách và giá của offer code không thể chỉnh sửa sau khi tạo ưu đãi. Mỗi khách hàng đổi được một mã cho mỗi ưu đãi, và việc vô hiệu hóa ưu đãi làm mã hết hạn ngay lập tức mà không ảnh hưởng các lượt đổi trước đó.
- Promo code của Google Play tặng miễn phí sản phẩm mua một lần, nên không tạo ra khoản thu nào để hoàn tiền. Google cho phép tối đa 500 promo code không phải gói đăng ký mỗi ứng dụng, mỗi quý.
Từ March 26, 2026, bạn không thể tạo promo code cho In-App Purchase trong App Store Connect nữa. Offer code của Apple cho in-app purchase đã thay thế chúng, và chúng làm được một việc mà mã cũ không làm được: thu tiền. Một Paid Offer bán consumable, non-consumable hoặc gói đăng ký không tự gia hạn với giá giảm. Điều đó biến mọi lượt đổi mã có trả phí thành một giao dịch mua mà khách hàng có thể yêu cầu Apple hoàn tiền, sau khi server, lệnh gọi model và payout của bạn đã chạy với chi phí đầy đủ.
Offer code cho in-app purchase hiện hoạt động như thế nào
Apple công bố thay đổi này vào October 29, 2025. Trước đây offer code là công cụ dành cho gói đăng ký. Giờ chúng còn áp dụng cho consumable, non-consumable và gói đăng ký không tự gia hạn, bên cạnh gói đăng ký tự động gia hạn. Tài liệu StoreKit của Apple mô tả chúng là các mã chữ và số cung cấp In-App Purchase với giá giảm hoặc miễn phí, trong một khoảng thời gian cụ thể. Promo code IAP hiện có vẫn đổi được cho đến khi hết hạn, và promo code cho lượt tải ứng dụng miễn phí vẫn tồn tại.
Khi tạo một ưu đãi, bạn chọn Free Offer hoặc Paid Offer. Với ưu đãi trả phí, bạn đặt giá đã giảm cho một quốc gia hoặc khu vực gốc, và App Store Connect tự điền giá tương đương cho cả 175 storefront. Bạn cũng chọn ai đủ điều kiện, từ ba lựa chọn: chưa từng mua trong ứng dụng của bạn, đã mua trong ứng dụng của bạn trong 30 ngày qua, hoặc đã mua cách đây hơn 30 ngày. Chọn cả ba sẽ mở ưu đãi cho tất cả mọi người.
Ba loại mã
| Loại mã | Số lượng | Hết hạn | Nơi khách hàng đổi mã |
|---|---|---|---|
| Mã dùng một lần | 500 đến 25.000 mỗi lô, tối đa 1 triệu mỗi ứng dụng mỗi quý | Bắt buộc, tối đa 6 tháng | URL đổi mã, App Store, hoặc trong ứng dụng của bạn |
| Mã tùy chỉnh (từ do bạn đặt, như SUMMER25) | Tối đa 25.000 lượt đổi cùng lúc, tối đa 1 triệu mỗi ứng dụng mỗi quý | Không bắt buộc, tối đa 6 tháng, hoặc không có ngày kết thúc | URL đổi mã hoặc trong ứng dụng của bạn |
| Mã sandbox | 10 đến 10.000 mỗi lô | Không bắt buộc, tối đa 6 tháng | Cài đặt tài khoản sandbox trên thiết bị |
Mỗi ứng dụng có thể chạy tối đa 10 ưu đãi đang hoạt động cùng lúc, và mỗi khách hàng đổi được một mã cho mỗi ưu đãi. Đổi mã trong ứng dụng cho sản phẩm mua một lần cần iOS 16.3, macOS 15.0 hoặc visionOS 1.0 trở lên.
Giao dịch offer code bị hoàn tiền trông như thế nào trên server của bạn
Việc đổi mã thường diễn ra bên ngoài ứng dụng của bạn. Khách hàng có thể nhập mã dùng một lần vào App Store hoặc mở URL đổi mã, và Apple sẽ nhắc họ tải ứng dụng nếu chưa có. Server của bạn biết chuyện này trước cả ứng dụng.
Với consumable, non-consumable hoặc gói đăng ký không tự gia hạn, App Store Server Notifications V2 gửi ONE_TIME_CHARGE. Với gói đăng ký tự động gia hạn, nó gửi SUBSCRIBED cho lượt mua mới hoặc đăng ký lại, và OFFER_REDEEMED cho người đăng ký đang hoạt động. Giao dịch đã ký cho bạn biết giao dịch đến từ một mã.
| Trường giao dịch | Giá trị trên giao dịch mua bằng offer code | Vì sao quan trọng với hoàn tiền |
|---|---|---|
| offerType | 3 | Đánh dấu giao dịch là lượt đổi offer code |
| offerIdentifier | Mã định danh của ưu đãi trong App Store Connect | Cho bạn biết khoản hoàn tiền thuộc chiến dịch nào |
| offerDiscountType | ONE_TIME cho consumable, non-consumable và gói đăng ký không tự gia hạn | Tách mã sản phẩm mua một lần khỏi ưu đãi gói đăng ký |
| price | Giá đã giảm, tính bằng milliunit | Cho thấy khách hàng thực sự đã trả bao nhiêu, và do đó khoản hoàn tiền trả lại bao nhiêu |
Nếu bạn vẫn đọc app receipt cũ, lưu ý rằng trường cũ offer_code_ref_name của Apple không được điền cho consumable, non-consumable và gói đăng ký không tự gia hạn. Giao dịch đã ký là nơi các lượt đổi mã này hiển thị.
Bản thân yêu cầu hoàn tiền
Luồng hoàn tiền không thay đổi chỉ vì có mã. Tài liệu Send Consumption Information của Apple cho biết App Store gửi CONSUMPTION_REQUEST khi khách hàng yêu cầu hoàn tiền cho bất kỳ loại sản phẩm nào. Nếu khách hàng đồng ý, bạn có 12 giờ để phản hồi với customerConsented, deliveryStatus, consumptionPercentage, refundPreference và sampleContentProvided. Nếu họ không đồng ý, Apple yêu cầu không phản hồi. Thông báo REFUND sẽ đến sau nếu Apple chấp thuận.
Hoàn tiền offer code khiến bạn tốn bao nhiêu
Phần tiền hoàn lại thì nhỏ, vì khách hàng đã trả giá giảm. Chi phí cung cấp dịch vụ của bạn không giảm theo giá. Một mã bán 1.000 tín dụng AI với mức giảm sâu vẫn kích hoạt lượng lệnh gọi model tương đương 1.000 tín dụng, tính theo mức giá bình thường của nhà cung cấp. Một non-consumable được mở khóa bằng mã vẫn tiêu tốn dung lượng lưu trữ và băng thông như khi mua với giá niêm yết.
| Yếu tố chi phí | Giảm theo giá đã giảm? | Thu hồi được sau khi hoàn tiền? |
|---|---|---|
| Lệnh gọi model và API phía sau tín dụng đã dùng | Không | Không |
| Tính toán và băng thông để cung cấp nội dung | Không | Không |
| Lưu trữ cho các tệp khách hàng đã tạo hoặc tải xuống | Không | Không |
| Payout cho nhà sáng tạo, affiliate hoặc đối tác | Tùy điều khoản của bạn | Chỉ khi điều khoản của bạn cho phép thu hồi |
| Khoản thanh toán đã giảm giá | Có | Trả lại cho khách hàng |
Đây là một ví dụ giả định để thấy rõ khoảng chênh. Giả sử một gói tín dụng có giá niêm yết $9.99 và mã của bạn bán nó với giá $1.99. Khách hàng đổi mã, dùng hết tín dụng rồi được hoàn tiền chỉ lấy lại $1.99. Nhà cung cấp model vẫn tính tiền toàn bộ mức sử dụng. Nếu mã bị đăng lên một diễn đàn săn ưu đãi, chi phí thật của chiến dịch là hóa đơn sử dụng của bạn, chứ không phải mức giảm giá bạn đã lên kế hoạch.

Cách giữ chiến dịch mã không biến thành lỗ hổng hoàn tiền
Mọi biện pháp dưới đây đều có tác dụng trước khi tiền được chuyển, nên rẻ hơn bất kỳ tranh chấp nào về sau.
Chọn điều kiện đủ tư cách có chủ đích
Đánh dấu cả ba ô điều kiện là cám dỗ mặc định. Với mã trả phí cho một consumable đắt tiền, hãy cân nhắc chỉ dành cho người đã từng mua, vì bạn đã có lịch sử của họ. Tài liệu của Apple không nói rõ giao dịch bị hoàn tiền có được tính là giao dịch mua khi xét điều kiện hay không, nên đừng xem đây là bộ lọc hoàn tiền độc lập.
Ưu tiên mã dùng một lần cho mọi thứ tốn kém
Mã tùy chỉnh là một từ ai cũng có thể chia sẻ, dùng được tới 25.000 lượt đổi cùng lúc. Mã dùng một lần là ngẫu nhiên và mỗi mã chỉ dùng được một lần. Nếu rò rỉ sẽ gây thiệt hại, hãy dùng mã dùng một lần và phát riêng cho từng người.
Vô hiệu hóa mã bị rò rỉ thật nhanh
Vô hiệu hóa một ưu đãi làm các mã của nó hết hạn ngay lập tức. Khách hàng đã đổi mã vẫn giữ những gì họ nhận được, và mã chưa đổi không được trả lại vào hạn mức hằng quý của bạn. Theo dõi số lượt đổi theo từng offerIdentifier để phát hiện rò rỉ trong vài giờ, chứ không phải vào cuối tháng.
Gắn lượt đổi mã với một tài khoản
Giao dịch được đổi trong App Store đến mà không có appAccountToken, vì luồng mua hàng của bạn chưa từng chạy. Endpoint Set App Account Token của App Store Server API cho phép server của bạn gắn token sau đó. Nhờ vậy, một khoản hoàn tiền trên giao dịch mua bằng mã sẽ trỏ tới một người dùng thật mà bạn có thể xử lý.
Trả lời yêu cầu tiêu dùng một cách trung thực
Nếu khách hàng đã dùng tín dụng hoặc nội dung, hãy nói rõ bằng deliveryStatus và consumptionPercentage chính xác. Nếu họ chưa từng mở ứng dụng sau khi đổi mã, khoản hoàn tiền chẳng tốn của bạn bao nhiêu, còn việc phản đối sẽ làm mất uy tín. refundPreference của bạn là một dữ liệu đầu vào cho quyết định của Apple. Nó không phải quyền phủ quyết.
Promo code của Google Play không gây ra vấn đề này
Promo code của Google Play hoạt động khác. Mã cho ứng dụng trả phí và sản phẩm mua một lần tặng miễn phí món hàng, còn mã gói đăng ký cấp bản dùng thử miễn phí từ 3 đến 90 ngày. Món hàng miễn phí không có khoản thu nào để khách hàng yêu cầu hoàn tiền. Google giới hạn promo code không phải gói đăng ký ở mức 500 mỗi ứng dụng, mỗi quý, và mã chưa dùng không được chuyển sang quý sau.
Một giao dịch Google Play có giảm giá là đơn hàng trả phí thông thường, và tuân theo các quy tắc thông thường. Google tự quyết định các yêu cầu hoàn tiền tự phục vụ trong 48 giờ đầu mà không hỏi bạn. Luồng duy nhất yêu cầu bạn cung cấp bằng chứng là xem xét chargeback qua orders.reviewrefund, với thời hạn 24 giờ. Với các đơn hàng đặt sau August 3, 2026, Google chuyển giá mua của khoản chargeback, trừ phí dịch vụ của Play, cộng phí chargeback của ngân hàng sang cho nhà phát triển.
Câu hỏi thường gặp
- Khách hàng có được hoàn tiền cho thứ đã mua bằng offer code của Apple không?
- Có, nếu họ đã trả tiền. Lượt đổi Paid Offer là một giao dịch mua bình thường với giá giảm, nên khách hàng có thể yêu cầu Apple hoàn tiền. Apple gửi cho bạn CONSUMPTION_REQUEST, bạn có 12 giờ để phản hồi nếu khách hàng đồng ý, và thông báo REFUND sẽ đến sau nếu Apple chấp thuận. Free Offer không có khoản thanh toán nào để hoàn.
- Tôi có còn tạo được promo code cho in-app purchase không?
- Không. Từ March 26, 2026, App Store Connect không còn cho phép tạo promo code cho In-App Purchase. Mã được tạo trước thời điểm đó vẫn đổi được cho đến khi hết hạn, và promo code cho lượt tải ứng dụng miễn phí vẫn còn. Offer code là giải pháp thay thế.
- Làm sao biết một giao dịch bị hoàn tiền đến từ offer code?
- Kiểm tra offerType trong giao dịch đã ký. Giá trị 3 nghĩa là khách hàng đã đổi offer code, và offerIdentifier cho biết tên ưu đãi. Với consumable, non-consumable và gói đăng ký không tự gia hạn, offerDiscountType là ONE_TIME.
- Tôi có thể tạo bao nhiêu offer code cho in-app purchase?
- Tối đa 1 triệu mã dùng một lần và tối đa 1 triệu mã tùy chỉnh mỗi ứng dụng, mỗi quý, dùng chung cho tất cả In-App Purchase. Mỗi ứng dụng có thể có tối đa 10 ưu đãi đang hoạt động cùng lúc, và mã dùng một lần được tạo theo lô từ 500 đến 25.000.
- Điều gì xảy ra nếu offer code bị rò rỉ trên mạng?
- Vô hiệu hóa ưu đãi trong App Store Connect. Các mã của nó hết hạn ngay lập tức, khách hàng đã đổi mã vẫn giữ những gì họ nhận được, và mã chưa đổi không được trả lại vào hạn mức hằng quý của bạn. Yêu cầu hoàn tiền cho các lượt đổi có trả phí trước đó vẫn đến dưới dạng thông báo CONSUMPTION_REQUEST bình thường.
Nguồn và tài liệu đọc thêm
- Apple Developer News: Enhancements to help you submit and market your apps and games (October 29, 2025)
- App Store Connect Help: Create offer codes for In-App Purchases
- Apple Developer: Supporting offer codes in your app
- App Store Server API: offerType and offerDiscountType
- App Store Server API: Send Consumption Information
- App Store Server API: Set App Account Token
- Google Play Console Help: Create promo codes
- Google Play Console Help: Updates to refund protection and chargeback cost responsibility
RefundHalt
Chế độ tự động xử lý hoàn tiền cho App Store và Google Play
Đọc tiếp
Brazil đang rà soát những game vẫn bán loot box cho trẻ em, và hoàn tiền loot box là nơi chi phí đổ về
Bộ Tư pháp Brazil đã đề nghị cơ quan bảo vệ dữ liệu giám sát sáu game bán loot box mà không kiểm tra độ tuổi. Bài viết này tóm tắt luật yêu cầu gì, Apple và Google vốn đã đòi hỏi gì, và cách định giá, xử lý hoàn tiền loot box khi hộp đã được mở.
Giao dịch mua trong ứng dụng ngoài ý muốn là những khoản hoàn tiền bạn không thể thắng, vì vậy cách khắc phục nằm ở màn hình mua hàng
Giao dịch mua trong ứng dụng ngoài ý muốn quay lại dưới dạng hoàn tiền trên cả hai cửa hàng, và không bằng chứng sử dụng nào chứng minh được một lần chạm là có chủ ý. Bài viết này giải thích cách Apple và Google gắn nhãn chúng, chi phí tính toán và chi trả mà mỗi trường hợp gây ra cho bạn, và thiết kế màn hình mua hàng giúp ngăn chúng trước khi khoản phí phát sinh.