Ecommerce checkout workflow

What is a shopping cart payment integration?

A shopping cart payment integration connects an online store's cart and order workflow with a payment service. It lets the store send the correct order context into checkout, present an approved payment experience, receive a payment result, and update the matching order. The exact screens, data fields, payment methods, and follow-up events depend on the store platform and payment provider.

The short answer

The shopping cart holds the customer's selected items, quantities, and calculated order total. The payment integration handles the handoff from that cart to a payment flow and returns information the store can use to manage the order. Depending on the chosen setup, the customer may be redirected to a provider-hosted checkout page, complete an embedded form, or use payment components arranged within a more customized checkout.

A useful integration does more than display a pay button. It keeps the cart, payment request, payment result, and store order connected through stable identifiers. That connection helps the business avoid treating an incomplete attempt as paid, match later status events to the correct order, and give staff a traceable record of what happened.

How the cart and payment flow connect

Prepare the order context

The store confirms the current cart, calculates the amount through its approved business logic, and creates an order or checkout reference. The server should remain the authoritative source for the amount submitted to the payment service.

Start the payment experience

The integration creates a provider-side payment or checkout object and presents the documented payment interface. The provider may host the page, supply an embedded form, or provide components for a custom flow.

Update the matching order

After the customer acts, the store evaluates the returned status and any supported server-to-server event. It then updates the matching order according to the provider's documented lifecycle.

A typical checkout sequence

  1. Review the cart. The customer confirms items, quantities, delivery information, and the displayed total.
  2. Create an order reference. The store records a unique internal identifier before asking the payment service to begin checkout.
  3. Create the payment session or order. Server-side code sends the documented amount, currency, and permitted order context to the provider.
  4. Present checkout. The customer enters or selects a payment method through the provider's supported hosted, embedded, or component-based interface.
  5. Receive an immediate result. The browser may return to the store, but that return alone should not be treated as the only source of payment status.
  6. Process supported events. A documented webhook or other server notification can confirm later status changes and connect them to the stored order reference.
  7. Continue the order workflow. The store marks the order according to the verified status and sends the appropriate confirmation or staff task.

For the surrounding transaction lifecycle, see how online credit card payments work and what a payment webhook is.

Hosted, embedded, and custom approaches

Provider-hosted checkout

The store redirects the customer to a payment page operated by the provider and receives the customer back afterward. This can reduce the amount of checkout interface the merchant must build, while still requiring careful order and status handling.

Embedded payment form

The payment interface appears within the store experience using provider-supplied components. The merchant should follow the provider's current implementation instructions and understand which elements are hosted by each party.

More customized flow

A business may use lower-level payment components or APIs for greater control. Greater control also creates more design, testing, error-handling, and maintenance work, so the choice should reflect actual workflow needs.

Merchants comparing interface patterns can also review what a hosted payment page is and how hosted payment fields fit into checkout.

What merchants should evaluate

  • Order ownership: identify which system calculates the final amount, creates the order reference, and decides when an order changes state.
  • Status model: map provider statuses to clear store states such as awaiting payment, paid, canceled, or requiring staff review without assuming every attempt finishes immediately.
  • Checkout presentation: decide whether a hosted, embedded, or customized flow fits the customer experience and the team's ability to maintain it.
  • Documented payment methods: confirm current availability for the specific merchant account, provider, platform, customer context, and intended checkout path.
  • Failure handling: define what customers and staff see when a request is declined, interrupted, duplicated, delayed, or cannot be matched to an order.
  • Operational records: make sure staff can trace the store order reference to the provider-side reference without copying sensitive payment data into general notes.
  • Ongoing ownership: assign responsibility for provider updates, store changes, event monitoring, testing, and incident response.

Common integration gaps

One common gap is trusting only the browser return page. A customer can close a tab, lose connectivity, or return before a later status update arrives. Provider documentation commonly includes a server-side lifecycle or event mechanism for this reason. The store should use the provider's documented confirmation path and make repeated event processing safe for the business workflow.

Another gap is allowing a browser-submitted amount to become authoritative. Cart contents and displayed totals can change, so the server should calculate or validate the order amount using trusted store data before it creates the payment request. Teams should also retain stable internal and provider references so support staff can investigate an order without searching by card details.

Finally, a plugin or prebuilt connector still needs review. Its presence does not prove that every feature, payment method, extension, checkout customization, or account configuration is supported. Confirm the exact combination in current documentation and test the intended customer journey before launch.

Test the complete order journey

Use the provider's documented test environment and test values to check the ordinary purchase path plus supported unsuccessful and delayed scenarios. Verify that the cart total, store order, provider-side object, customer message, staff view, and event handling remain aligned. Repeat supported callbacks or event deliveries to confirm that the store does not perform the same business action twice.

Keep test and live credentials separate, and do not place secret keys in browser code, source-control files, screenshots, or general support messages. Use fictitious customer details where possible. Never submit real cardholder data, passwords, bank credentials, complete account numbers, or secret API keys through a general contact form. For a structured prelaunch approach, review what a sandbox payment environment is.

Questions to answer before choosing an approach

Who maintains the connection?

Clarify whether the store platform, a connector provider, an internal developer, or another accountable party owns setup, updates, monitoring, and support.

Which system controls totals?

Document where item amounts, delivery charges, discounts, and the final payable amount are calculated and validated before checkout begins.

How are statuses confirmed?

Identify the provider's documented response and event flow, then decide exactly how each status changes the store order and staff workflow.

How will changes be tested?

Maintain repeatable cases for store updates, provider changes, checkout extensions, error paths, and representative desktop and mobile experiences.

Map the workflow before selecting the connector

Start with the store's actual order journey: cart calculation, checkout presentation, payment confirmation, order update, customer communication, and staff follow-up. Then compare only documented integration approaches that support that journey. Payments Max can help merchants organize payment-processing questions, but the platform or provider should confirm the current technical setup for a specific store.

Explore online payment guidance

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