Checkout by Peach Payments is a ready-to-use payment experience.

With Checkout, merchants have the ability to accept a full range of payment methods with a single developer integration.

Peach Payments offers Checkout through two implementations:

• Embedded Checkout: Embed checkout on your website and accept payments without redirecting to Peach Payments Checkout.
• Hosted Checkout: Redirects customers to Peach Payments Checkout to accept payments.

❗

You cannot embed Hosted Checkout or Embedded Checkout in an iframe. Attempting to do so could cause payment methods to fail.

Payment methods

📘

For details on which payment methods Checkout supports, see the Payment methods section.

Enable payment methods using the Peach Payments Dashboard. Checkout is PCI compliant and provides both the merchant and customer confidence in the security of web payments.

User experience

Checkout streamlines the payment experience by allowing customers to confidently complete their online purchases.

Embedded Checkout

1. Display a payment button on your Checkout page when a customer is ready to complete payment for their purchase.
2. Generate and render a Checkout that includes the purchase details on your website.
3. The rendered Checkout shows the customer the purchase amount and all the payment methods available to them to complete the purchase.
4. The customer selects their desired payment method to complete the purchase.
5. On your website, inform the customer of the Checkout result.
6. If you've enabled a valid webhook, you receive a response with the details of the completed, cancelled, or uncertain transaction.

Hosted Checkout

1. Display a payment button on your Checkout page when a customer is ready to complete payment for their purchase.
2. From your backend, generate a Checkout and redirect the customer to the redirectUrl.
3. The Checkout page shows the customer the purchase amount and all the payment methods available to them to complete the purchase.
4. The customer selects their desired payment method to complete the purchase.
5. If successful, Checkout redirects the customer back to your website with a confirmation of their transaction. If cancelled, Checkout redirects the customer back to the provided shopperResultUrl or, if configured, the cancelUrl.
6. If you've enabled a valid webhook, you receive a response with the details of the completed, cancelled, or uncertain transaction.

Known limitations

• For Apple Pay, when using Embedded Checkout or iframing Hosted Checkout, follow the steps described in the known limitations section. Failing to do so results in Apple Pay payments not working.
• Embedded and Hosted Checkout ignore the cancelUrl parameter and take customers to the shopperResultUrl instead. To enable the cancelUrl parameter contact support. Embedded Checkout has more limitations that don't apply to Hosted Checkout.

Find your credentials

Follow these steps to find your credentials:

1. Log in to the Peach Payments Dashboard.
2. In the left navigation menu, click Checkout.
3. The API keys section enables you to copy your entity ID, secret token, client ID, client secret, and merchant ID.

🚧

If you don't have access to the Checkout section or can't find your credentials, contact support.

📘

To retrieve your sandbox credentials, switch to the sandbox Dashboard and follow the instructions above.

Test and go live procedure

While integrating, you have access to a sandbox account during user acceptance testing. Use this account to test fake payments to verify your integration.

For more information on testing, go live, and test cards and credentials, see the Test and go live procedure section.

Quick links