Tất cả bài viết
Cẩm nangĐọc trong 8 phút

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.

Một chiếc điện thoại trên bàn gỗ với ô nhập mã còn trống bên cạnh tấm thẻ khuyến mãi in sẵn, khoảnh khắc đổi mã phía sau offer code cho in-app purchase

Đ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ượngHết hạnNơi khách hàng đổi mã
Mã dùng một lần500 đế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ángURL đổ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úcURL đổi mã hoặc trong ứng dụng của bạn
Mã sandbox10 đến 10.000 mỗi lôKhông bắt buộc, tối đa 6 thángCà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ịchGiá trị trên giao dịch mua bằng offer codeVì sao quan trọng với hoàn tiền
offerType3Đánh dấu giao dịch là lượt đổi offer code
offerIdentifierMã định danh của ưu đãi trong App Store ConnectCho bạn biết khoản hoàn tiền thuộc chiến dịch nào
offerDiscountTypeONE_TIME cho consumable, non-consumable và gói đăng ký không tự gia hạnTách mã sản phẩm mua một lần khỏi ưu đãi gói đăng ký
priceGiá đã giảm, tính bằng milliunitCho 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ùngKhôngKhông
Tính toán và băng thông để cung cấp nội dungKhôngKhông
Lưu trữ cho các tệp khách hàng đã tạo hoặc tải xuốngKhôngKhông
Payout cho nhà sáng tạo, affiliate hoặc đối tácTùy điều khoản của bạnChỉ 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.

Bàn làm việc của nhà phát triển vào ban đêm với laptop hiển thị mức sử dụng tăng dần bên cạnh xấp thẻ quà tặng trống, chi phí cung cấp mà offer code cho in-app purchase có thể để lại sau khi hoàn tiền

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

RefundHalt

Chế độ tự động xử lý hoàn tiền cho App Store và Google Play

Đọc tiếp

Yêu cầu hoàn tiền tiếp theo đã đang trên đường đến.

Thiết lập RefundHalt trong khoảng thời gian bạn cần để đọc thêm một email hỗ trợ về khoản hoàn tiền mà mình chưa kịp phản biện.