For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GuidesAPI Reference
GuidesAPI Reference
  • Welcome
    • Getting Started
    • Business Hub
    • Migrate from Afterpay to Cash App Afterpay
      • SDK Migration Guide
      • Migration FAQs
      • Brand Assets
      • Onsite Messaging
  • Platforms
    • Platforms Quickstart
    • Adobe Commerce (Magento)
    • Adyen
    • BigCommerce
    • Ecwid
    • PrestaShop
    • Salesforce Commerce Cloud
    • Shopify
    • Stripe
    • Wix
    • WooCommerce
  • Afterpay Messaging
    • Getting Started
    • Placement
    • Implementation
    • Migration
    • Older Messaging Information and Links
    • Launch Afterpay Info Modal Anywhere
  • API Development
    • API Quickstart
    • Test Environments
    • Certification
    • Disputes
    • Webhook Signature Generation
  • SDK
    • SDK Migration Guide
    • iOS SDK
    • Android SDK
    • React Native SDK
  • Marketing
    • Shop Directory
    • Brand Assets
LogoLogo
On this page
  • What do I need to do?
  • Afterpay checkout
  • UI messaging elements
  • Afterpay UI elements
  • Cash App Afterpay regions
  • Afterpay regions
  • Custom UI elements
  • Need help?
WelcomeMigrate from Afterpay to Cash App Afterpay

SDK Migration Guide

Was this page helpful?
Previous

Migration FAQs

Next
Built with

This guide is relevant for merchants using the iOS and Android native app SDKs for their current Afterpay integration.
All merchant-owned surfaces featuring “Afterpay” will need to be updated to reflect the new “Cash App Afterpay” brand. This includes the product detail page, cart, checkout, FAQs, emails, and any other pages using Afterpay branding.

What do I need to do?

Afterpay checkout

No action is needed. The brand updates will automatically appear within Afterpay checkout when Afterpay is migrated to Cash App Afterpay.

UI messaging elements

The native Afterpay SDK provides its own UI elements that merchants can use (iOS and Android). These UI elements are embedded in the app’s codebase and can’t be controlled dynamically from Cash App Afterpay’s backend.

The steps to migrate from Afterpay branding to Cash App Afterpay branding depends on whether you use Afterpay’s UI elements or your own custom UI elements.

Afterpay UI elements

If you use Afterpay UI elements, update your SDK to version 4.8+ on Android and version 5.8+ on iOS to access the rebranded assets.

When you update, you’ll see new names that refer to both the Afterpay themes and the Cash App Afterpay themes. A mapping of the themes and their assets are in the table below.

Legacy Afterpay themeAfterpay assetNew Cash App Afterpay themeNew Cash App Afterpay asset
mintOnBlackDefault
blackOnMintAlt
blackOnWhiteLight Monochrome
whiteOnBlackDark Monochrome
Cash App Afterpay regions

If your region migrated to the new Cash App Afterpay themes, then the SDK will use the new Cash App Afterpay assets. You must select your preferred theme.

Asset changes

  • The “Place order” button is replaced by a “Continue with” button. All other button types are the same.
  • For the Price Breakdown component, the US region now only supports the Lockup logo type (iOS and Android). Both the Compact Badge and Badge logo types are no longer supported in the US region.
Afterpay regions

If your region uses the Afterpay themes, you’ll still need to select the appropriate Cash App Afterpay theme that corresponds to the Afterpay asset. However, there will be no changes to the UI and all logos will remain supported.

Custom UI elements

If you use custom UI elements, update your custom assets with our rebranded versions here.

Need help?

If you have any questions, please contact your Account Manager.