Skip to content

Integration guide

Choosing a checkout: start with the sale, not the software

A store, a custom app, and a conversation-led business need different routes to payment. Here is how to choose without rebuilding more than you need.

PayPort editorial team

The first question is where the order begins

Picture three purchases. A shopper adds a jacket to a store basket. A business customer approves a quote by email. A user buys access inside an app. Each customer wants to pay, but the business already knows different things about the order. The store has products and delivery details; the email thread has an agreed scope; the app has an account and an entitlement.

Before comparing integrations, write down where the purchase is agreed, where its amount is calculated, and which system should own its reference. A payment page should continue that sale. It should not ask the customer to rebuild an order your business already understands.

Keep a working store at the center

If your catalog, inventory, and customer service already live in an ecommerce platform, begin there. A platform connection can be a sensible first route when it fits the version, extensions, and payment methods you need. Replacing the whole checkout to add one method may create more work than it solves.

Look beyond an installation screen. Can staff identify a paid order? Where do they initiate a refund? What happens to inventory while payment is pending? A connection is useful when those everyday tasks make sense to the people running the store.

Use hosted checkout where it removes unnecessary work

A hosted payment page lets your application prepare the order and hand the payment step to a provider. You still own the product experience before and after that handoff: the amount, reference, return destination, and customer explanation. Check how much of the page can be adapted before promising a fully custom experience.

Outsourcing a payment page also does not mean outsourcing every security responsibility. The storefront and its connection still need appropriate protection. Discuss the applicable PCI DSS scope with your provider or assessor rather than assuming that a redirect makes the entire website compliant.

Choose custom integration for a clear product reason

A custom flow can be useful when your product needs specific navigation, account logic, or an unusual order lifecycle. The benefit should be concrete: a subscription entitlement, a booking that needs inventory reservation, or a purchase embedded in an application. More control also means more decisions about failures and recovery.

Make sure the team has time to maintain those decisions after launch. Currency handling, duplicate notifications, retries, and refunds are not temporary implementation details. They become part of the product your customers rely on.

A payment link can be enough for a direct sale

For an agreed quote or a one-off order, a payment link may be the most direct next step. The customer should see a recognizable item, agreed amount, and business identity. Your team should be able to trace the request back to the original order.

The important boundary is between a link and a complete ordering system. If customers need to configure products, calculate delivery, and manage baskets, plan where those functions will happen. A short URL cannot replace missing order information.

Work through a booking before choosing the integration

Consider a small workshop selling places in a weekend class. The order is not only an amount: it includes a date, a seat, and a customer contact. If payment is delayed, the business must decide whether that seat remains reserved. If a payment arrives after a reservation expires, someone needs to review the booking rather than automatically issue a confirmation.

A platform connection may work when the existing booking extension can handle those states. Hosted checkout may work when the workshop already has an application that manages reservations. A link may suit a booking agreed individually with the customer. The best choice is the one that keeps the seat, payment, and confirmation in agreement.

Ask the provider and developer to demonstrate that complete example, including an expired reservation and a refund. This turns an abstract comparison of technologies into a decision about your actual service.

Test the exception before approving the design

Walk through a declined payment, a customer closing the browser, a delayed confirmation, and a refund. Decide what the customer sees and who acts inside the business. A beautiful success screen is only one part of the experience.

A useful final exercise is to ask someone outside the project to complete an order on a phone and then explain its status. If they cannot tell whether they have paid or what comes next, simplify the journey before adding another feature.

Choose the smallest integration that supports the complete order lifecycle, including the ordinary exceptions.
What to take away
Back to the blog