Skip to main content
In-person payments let you charge a customer on a physical payment terminal using the same Checkout API you already use for online payments. You create a session, point it at a specific terminal, and the terminal prompts the customer to tap, insert, or swipe their card. The integration reuses your existing Checkout client, session profile, and transaction management. The only difference is that the order references a store and terminal, and the payment is completed on the terminal instead of in a hosted page.
In-person payments are powered by Seitatech and use the seitatech.in_person payment type. Backoffice shows this payment method as Card (Present). The two names refer to the same payment method. The terminals are physical card readers provisioned by Dintero.

​
How it works

1

Create a session

Send a POST to /v1/sessions-profile with your usual order details, plus order.store.id, order.store.terminal_id, and order.store.payout_destination_id. Enable Card (Present) on your payment profile and reference it with profile_id.
2

Terminal prompts the customer

Add a publish push/terminal configuration to the session request to auto-initiate the payment on the terminal.
3

Customer pays on the terminal

The customer completes the payment on the terminal. Dintero captures the transaction (auto-capture is the default for terminal payments).
4

Receive the result

Use your callback_url and webhooks to be notified when the transaction is authorized and captured. Manage refunds and voids through the standard Transactions API.

​
Prerequisites

Before you can take a payment on a terminal, you need:
  • An active Dintero account with In-Person Payments enabled.
  • A payout destination for the merchant of record. KYC must be completed.
  • A store linked to the payout destination.
  • A terminal registered to the store.
  • A Checkout API client with the checkout scope.
  • A payment profile that has Card (Present) enabled. See payment profiles.
See terminal onboarding for how to set up the payout destination, store, and terminal.
If you are a Dintero partner onboarding a new merchant, you can request in-person payments during the merchant invite flow. See Requesting in-person payments for a new merchant.

​
Identifiers you’ll use

The combination of these three values determines which physical terminal the payment is routed to.

​
What’s next

Onboard a terminal

Create a payout destination, register a store, and link a terminal.

Create a terminal session

Build the session payload, trigger the terminal, and handle refunds.
Last modified on August 5, 2026