Why use Checkout

With Checkout, complete one integration to enjoy the benefits of multiple payment methods.

Do I need to secure my website

Both Embedded and Hosted Checkout are secure. You must add an SSL certificate to your website.

How do I show a particular payment method by default

You can set the defaultPaymentMethod for your Checkout request. If defaultPaymentMethod=CARD, the customer first sees the card widget when Checkout renders. They can go back to see other payment methods.

Why do Checkout and the payment methods appear differently depending on the payment extension used

The different payment extensions (Shopify, Wix, WooCommerce, and so on) have different capabilities. Some of them enable you to configure which payment methods appear while others don't.

Can I add local domain to the allowlist

No, you can only add publicly accessible domains to the allowlist.

How long does a Checkout session last

Customers have 30 minutes to complete a payment, whereafter the session expires.

Why am I receiving a CORS error when integrating Checkout

Ensure that you are not executing API calls that should happen from your backend on your frontend. Do not authenticate on the user interface as this exposes your Peach Payments credentials to your customers.

What status does Peach Payments return if I create a Checkout ID but don't use it

Hosted Checkout

• If the checkout URL is never opened:
  • For the first 30 minutes, a GET status call returns the 700.400.580 result code.
  • After 30 minutes, the system automatically triggers a webhook with the 000.200.100 result.code.
  • After another 30 minutes (total 60 minutes), the system sends a webhook with the 100.396.104 result.code marking the checkout as expired or cancelled.
• If a customer opens the checkout URL but doesn't make a payment:
  • The successfully created checkout webhook triggers.
  • After checkout times out, the system sends a Uncertain status - probably cancelled by user webhook.

Embedded Checkout

• If the checkout URL is never opened:
  • The system does not trigger a webhook after 30 minutes.
  • A GET status call returns only the basic checkout information, with no result code.
• If a customer opens the checkout URL but doesn't make a payment:
  • The successfully created checkout webhook triggers.
  • After checkout times out, the system sends a Uncertain status - probably cancelled by user webhook.

What do I do if a checkout ID is not used

• Define your own timeout period (for example, 30 minutes) after which you can consider the transaction as expired or failed if your customer does not make payment and the system does not return a status.
• If your customer later completes the payment, use the webhook notification to override the previous state and update the transaction.

For Hosted Checkout, why are my customers getting a "Could not find Checkout details." error

Your customer refreshed their browser after entering checkout which causes this error.

After checkout loads, customers should not refresh their browsers during the payment process. They must either cancel the payment or close the browser and go back to your site to create a new checkout.

For Hosted Checkout V1, why can't I use the signature generated for the payment request to get the payment status

You can't reuse the signature because its encryption input is different. See the Hosted Checkout V1 authentication and authorisation section for details on how to generate a signature for the payment status call.

Where can I learn more about Embedded Checkout and its benefits

This FAQ describes the differences between Embedded and Hosted Checkout and highlights the benefits of Embedded Checkout.

For Embedded Checkout, why do my customers sometimes see a blank screen after choosing to pay with card

Your customer could be experiencing network issues like ISP throttling, firewall blockages, IP routing problems, or DNS issues. They could also have disabled third-party cookies or have an antivirus program that is affecting their checkout experience. They should check for issues like these before attempting to pay again.