In-Person Payment Solutions

Overview

PaymentExpress supports two in-person integration styles for taking payments through a PIN pad: Embedded Checkout and Hosted Checkout.

In both models, your system creates a cart handoff to PaymentExpress via API, the cashier initiates checkout, the customer completes payment on a PIN pad, and your system receives the final transaction result to complete reconciliation.

The main difference between the two integrations is where the cashier performs their workflow.

Embedded Checkout keeps the checkout experience inside your application, while Hosted Checkout sends the cashier to a PaymentExpress-hosted page to complete the workflow.

At a high level, both in-person options follow the same process:

  1. The cashier selects the items to be paid for in your system of record.
  2. The system of record will make an API request to hand off the cart to PaymentExpress.
  3. PaymentExpress returns a unique cartId to be stored in your system of record.
  4. The system of record will use the chosen integration style to display the checkout and PIN pad activation process to the cashier. The cashier will activate the PIN pad through this integration, prompting the customer to tap, insert, or swipe their card.
  5. Through one or more means of Payment Reconciliation, the system of record will be notified of the payment for the transaction by PaymentExpress.

In-Person Embedded Checkout

In-Person Embedded Checkout allows your cashiers to process payments efficiently and securely without ever leaving their system of record while the PIN pad securely collects card information.

Workflow Summary

  1. Determine the items to be paid and create a cart using the PaymentExpress Cart Creation API.
  2. Store the cartId returned by PaymentExpress.
  3. Load the PaymentExpress Checkout Widget embedded within your system of record using JavaScript or call the PIN Pad directly to activate and monitor the PIN pad session.
  4. The customer completes the payment at the PIN Pad.
  5. Receive confirmation of payment via transaction status calls.

Requirements

  • Requires front-end integration to load and manage the embedded checkout experience
  • If using the PaymentExpress Checkout Widget, support for modern browsers capable of rendering iframe-based content.

In-Person Hosted Checkout

Hosted Checkout redirects cashiers to a secure PaymentExpress-hosted page to collect card information through a connected PIN pad.

Workflow Summary

  1. The cashier selects items in your system of record.
  2. Your system of record creates a cart handoff to PaymentExpress via API
  3. The cashier is redirected to the PaymentExpress hosted checkout page to activate the PIN pad.
  4. The customer completes payments at a PIN pad.
  5. Receive a postback or return notification with final payment details.

Requirements

  • Ability to make authenticated HTTPS API calls to PaymentExpress.
  • No client-side or browser integration required.

Comparison Summary

FeatureEmbedded CheckoutHosted Checkout
Integration StyleIntegrated into the your application, either through an embedded widget (using an iframe) or a direct PIN pad integrationRedirect to a PaymentExpress-hosted page.
Cashier ExperienceStays inside your application for a seamless, integrated workflow.Simple, familiar, and externally hosted by PaymentExpress.
PCI ExposureNone – PaymentExpress collects and stores all payment data.None – PaymentExpress collects and stores all payment data.
Implementation ComplexityModerate to High – requires front-end work to embed the widget and/or API coordination.Low – API-only integration.
Ideal Use CaseWhen a fully integrated cashier experience is the priority.When quick implementation and simplicity are the priorities.

Choosing Between Solutions

Embedded In-Person Checkout offers the most control over the cashier experience, but it requires front-end integration and/or widget event handling.

However, the Hosted Checkout streamlines implementation, making it an ideal solution for teams that prioritize speed and simplicity.


Did this page help you?