App Store Brazil: thanh toán thay thế và hoa hồng Apple

Ở Brazil, từ iOS 26.5, một app trên App Store có thể bán nội dung số theo ba cách: mua trong app (in-app purchase) của Apple, một nhà cung cấp thanh toán bên thứ ba ngay trong app, hoặc một ưu đãi trên website của bạn. Apple lấy 21% hoa hồng, hoặc 10% với nhà phát triển nhỏ và với gói đăng ký sau năm đầu, cộng thêm 5% phí nếu thanh toán đi qua mua trong app. Một link về website của bạn tốn 15%, hoặc 10%, trên các giao dịch diễn ra trong 7 ngày sau cú nhấp.

Các lựa chọn này đến từ một thỏa thuận giữa Apple và CADE, cơ quan cạnh tranh của Brazil. Hai điều kiện quan trọng nhất: mua trong app vẫn phải hiển thị bên cạnh, và không người dùng nào dưới 18 tuổi được thấy ưu đãi trên website của bạn. Mọi thông tin đều lấy từ các trang chính thức của Apple và CADE, mình đọc lại ngày 27/10/2026.

Mình tự phát hành các app iOS của mình bằng Expo, bán theo gói đăng ký. Quy định chung về mua trong app nằm trong bài hướng dẫn guideline 3.1.1. Ở đây mình chỉ nói về Brazil.

Thỏa thuận giữa Apple và CADE

Ngày 23/12/2025, tòa án của Conselho Administrativo de Defesa Econômica (CADE) đã nhất trí phê chuẩn Termo de Compromisso de Cessação (TCC) do Apple đề xuất, theo thông cáo chính thức của CADE. Cuộc điều tra được mở vào tháng 12/2022, sau đơn khiếu nại của tập đoàn Mercado Livre.

Theo thông cáo này, thỏa thuận buộc Apple phải:

• cho phép nhà phát triển quảng bá ưu đãi bên ngoài, và dẫn người dùng đến mua hàng bên ngoài app;
• chấp nhận các phương thức thanh toán khác trong app;
• mở cửa phân phối qua các kho ứng dụng thay thế.

Thanh toán thay thế và ưu đãi bên ngoài phải được trình bày song song với mua trong app.

Thỏa thuận cũng có các biện pháp bảo vệ trẻ em và quy định cấu trúc hoa hồng của Apple. Nó kéo dài ba năm kể từ khi các điều khoản mới trở thành bắt buộc với nhà phát triển. Nếu vi phạm hoàn toàn, Apple có thể bị phạt tới 150 triệu real và cuộc điều tra sẽ được mở lại.

Mình chưa đọc toàn văn TCC. CADE thông báo sẽ công bố nó « em breve », và thông cáo không đưa ra mức phí nào. Vì vậy các con số trong bài này lấy từ các trang của Apple. Ngày 18/6/2026, Apple đã trình bày các thay đổi cho Brazil, có từ iOS 26.5. Apple khẳng định ở đó rằng nhà phát triển bán nội dung số tại Brazil sẽ trả cho họ « the same or less than they do today ».

Bốn cách bán hàng ở Brazil

Trang Changes to iOS in Brazil của Apple mô tả bốn con đường.

Lựa chọn	Ai thu tiền	Bạn cần
Mua trong app của Apple	Apple	Không có gì mới
Thanh toán bên thứ ba trong app	Nhà cung cấp của bạn	Entitlement
Ưu đãi trên website của bạn	Website của bạn	Entitlement
Kho ứng dụng thay thế	Bạn hoặc kho ứng dụng	Notarization

Về kỹ thuật, mua trong app không thay đổi: Apple ghi rõ bạn không cần sửa gì. Chỉ hoa hồng của nó theo biểu phí mới của Brazil. Với hai lựa chọn tiếp theo, trang về các lựa chọn thanh toán ở Brazil yêu cầu entitlement StoreKit External Purchases or Offers. Nó áp dụng cho ưu đãi trên website của bạn, dù có link bấm được hay không.

Hoa hồng của Apple ở Brazil, theo từng lựa chọn

Đây là những gì Apple công bố. Mình chép bảng này từ mã HTML của hai trang của họ, không phải từ một bản tóm tắt.

Lựa chọn	Mức tiêu chuẩn	Mức giảm
Mua trong app	21% + 5%	10% + 5%
Thanh toán bên thứ ba trong app	21%	10%
Link về website của bạn	15%	10%
Kho ứng dụng thay thế	5%	5%

