Checkout release notes

2026-06-04

This release of Embedded Checkout adds Embedded Express, a wallet-only variant that displays Apple Pay, Google Pay, and Samsung Pay for one-click payment by surfacing free-standing wallet buttons earlier, saving clicks. To enable Embedded Express, call Checkout.express instead of Checkout.initiate when instantiating the Checkout object.

2026-05-19

This release of Embedded and Hosted Checkout:

  • Adds support for Apple Pay in Mauritius.
  • Updates the Apple Pay integration:
    • The id parameter in successful Checkout webhooks now holds the transaction ID. Use the id parameter when refunding Apple Pay transactions through the Refund API or searching for transactions on the Peach Payments Dashboard.
    • The isApplePayWallet parameter is no longer set.
    • You can now refund Apple Pay transactions from the Shopify dashboard.

2026-05-13

This release of Embedded and Hosted Checkout simplifies sandbox testing for Pay by Bank and Absa Pay. You no longer need to include "customParameters[enableTestMode]":"false" in the API request body.

2026-04-08

This release of Embedded and Hosted Checkout adds support for Absa on PayShap with a transaction limit of R3,000.

2026-03-23

This release of Embedded and Hosted Checkout adds support for Absa Pay via Pay by Bank.

2026-03-16

This release of Embedded and Hosted Checkout allows you to test Nedbank Direct EFT on sandbox.

2026-03-06

This release of Embedded Checkout addresses the Samsung Pay known limitation. Embedded Checkout does support Samsung Pay Web.

2026-02-16

This release of Embedded and Hosted Checkout adds support for Nedbank Direct EFT.

2026-01-22

This release of Checkout:

  • Adds the merchant.name parameter to Checkout webhooks.
  • Adds the following parameters to Hosted Checkout V2:
    • enableAddNewCard - Allows you to enable or disable the add new card button on the Checkout card form.
    • cardSubmitButtonText - Allows you to customise the text for the card submit button.
    • cardHeadingText - Allows you to customise the heading text for the card form.
    • cardHeadingSavedCardsText - Allows you to customise the heading text for the header section when there are cards saved.

2025-11-11

This release of Checkout enables you to secure Checkout webhooks using HMAC.

2025-11-10

This release of Checkout V2 and V1 enables you to set the following credential-on-file parameters:

  • standingInstruction.recurringType
  • standingInstruction.type
  • standingInstruction.mode
  • standingInstruction.industryPractice
  • standingInstruction.numberOfInstallments

2025-11-03

This release of Embedded Checkout adds the ability to disable the Add new card button on the card form.

2025-10-30

This release of:

  • Checkout V2 and V1 enables you to set the standingInstruction.expiry and standingInstruction.frequency parameters which are required for recurring payments.
  • Checkout adds the schemeTransactionId and cardholderInitiatedTransactionId parameters to the successful webhook.

2025-08-25

This release of Embedded and Hosted Checkout adds support for PayShap.

2025-07-29

This release of Checkout enables Windows users on certain browsers to pay using Apple Pay.

2025-07-25

This release of Embedded Checkout adds the ability to customise the:

  • Card payment form's heading text when the customer has stored cards available.
  • Back button text when the customer chooses to pay with a new card when stored cards are available.

2025-07-24

This release of Hosted Checkout adds the cardRemovalUrl parameter, allowing you to remove a stored card from the customer's profile.

2025-07-21

This release of Embedded Checkout adds the ability to show or hide the CVV field when making a one-click payment.

2025-07-10

This release of Embedded Checkout adds the ability to hide billing fields on the card form.

2025-07-04

Updated the Float documentation to highlight that Embedded Checkout supports Float.

2025-07-03

This release of Embedded Checkout adds the onError event handler, allowing you to hook into error events.

2025-07-02

This release of Checkout introduces the payment methods endpoint which is the V2 version of merchant specs.

2025-06-27

This release of Embedded Checkout adds the onRemoveCard event handler, allowing you to remove a stored card from the customer's profile.

