Docs Home
Dev Essentials
PaymentsCommerceCustomersStaffMerchants
Publish
Release notes

Docs

Docs Home
Dev Essentials
Payments
Commerce
Customers
Staff
Merchants
Publish
Release notes
Overview
Square APIs and SDKs
Mobile SDKs
Web Payments SDK
App Marketplace Requirements

/

Mobile SDKs

2025-11-13 Changelog

Android
Mobile Payments SDK
Link to section

Details

Link to section

Android Mobile Payments SDK 2.3.4

Important

This release addresses an issue affecting 32-bit Android devices discovered in 2.3.3. If you planned to update to 2.3.3 to use new Card Surcharge functionality, please upgrade to version 2.3.4 instead.

Breaking change:

  • allowCardSurcharge: Boolean is now a required parameter in the PaymentParameters.Builder constructor.

    • Set to false to maintain existing behavior (no surcharge)
    • Set to true to enable card surcharge functionality (requires Beta opt-in and Dashboard configuration)
    val builder = PaymentParameters.Builder(
    amount = Money(1000, CurrencyCode.USD),
    processingMode = ProcessingMode.AUTO_DETECT,
    allowCardSurcharge = false  // Now required
)
Link to section

Card Surcharging BETA

  • Credit card surcharging is now available as a beta feature for merchants in the United States. Surcharges allow merchants to pass on credit card processing fees to buyers at the point of payment, while remaining compliant with surcharging laws and regulations. To use surcharging in the Mobile Payments SDK, you must be added to the list of beta developers. Email [email protected] to learn more.