Cách đọc:

• Mức giảm dành cho thành viên Small Business Program, Mini Apps Partner Program và Video Partner Program, và cho gói đăng ký sau năm đầu tiên. Với hoa hồng App Store, trang tổng quát thêm News Partner Program, chương trình này không có trên trang lựa chọn thanh toán, trong thông báo của Apple, hay trong biểu phí của link về website.
• 5% của mua trong app là phí xử lý thanh toán, tách biệt với hoa hồng.
• Link về website trả « store services commission », chỉ trên các giao dịch trong 7 ngày sau cú nhấp. Apple chỉ định nghĩa nó cho link bấm được mở trình duyệt.
• Kho ứng dụng thay thế trả Core Technology Commission (CTC): 5% doanh thu nội dung số, kể cả app trả phí, chưa gồm thuế.

Với mua trong app, Apple nói rõ hoa hồng và phí tính trên giá khách hàng trả, và hợp đồng giấy phép quy định cách tính thuế. CTC tính trên giá chưa thuế. Với nhà cung cấp bên thứ ba, phí của họ được cộng thêm.

Ví dụ: khách trả R$ 100

Phép tính này là ví dụ, không phải số đo thực tế. Mình bỏ qua thuế, và ghi « + phí » cho phí của nhà cung cấp, mà mình không ghi nhận: nó phụ thuộc vào hợp đồng của bạn. Nhà phát triển nhỏ ở đây là thành viên Small Business Program.

Lựa chọn	Nhà phát triển nhỏ	Mức tiêu chuẩn
Mua trong app	R$ 15 cho Apple	R$ 26 cho Apple
Thanh toán bên thứ ba trong app	R$ 10 + phí	R$ 21 + phí
Link về website của bạn	R$ 10 + phí	R$ 15 + phí

Với mua trong app, nhà phát triển nhỏ giữ R$ 85. Với thanh toán bên thứ ba, họ giữ R$ 90, trừ phí của nhà cung cấp.

Với thành viên Small Business Program, bỏ mua trong app giúp lợi 5 điểm phần trăm trên một giao dịch chịu hoa hồng, trước phí nhà cung cấp. Nếu nhà cung cấp của bạn lấy hơn R$ 5 trên R$ 100, mua trong app vẫn rẻ hơn. Ở mức tiêu chuẩn, chênh lệch là 5 điểm với thanh toán bên thứ ba và 11 điểm với link về website. Ngoại lệ duy nhất: trên website của bạn, giao dịch diễn ra hơn 7 ngày sau cú nhấp không phải trả hoa hồng link.

Những điểm này chưa tính phần việc bạn phải tự gánh:

• chăm sóc khách hàng: với các giao dịch này, Apple không còn xử lý hoàn tiền, lịch sử mua hàng hay gói đăng ký;
• thuế, phải tự thu và nộp;
• một báo cáo hàng tháng gửi từ server của bạn, kèm mọi token giao dịch, kể cả khi không có giao dịch nào;
• hóa đơn của Apple, phải thanh toán trong 30 ngày kể từ khi nhận. Nếu không, Apple có thể trừ số tiền vào doanh thu của bạn ở các thị trường khác, gỡ app khỏi App Store, thậm chí loại bạn khỏi chương trình nhà phát triển.

App Store cũng cảnh báo người mua: một banner trên trang app của bạn, một ghi chú trong mục Information, và dòng External Purchases khi xác nhận tải về. Mình không có số liệu nào về ảnh hưởng của chúng tới tỷ lệ chuyển đổi.

Với app đầu tiên, mình giữ mua trong app ở Brazil: tổng cộng 15% với nhà phát triển nhỏ, không cần server báo cáo hay chăm sóc khách hàng về thanh toán. Thanh toán thay thế chỉ đáng khi bạn bán đủ nhiều để vài điểm chênh lệch bù được công sức đó.

Việc chọn gói đăng ký hay mua một lần cũng thay đổi hoa hồng: chi tiết có trong bài gói đăng ký hay mua một lần cho app iOS.

Các quy định phải tuân thủ trong app

Nếu bạn cung cấp thanh toán bên thứ ba hoặc link về website, Apple áp các quy định sau, theo trang lựa chọn thanh toán:

• Mua trong app phải được cung cấp cùng lúc, trên mọi màn hình bán nội dung số.
• Nó phải nổi bật ít nhất bằng mọi lựa chọn khác. Apple đánh giá tổng thể: bố cục, câu chữ, phông chữ, màu sắc, kích thước.
• Nút mua trong app dùng hình ảnh do Apple cung cấp, trên nền đen hoặc trắng. Với nút iOS tiêu chuẩn, chữ bên cạnh có cỡ ít nhất 15 point.
• Bạn có thể hiển thị giá và quyền lợi khác nhau theo từng lựa chọn.
• Luồng của bạn không được làm nản lòng hay gây rối việc mua trong app.
• Trang App Store của bạn không được nói rằng có thể mua trên website hoặc qua thanh toán bên thứ ba.
• Trước khi đưa người dùng sang lựa chọn khác, app phải hiện một cửa sổ thông tin: người dùng biết rằng họ đang giao dịch với bạn, không phải Apple. Trên iOS 26.5, bạn tự dựng cửa sổ này theo thông số Apple cung cấp. Cửa sổ do hệ thống cung cấp sẽ có từ iOS 27.2, đang beta.

Nhà cung cấp của bạn phải đạt cấp độ 1 của chuẩn PCI cho dữ liệu thẻ. Họ cũng phải có dịch vụ khách hàng: khiếu nại giao dịch trái phép, quản lý gói đăng ký, hoàn tiền.

Nếu bạn đang làm màn hình mua hàng đầu tiên, các lỗi paywall iOS vẫn đúng khi có hai nút.

Trẻ vị thành niên: quy định nghiêm nhất

Các quy định này của Apple áp dụng cho mọi app có thanh toán thay thế ở Brazil:

• danh mục Kids: kiểm soát của phụ huynh trước mọi thanh toán bên thứ ba, và không có ưu đãi mua hàng trên website;
• các app khác: hỗ trợ kiểm soát mua hàng của phụ huynh, và cần sự đồng ý của phụ huynh cho các lựa chọn thay thế;
• dưới 18 tuổi: thanh toán bên thứ ba trong app phải qua kiểm soát của phụ huynh, và không có ưu đãi mua hàng trên website.

Ở Brazil, người dùng dưới 18 tuổi không được thấy bất kỳ ưu đãi mua hàng nào trên website của bạn, kể cả khi phụ huynh đồng ý. Nhật Bản thoáng hơn, theo trang của Apple về Nhật Bản. Trong bảng này, « không web » nghĩa là không có ưu đãi mua hàng trên website.

Người dùng	Brazil	Nhật Bản
Danh mục Kids	Kiểm soát phụ huynh, không web	Kiểm soát phụ huynh, không web
Dưới 13 tuổi	Kiểm soát phụ huynh, không web	Kiểm soát phụ huynh, không web
13 đến 17 tuổi	Kiểm soát phụ huynh, không web	Thanh toán bên thứ ba và web, kiểm soát phụ huynh

Để biết người dùng có thể thanh toán hay không, Apple chỉ đến canMakePayments trong StoreKit, và hứa sẽ có API mới. Về tuổi, tháng 2/2026 Apple thông báo rằng Declared Age Range API cung cấp ở Brazil nhóm tuổi của người dùng, nếu họ hoặc phụ huynh đồng ý chia sẻ. Cách mình hiểu: chừng nào app chưa biết người dùng đã đủ 18 tuổi hay chưa, đừng hiện link về website.

Tuổi cũng ảnh hưởng tới trang app của bạn. Theo thông báo của Apple ngày 24/2/2026, app khai báo có loot box trả phí sẽ chuyển sang 18+ trên App Store Brazil. Từ ngày đó, App Store ở đây chặn tải app 18+ cho đến khi người dùng được xác nhận là người lớn.

Thiết lập thanh toán thay thế, từng bước

