Checkout FAQ
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.
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.
Updated 6 days ago