Home / Hosted checkout or API: questions to ask first
PAYMENT TECHNOLOGY

Hosted checkout or API: questions to ask first

Choose an integration approach around the customer journey and your technical resources.

Start with the checkout journey

Describe where payment should begin, how the customer moves through checkout and what happens after success or failure. Confirm which methods and currencies need to appear.

Review your technical resources

A hosted checkout and a direct API can involve different implementation work. Ask for documentation and establish what your team will build, maintain and test.

Clarify payment-data handling

Understand which systems handle payment details and what responsibilities apply to your implementation. Confirm the required security scope with the relevant provider.

Test the operational journey

Include failed payments, refunds, customer support and reconciliation in the testing plan. Recurring billing requirements should be discussed separately rather than assumed.

Agree what launch means

Document the integration scope, test criteria, activation steps and support contacts. Feature availability must be confirmed against the selected gateway.

General educational information. Your provider’s confirmed requirements and agreement govern your arrangement.

← Back to Insights

Compare ownership of the customer experience

With any integration option, establish which parts of the checkout your team controls and which are supplied by the provider. Ask about branding, supported devices, language presentation and return pages. A hosted page can reduce some implementation work, while an API may require more development, but the actual responsibilities depend on the chosen provider. Make the decision against documented capabilities rather than general assumptions about the integration label.

Map the transaction states

List successful, failed, pending, cancelled and refunded outcomes as relevant to the selected gateway. Decide how each state affects an order or customer account. Confirm how notifications arrive and how a repeated message is handled. Include reconciliation references in the design so support can connect the website record with the provider record. A visually polished payment page cannot compensate for uncertain order status handling.

Test beyond the first payment

Try interrupted browser sessions, a customer returning twice, delayed notifications and duplicate submission attempts in the approved test environment. Include refunds and any subscription features the business requires. Record the expected and observed outcome for each scenario. Identify which failures your application can resolve and which require provider escalation. Agree the activation procedure and rollback responsibilities before moving the integration into live use.

Ask about security responsibilities directly

Confirm which systems receive payment details and what responsibilities the chosen implementation creates for your business. Use provider documentation and appropriate specialist advice to establish the required controls. Never infer a certification or security scope from the appearance of the checkout. The relevant configuration, hosting and data paths matter more than whether a sales description calls the integration simple or seamless.

Plan for maintenance and change

Identify who maintains credentials, gateway libraries, extensions and transaction mappings. Review how updates are tested and who monitors for integration incidents. If you later change the website platform or add a new payment method, assess whether the original design assumptions still apply. The best integration choice is one your team can operate and support throughout its lifecycle, not merely one that is quickest to demonstrate.