1. Nhờ chủ tài khoản chấp nhận hợp đồng cập nhật. Apple Developer Program License Agreement giờ bao gồm các điều khoản cho Brazil. Chỉ chủ tài khoản (Account Holder) mới chấp nhận được, và Apple đặt hạn chót là 6/7/2026 cho mọi thành viên. Hãy kiểm tra trong tài khoản nhà phát triển rằng nó đã được chấp nhận.
2. Thêm entitlement vào App ID. Khi hợp đồng đã được chấp nhận, tài khoản của bạn có quyền dùng entitlement StoreKit External Purchases or Offers. Thêm nó vào identifier của app trong Certificates, Identifiers & Profiles.
3. Khai báo nó trong project. Khóa là com.apple.developer.storekit.custom-purchase-link.allowed-regions, một mảng chỉ chứa một giá trị: br. Với Expo, nó nằm trong entitlements của config. Sau đó provisioning profile của bạn phải bao gồm entitlement này.
4. Code luồng theo đúng thứ tự bắt buộc. Kiểm tra canMakePayments, rồi thuộc tính isEligible của ExternalPurchaseCustomLink. Trước mỗi giao dịch có thể xảy ra, xin một token bằng token(for:): đây là thứ bạn sẽ báo cáo cho Apple. Khi người dùng chạm nút thanh toán thay thế, hiện cửa sổ thông tin. Trang của Apple nhắc đến showNotice, nhưng tài liệu API chỉ cho cửa sổ hệ thống từ iOS 27.2: trước đó, bạn tự vẽ.
5. Giữ mua trong app trên màn hình, với các kiểm soát của phụ huynh như mô tả ở trên.
6. Ghi tên nhà cung cấp thanh toán trong ghi chú cho App Review. Họ phải sẵn sàng xử lý giao dịch của app bạn. Bản nộp thiếu thông tin có thể làm chậm việc review hoặc bị từ chối.
7. Báo cáo giao dịch hàng tháng. Trợ giúp App Store Connect yêu cầu báo cáo trong 15 ngày sau khi hết tháng dương lịch, gửi qua External Purchase Server API. Nó chứa mọi token: mua hàng, gia hạn, hoàn tiền, và cả những token không có giao dịch.

Đây là bước 3 với Expo, trong app.json:

{
  "expo": {
    "ios": {
      "entitlements": {
        "com.apple.developer.storekit.custom-purchase-link.allowed-regions": [
          "br"
        ]
      }
    }
  }
}

Các API ở bước 4 là native. Mình chưa kiểm tra RevenueCat hay thư viện React Native nào khác có hỗ trợ chúng không. Hãy kiểm tra trước khi chọn hướng này, nếu không bạn sẽ cần một native module. Cuối cùng, Apple nói rõ entitlement chỉ hoạt động trên App Store Brazil, trên iPhone, từ iOS 26.5.

Kho ứng dụng thay thế và notarization

Phân phối app qua kho ứng dụng thay thế được quản lý trong App Store Connect: bạn đăng ký kho, Developer ID của bạn và token do kho cung cấp. Ở đó không có mua trong app, và doanh thu nội dung số của bạn trả CTC 5%. Mọi app đều phải qua notarization, bất kể kênh nào: một bước kiểm tra cơ bản, tự động và có người duyệt, nhẹ hơn review của App Store.

Mở kho ứng dụng riêng cần Apple cho phép. Theo trang về kho ứng dụng thay thế ở Brazil, bạn cần, trong số các điều kiện khác, đăng ký dưới dạng tổ chức. Bạn cũng cần, tùy chọn, hoặc cung cấp thư tín dụng dự phòng (stand-by letter of credit) 1 triệu đô la, hoặc có hai năm làm thành viên liên tục và một app vượt một triệu lượt cài đặt lần đầu trên toàn thế giới trong năm dương lịch trước.

Bạn bán hàng sang Brazil từ Pháp

Các trang của Apple nhắm đến app phân phối ở Brazil, không đặt điều kiện gì về quốc gia của nhà phát triển. Nếu app của bạn đang bán ở Brazil, có ba điểm cần lưu ý:

• Nếu bạn không làm gì, app vẫn tiếp tục bán qua mua trong app, theo bảng hoa hồng của Brazil.
• Các trang của Apple cho Brazil không yêu cầu một app riêng. Entitlement chỉ có hiệu lực trên App Store Brazil, và isEligible cho bạn biết lựa chọn đó có mở cho người dùng hay không. Nhật Bản, Liên minh châu Âu và Hàn Quốc có quy định riêng; quy định của EU được trình bày trong bài hướng dẫn guideline 3.1.1.
• Ngoài mua trong app, thuế là việc của bạn. Các trang của Apple không nêu chi tiết loại thuế nào của Brazil. Hãy nhờ kế toán của bạn xác nhận mô hình trước khi thu real trực tiếp.

