2026-10-05 — Mobile SDKs

This release of the Peach Orchestration mobile SDKs fixes billing detail collection, state prefill, and text field border styling, and adds link-text theming to Flutter.

See the iOS, Android, Flutter, and React Native guides for installation steps.

Fixed

• Billing details collected when switched off. The SDK always marked billing details as required, ignoring your profile setting. It now follows the setting. Behaviour change: if billing collection is disabled and your connector doesn't require it, those fields no longer appear in the sheet.
• State/province didn't prefill. The state list only loaded when a country field was shown, so a country set in configuration left a known state displayed empty.
• Border styling ignored by text fields. Border width and corner radius applied only to the country and state pickers. They now apply to every input. The properties are:
  • iOS: appearance.borderWidth, appearance.cornerRadius
  • Android: shapes.borderStrokeWidthDp, shapes.cornerRadiusDp
  • Flutter and React Native: shapes.borderWidth, shapes.borderRadius

Added

Flutter: three colour entries for link text, previously unthemeable. Set them on the light and dark colour objects in Appearance.colors:

• link — all link text, including both payment-method toggles
• addPaymentMethodButton — overrides link for "add new payment method"
• useSavedPaymentMethodButton — overrides link for "use saved payment methods"

Set link alone to restyle both toggles; use the per-button keys only to colour them differently.

2026-09-08

This release of Peach Orchestration introduces Embedded Checkout, Hosted Checkout, Server-to-Server integrations, and support for alternative payment methods.

Embedded Checkout

Embed a payment form on your website. Your server creates the payment intent; the Web SDK collects and confirms the payment.

This release includes:

• Integration guides for Vanilla JavaScript, React, Vue, and Angular
• Payment Element layout options (tabs and accordion)
• Payment method ordering
• Apple Pay, Google Pay, and Samsung Pay
• Saved cards via customer sessions
• Appearance theming (presets, variables, and CSS-like rules)
• Inline iframe redirection for alternative payment methods
• Sandbox test cards and end-to-end testing guidance

See Embedded Checkout for a runnable walkthrough. The Web SDK guide covers the framework integrations, and Web SDK theming the look and feel.

Hosted Checkout

Redirect shoppers to a payment page hosted by Peach. Your server creates the payment; Peach collects the payment details and returns the shopper to your site. There is no checkout for you to build. The page runs the same Web SDK as Embedded Checkout, which is why its layout options mirror the embedded ones.

This release includes:

• A hosted page that offers every payment method enabled on your business profile
• allowed_payment_method_types to narrow what the shopper is offered
• Branding and layout through payment_link_config — theme, logo, seller name, layout, and the order details shown to the shopper
• Saved cards, and storing a credential for later merchant-initiated charges
• session_expiry to control how long the page stays payable
• Return handling through return_url, with webhooks and payment status requests for the final state

See Hosted Checkout for a runnable walkthrough.

Server-to-Server

Build and host your own checkout, collect the payment details, and create and confirm payments directly from your server through the Orchestration API.

This release includes:

• Support for cards, wallets, and alternative payment methods
• Redirect flows for payment methods that require customer action
• QR code flows for Scan to Pay and MauCAS
• Payment status updates through webhooks and payment status requests
• Refund flows for supported payment methods

See Server-to-Server for runnable requests and payment-method-specific requirements.

Alternative payment methods

Orchestration now supports multiple alternative payment methods, in addition to cards and wallets. The methods a customer sees depend on what is enabled on your business profile.

See Payment methods for availability by market, and Testing for sandbox credentials.