Integration steps
Set up your account for in-person payments
Contact Dintero to enable In-Person Payments on your account. You need a payout destination (the merchant entity that receives funds) with completed KYC verification.See Terminal onboarding for the full setup process.
Register a store and terminal
In Backoffice, create a store linked to your payout destination, then register a terminal to the store. Each terminal gets a unique ID that you reference when creating sessions.You’ll need three identifiers for every terminal payment:
| Identifier | What it is |
|---|---|
payout_destination_id | The merchant entity receiving funds |
store.id | The physical store location |
terminal_id | The specific payment terminal |
Create a payment profile
Create a payment profile with Seitatech In-person enabled. You can enable it on its own, or alongside other payment methods on the same profile.
Create a terminal session
Send a
POST to /v1/sessions-profile with the order details and the store/terminal identifiers. There is no hosted checkout page.Include order.store.id, order.store.terminal_id, and order.store.payout_destination_id in your request, and reference your in-person payment profile with profile_id.Add a publish push/terminal configuration to the session request to auto-initiate the payment on the terminal.See Create a terminal session for the full payload.Customer pays on the terminal
The terminal prompts the customer to tap, insert, or swipe their card. Dintero auto-captures terminal payments by default, so the transaction moves directly to
CAPTURED on success.Handle the result
Receive the transaction result via your
callback_url and webhooks. Manage refunds and voids through the standard Transactions API, just like online payments.What’s next
In-person overview
Detailed overview of how terminal payments work.
Terminal onboarding
Set up payout destinations, stores, and terminals.
Create a terminal session
Full payload reference and response handling.