# 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.

| Package                                                | Version |
| :----------------------------------------------------- | :------ |
| `peachpayments_flutter`                                | 1.4.0   |
| `peachpayments_flutter_netcetera_3ds` / `_scancard`    | 1.1.3   |
| `peachpayments-hyperswitch-ios`                        | 0.7.4   |
| `io.peachpayments:hyperswitch-sdk-android`             | 1.5.5   |
| `io.peachpayments:hyperswitch-gradle-plugin`           | 0.2.14  |
| `@peach-payments/react-native`                         | 1.1.0   |

See the [iOS](/sdk-mobile/ios), [Android](/sdk-mobile/android), [Flutter](/sdk-mobile/flutter), and [React Native](/sdk-mobile/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](/integrate/sdk) for a runnable walkthrough. The [Web SDK](/sdk-web) guide covers the framework integrations, and [Web SDK theming](/operate/customization) 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](/integrate/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](/integrate/api-only) 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.

| Category | Payment methods |
| :------- | :-------------- |
| Bank transfer | PayShap, Capitec Pay, Peach EFT |
| Pay later | Payflex, ZeroPay, Float, Happy Pay, Mobicred, RCS, PayJustNow |
| Wallet | Apple Pay, Google Pay, Samsung Pay, Scan to Pay, M-PESA, MauCAS, blink by Emtel, MCB Juice |
| Voucher | 1Voucher |
| Crypto | MoneyBadger |

See [Payment methods](/operate/payment-methods) for availability by market, and [Testing](/docs/testing) for sandbox credentials.

---

Interactive version: https://playground.sandbox-next.peachpayments.com/docs/release-notes