Hosted Checkout lets you redirect the shopper to a payment page hosted by Adyen, so Adyen renders the UI and handles every enabled payment method. It is the lowest-effort integration and keeps your PCI scope to a minimum.
How it works
Hosted Checkout uses the Sessions flow. Your server makes a single Checkout API request and Adyen takes care of the rest.
Your server creates a session. Your backend calls the Adyen Checkout API
/sessionsendpoint with the payment details, then receives a hosted payment page URL.You redirect the shopper. Send the shopper to the URL returned by Adyen.
Adyen collects payment. Adyen displays the eligible payment methods, collects details, and handles additional actions such as 3D Secure or redirects.
The shopper returns. Adyen returns the shopper to the
returnUrlyou provided.Adyen confirms with a webhook. Treat the webhook, for example an
AUTHORISATIONnotification, as the authoritative result. See Standard Payment Flow.
When to use it
Choose Hosted Checkout when you want:
The fastest path to accepting payments, with minimal frontend work.
The smallest possible PCI scope, because the payment page is served by Adyen.
Adyen to manage payment method rendering and additional actions for you.
If you need the payment form embedded in your own pages, consider Drop-in Integration or Components Integration. If you need full control over the UI, see API Integration.
Code sample
Create a session on your server, then redirect to the returned URL. Include your Store ID on every Valpay transaction.
POST https://checkout-test.adyen.com/v71/sessions
X-API-Key: YOUR_API_KEY
{
"merchantAccount": "YOUR_MERCHANT_ACCOUNT",
"amount": { "currency": "USD", "value": 1000 },
"reference": "ORDER-12345",
"returnUrl": "https://your-site.com/checkout/return",
"countryCode": "US",
"store": "YOUR_STORE_ID"
}
// Adyen returns a hosted payment page URL
// Redirect the shopper to that URL
redirect(response.url)
During development, create sessions against the test Checkout API and pay with Adyen test cards. Test transactions do not reach the card networks. See Sessions vs Advanced Flow and Environments.
Credentials, your merchant account, and your Store ID are provided securely by Valpay. Contact Valpay Support for credentials or troubleshooting.