2025-06-24

This release of Checkout splits the Checkout API into V2 and V1 more definitively and:

  • Adds the V2 Status endpoint for querying the status of a checkout.
  • Updates the V2 Initiate checkout endpoint to return a redirectUrl to support Hosted Checkout.

2025-06-12

Updated the Float documentation to highlight that Embedded Checkout does not support Float.

2025-05-27

This release of Embedded and Hosted Checkout adds support for MoneyBadger.

2025-05-21

This release of Embedded and Hosted Checkout enables you to accept Google Pay and Samsung Pay with a Nedbank merchant account.

2025-05-14

This release of Embedded and Hosted Checkout enables you to use forceDefaultMethod for Google Pay and Samsung Pay.

2025-04-22

This release of Embedded and Hosted Checkout adds support for MauCAS.

2025-04-11

This release of Embedded Checkout adds the ability to:

2025-03-25

This release of Embedded Checkout enables you to render Checkout using an HTML element.

2025-03-19

This release of Embedded Checkout improves certain SDK options in favour of new, more flexible options. It also adds the onBeforePayment event handler and the ability to make card-specific customisations:

  • Custom submit button text (default: Pay Now)
  • Show or hide card icon (default: true)
  • Custom heading text (default: Please enter your card details below to complete the payment.)

2025-03-04

This release of Embedded and Hosted Checkout adds support for Happy Pay.

2025-02-26

This release of Embedded and Hosted Checkout adds support for Samsung Pay.

2025-01-27

This release of Embedded Checkout enables you to remove the cancel button and amount from the payment method selection page and the landing page for each payment method (when you click into a payment method).

2024-12-04

This release of Embedded and Hosted Checkout adds support for Float.

2024-11-07

This release of Embedded and Hosted Checkout adds support for the cancelUrl parameter.

2024-10-30

This release of Embedded and Hosted Checkout adds support for Google Pay.

2024-10-28

This release of Embedded and Hosted Checkout adds support for RCS cards.

2024-10-08

This release of Embedded Checkout adds support for Apple Pay.

2024-06-26

This release of Embedded and Hosted Checkout removes support for FinChoicePay.

2024-04-15

This release of Embedded and Hosted Checkout adds support for:

2024-03-13

This release of Embedded Checkout adds support for Payflex.

2024-03-04

This release of Embedded and Hosted Checkout adds support for MCB Juice.

2024-01-29

This release of Embedded and Hosted Checkout adds support for Pay by Bank and removes support for InstantEFT.

2024-01-23

This release of Embedded Checkout adds support for Mobicred.

2023-10-30

This release of Embedded Checkout adds support for ZeroPay.

2023-10-06

Peach Payments is proud to announce the limited availability release of Embedded Checkout.

Embedded Checkout offers the following benefits over Hosted Checkout:

  • Better user experience and less security concerns: Keeping the customer on your website when checking out makes the experience seamless and allays security concerns.
  • Theming: Customise parts of the payment experience to match your branding.
  • Custom payment method ordering: Order payment methods according to your preferences.

Embedded Checkout has limitations that Hosted Checkout does not have. For more information, see the Embedded Checkout known limitations.

📘

Embedded Checkout is a new integration and does not support an upgrade path from Hosted Checkout.

2023-05-16

This release of Hosted Checkout updates Capitec Pay as follows:

  • Added the ability for the customers of low-risk merchants to pay using their phone number, in addition to the already-supported ID number.
  • High-risk merchants, as determined by Capitec, must provide verified ID numbers in requests to Peach Payments to enable their customers to pay using Capitec Pay. The customers of high-risk merchants cannot pay using phone numbers. High-risk merchants using Payment Links or a payment extension cannot use Capitec Pay as there is no way for them to provide the ID number in payment requests.

2023-02-14

This release of Hosted Checkout adds support for Capitec Pay.

2022-12-05

This release of Hosted Checkout adds support for blink by Emtel.

Support

If any issues occur, contact support.