Ecommerce checkout guidance
What is a hosted payment page?
A hosted payment page is a checkout page delivered by a payment provider rather than built and served entirely by the merchant. A customer typically leaves the merchant's website or app, enters payment details on the provider-managed page, and then returns to a merchant confirmation page. The merchant still needs a reliable order, clear checkout messaging, safe data handling, and a server-side way to confirm the payment result.
The short answer
Hosted checkout separates the payment-entry interface from much of the merchant's storefront code. Official documentation from Stripe, Square, and Adyen describes the same broad pattern: the merchant's application creates a checkout session or payment link, receives a hosted URL, sends the customer to that URL, and handles the result after checkout. Exact terminology, fields, payment methods, return behavior, and administration vary by provider.
A hosted page is different from a fully custom checkout form. With a custom form, the merchant controls more of the interface and integration. With a hosted page, the provider supplies the payment page and determines the available layout and features. Some products also offer embedded forms, but an embedded provider form is not the same presentation pattern as a full-page redirect.
How a hosted checkout flow works
- The customer starts checkout. The merchant's site or app identifies the order, amount, currency, and other information required for that purchase.
- The merchant creates a session or link. A server-side request asks the selected provider to create a hosted checkout resource. The merchant should use its own stable order reference without exposing secret credentials to the browser.
- The customer moves to the hosted page. The browser follows the provider's checkout URL. The page displays the payment fields and any supported order details configured for that session.
- The provider handles the payment attempt. The customer submits payment information through the hosted interface. The resulting status can be successful, unsuccessful, incomplete, or still processing depending on the payment method and provider.
- The customer returns to the merchant. The hosted flow can redirect the browser to a merchant-supplied return page or a provider confirmation page.
- The merchant verifies the result. The merchant's server should use the provider's documented status or webhook process before fulfillment. A browser return by itself is not dependable proof that an order has been paid.
For the broader transaction sequence, see how credit card processing works. Merchants troubleshooting repeated requests can also review what causes duplicate online charges.
What the provider manages and what the merchant manages
Common provider-managed elements
The provider generally serves the payment page, collects the payment details entered there, applies the configuration available for that product, and returns a payment or session result through documented channels. The exact fields, wallets, branding controls, receipts, and supported payment methods depend on the selected product and account.
Merchant responsibilities remain
The merchant still controls the product or service description, order amount sent to checkout, customer expectations, return experience, fulfillment logic, refund policy, account permissions, and reconciliation. The merchant must also secure its own website, server, credentials, and integrations.
Order data needs a clear boundary
Send only information required by the provider's documented interface. Keep secret keys on the server, validate the final amount before creating a session, and avoid placing sensitive values in URLs, analytics events, support tickets, or general contact forms.
Status handling needs two paths
Use the return page to explain what the customer should expect, and use an authenticated server-side status check or verified webhook for operational decisions. This keeps fulfillment from depending on a customer closing, refreshing, or revisiting a browser page.
Hosted page, embedded form, or custom checkout?
These options describe where the payment interface is presented and how much of it the merchant builds. They do not by themselves establish which provider, account, or implementation is appropriate.
Hosted redirect
The customer moves to a provider-served page and returns afterward. This can reduce front-end checkout development, but the merchant has to plan the handoff, branding expectations, return messaging, and result verification.
Embedded provider form
The provider-delivered payment form appears within the merchant's page. The experience can feel more continuous, while the merchant still needs to follow the provider's exact implementation and security instructions.
Custom payment interface
The merchant builds more of the checkout experience using provider components or APIs. This offers more control but usually increases development, testing, maintenance, and security responsibilities.
The ecommerce and online payments FAQ hub connects this decision with gateways, checkout workflows, and online payment operations.
What to evaluate before choosing a hosted page
- Checkout fit: Confirm the page can represent the order information, currencies, payment methods, customer fields, and completion states your business actually uses.
- Customer journey: Review desktop and mobile handoffs, displayed domain, accessibility, cancellation behavior, error messages, and the route back to your site.
- Operational signals: Identify which event authorizes fulfillment, how delayed payment methods are handled, and how staff can find the session and transaction in provider records.
- Brand and policy presentation: Determine where customers see the merchant name, support contact, item details, shipping information, refund terms, and privacy notices.
- Security boundary: Document which systems receive payment data, protect merchant credentials, limit administrative access, and follow the provider's current integration guidance.
- Ongoing maintenance: Assign ownership for API version changes, webhook monitoring, failed redirects, reconciliation, test transactions, and provider notices.
Do not assume that every hosted page supports every feature or works with every platform. Verify current capabilities in the chosen provider's documentation and test environment before committing to a production workflow.
Privacy and security boundaries
A provider-hosted page can change where payment details are collected, but it does not make the merchant's entire environment automatically secure or determine compliance eligibility on its own. PCI Security Standards Council guidance distinguishes redirected checkout from embedded payment forms and notes that eligibility depends on the complete implementation and all applicable criteria. Merchants should confirm their specific validation obligations with the appropriate acquiring or compliance contact.
For day-to-day support, never ask customers to submit full card numbers, security codes, passwords, bank credentials, or secret API keys through email or a general form. Use approved provider dashboards and safe references such as an order number, timestamp, amount, and provider transaction identifier. Broader operational guidance is available from the fraud prevention and security FAQ hub.
Questions merchants often ask
Is a hosted payment page the same as a payment link?
Not always. A payment link may open a hosted page, but some hosted checkout sessions are created dynamically for a specific cart or order. Providers use different product names, so review how the URL, amount, expiration, and reuse behavior work for the selected service.
Does the redirect mean the payment succeeded?
No. A return URL is part of the customer experience, not sufficient payment confirmation. Use the provider's authenticated server-side result or verified event workflow before marking an order paid or starting fulfillment.
Can a hosted page match a merchant's website?
Many products provide some branding controls, but the available logo, color, font, domain, field, and layout settings vary. Confirm the current controls directly with the provider and test the rendered page on representative devices.
Does hosted checkout remove all technical work?
No. It can reduce payment-form development, but the merchant still needs order creation, return handling, result verification, customer support, reconciliation, monitoring, and controlled access to the provider account.
Plan the checkout boundary before implementation
Write down the customer handoff, information sent to the hosted page, confirmation event, fulfillment rule, cancellation path, support reference, and reconciliation process. Then compare that workflow with current provider documentation and test it end to end before accepting live payments.
Discuss an ecommerce payment workflow
Do not include cardholder data, passwords, bank credentials, complete account numbers, or secret API keys in a general inquiry.
To learn more about how TSYS can help improve the way your organization accepts payments, markets to new customers, or manages its HR responsibilities, get in touch by calling 585-981-8463 to get started.
CONTACT US