Những gì mình đã kiểm tra, và khi nào

Đọc lại ngày 27/10/2026. Mức phí, điều kiện và các bước lấy từ các trang của Apple, đọc trong mã HTML vào ngày đó. Thông tin về thỏa thuận lấy từ thông cáo chính thức của CADE, không phải toàn văn TCC. Không có thử nghiệm thực tế: phép tính bằng real là ví dụ, không tính thuế hay phí nhà cung cấp.

Các trang này thay đổi rất nhanh: Apple đã thông báo cửa sổ thông tin của hệ thống và các API mới cho phụ huynh. Hãy đọc lại chúng trước khi code.

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

Hoa hồng App Store ở Brazil là bao nhiêu?

21% trên doanh thu nội dung số, hoặc 10% với thành viên Small Business Program và một vài chương trình khác của Apple, và với gói đăng ký sau một năm. Mua trong app cộng thêm 5% phí xử lý. Link về website của bạn tốn 15%, hoặc 10%, trên các giao dịch trong 7 ngày sau cú nhấp.

Có được đặt link về website trong app iOS ở Brazil không?

Có, với entitlement StoreKit External Purchases or Offers và mua trong app hiển thị cùng lúc. Link bị cấm với người dùng dưới 18 tuổi và trong các app thuộc danh mục Kids. Trang App Store của bạn không được nhắc đến nó.

Có thể dùng Pix trong app iPhone ở Brazil không?

Các trang của Apple và thông cáo của CADE không nêu tên phương thức thanh toán nào, kể cả Pix. Chúng đặt điều kiện cho nhà cung cấp: cấp độ 1 của chuẩn PCI cho dữ liệu thẻ, dịch vụ khách hàng, hoàn tiền. Hãy kiểm tra với nhà cung cấp rằng họ đáp ứng các điều kiện này, và mua trong app vẫn được cung cấp bên cạnh.

Có phải giữ mua trong app nếu dùng thanh toán thay thế không?

Có. Apple yêu cầu mua trong app xuất hiện cùng lúc, trên mọi màn hình bán nội dung số, và nổi bật ít nhất bằng lựa chọn kia.

Trẻ vị thành niên có được thanh toán ngoài mua trong app ở Brazil không?

Có, nhưng chỉ trong app, qua kiểm soát của phụ huynh. Không được có ưu đãi mua hàng trên website trước 18 tuổi. Ở Nhật Bản, ưu đãi web được phép từ 13 tuổi, qua kiểm soát của phụ huynh.

Các quy định này có áp dụng cho nhà phát triển không ở Brazil không?

Các trang của Apple nhắm đến app phân phối ở Brazil và không đặt điều kiện nào về quốc gia của nhà phát triển. Một nhà phát triển ở Pháp có app trên App Store Brazil vì vậy cũng bị áp dụng: bảng hoa hồng cho mua trong app, và quy định về thanh toán thay thế nếu bật nó.

Thỏa thuận giữa Apple và CADE là gì?

Là một Termo de Compromisso de Cessação được CADE, cơ quan cạnh tranh của Brazil, phê chuẩn ngày 23/12/2025. Nó mở ra ưu đãi bên ngoài, thanh toán thay thế và kho ứng dụng thay thế, trong ba năm kể từ khi các điều khoản mới trở thành bắt buộc.

Sources

• Thông cáo của CADE về việc phê chuẩn TCC, 23/12/2025.
• Thông báo của Apple cho Brazil, 18/6/2026.
• Changes to iOS in Brazil, Payment options on the App Store in Brazil và Operating an alternative app marketplace in Brazil, Apple Developer.
• ExternalPurchaseCustomLink, tài liệu StoreKit.
• Payment options on the App Store in Japan, để so sánh quy định về trẻ vị thành niên.
• Age requirements for apps distributed in Brazil, Australia, Singapore, Utah, and Louisiana, 24/2/2026.
• Reporting tokens and transactions to Apple, trợ giúp App Store Connect.

Bán app của bạn, ở Brazil và nơi khác

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

Để xây app và gắn gói đăng ký qua mua trong app, iOS Kit chứa code khởi đầu của các app của mình và lộ trình bốn bước đến App Store, theo nhịp độ của bạn. Mọi thứ liên quan đến kiếm tiền đều được gom trên trang gói đăng ký in-app iOS.