Adyen Terminal API

Name: Adyen Terminal API
Brand: Adyen Terminal API
Availability: InStock

✓ Official Vendor SpecPaymentsPos TerminalapiKey, basic19 EndpointsREST

Install Jentic One Beta

Connect the Adyen Terminal API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Adyen Terminal API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Adyen Terminal API.

Initiate an in-person card payment via POST /payment with the SaleToPOIRequest envelope and PaymentRequest body

Reverse an in-flight or completed payment via POST /reversal using the original transactionID

Run end-of-day totals and reconciliation via POST /reconciliation and POST /gettotals

GET STARTED

Start building with Adyen Terminal API

Explore with Jentic

View OpenAPI Document

For Agents

Drive in-person payments and POS interactions on Adyen terminals — accept payments, refunds, loyalty, stored-value, displays, prints, and reconciliation.

Use for: Take an in-person card payment on an Adyen terminal, Reverse a card payment that was just taken at the till, Print a custom receipt on a Pax or Verifone terminal supplied by Adyen, Display a prompt on the terminal screen and capture the cashier's input

Not supported: Does not handle online card-not-present payments, terminal hardware ordering, or merchant onboarding — use only for driving payments and POS interactions on Adyen-supplied terminals.

The Adyen Terminal API is the JSON message protocol for in-person payments and point-of-sale interactions on Adyen-supplied terminals. The 19 endpoints cover the full POS lifecycle: login and logout, payment, card acquisition, loyalty, stored value, reversal, reconciliation, totals reporting, balance inquiry, transaction status, abort, diagnosis, and direct device interactions such as display, input, print, and card-reader APDU. Both synchronous and asynchronous transport modes are supported, and the same protocol is used for cloud and local terminal integrations.

Use Cases

Patterns agents use Adyen Terminal API for, with concrete tasks.

★ In-Person Card Payment at the Till

A POS application sends a SaleToPOIRequest containing a PaymentRequest to POST /payment. The terminal prompts the shopper to tap, dip, or swipe; runs PIN, signature, or contactless flows as required; and returns a SaleToPOIResponse with the result. The same call handles EMV, magstripe, contactless, and mobile wallets, as well as gratuity and split tender. Synchronous mode waits for the result on the HTTP call; asynchronous returns immediately and pushes the result to a configured webhook.

Send a SaletoPOIRequest to POST /payment with MessageHeader.SaleID, MessageHeader.POIID, and a PaymentRequest body containing PaymentTransaction.AmountsReq and currency

Reversals and End-of-Day Reconciliation

A cashier can void the immediately previous transaction with POST /reversal, passing the original transactionID, before the shopper leaves the till. At end-of-day, POST /reconciliation totals all transactions for the period and POST /gettotals returns the figures the till expects to match against the cash drawer. Both endpoints are part of the same SaleToPOI envelope used for payments, keeping operational tooling on a single transport.

Send a SaletoPOIRequest to POST /reversal with the OriginalPOITransaction.POITransactionID matching the previous payment transactionID

Custom Display and Input on the Terminal

Retailers running cashier-prompt flows (loyalty enrolment, age check, signature on screen) use POST /display to render text or buttons on the terminal screen, then POST /input to capture the cashier's or shopper's response. POST /print pushes a custom receipt to the terminal printer for warranty terms, marketing inserts, or legal disclosures. POST /cardacquisition acquires card data without authorising a payment, useful for loyalty enrolment or tokenisation.

Send a SaletoPOIRequest to POST /display with a DisplayRequest containing OutputContent.PredefinedContent and OutputText for each line

AI Agent POS Operations via Jentic

An ops agent monitoring store reconciliations searches Jentic for 'run Adyen terminal reconciliation', loads the schema for /reconciliation, and triggers it for each store at close-of-business. The agent receives the totals payload, compares to the till's expected figures, and flags discrepancies in the operations dashboard. Jentic injects X-API-Key and the SaleID/POIID context per store from its encrypted vault.

Search Jentic for 'run Adyen terminal reconciliation', load the reconciliation schema, then execute one call per store at close-of-business and compare totals to till figures

Key Endpoints

19 endpoints — the adyen terminal api is the json message protocol for in-person payments and point-of-sale interactions on adyen-supplied terminals.

METHOD

PATH

DESCRIPTION

POST

/payment

Take an in-person payment

POST

/reversal

Reverse a previous payment

POST

/reconciliation

Run end-of-day reconciliation

POST

/gettotals

Pull terminal totals

POST

/transactionstatus

Query the status of a prior transaction

POST

/cardacquisition

Acquire card data without payment

POST

/display

Display content on the terminal screen

POST

/print

Print a receipt on the terminal

POST

/payment

Take an in-person payment

POST

/reversal

Reverse a previous payment

POST

/reconciliation

Run end-of-day reconciliation

POST

/gettotals

Pull terminal totals

POST

/transactionstatus

Query the status of a prior transaction

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your Adyen Terminal X-API-Key and basic auth credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'take an in-person payment' or 'run a terminal reconciliation', and Jentic returns the matching Terminal operation with its SaleToPOIRequest schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Adyen Terminal API through Jentic.

What authentication does the Adyen Terminal API use?

Cloud Terminal API requests are signed with an API key in the X-API-Key header (ApiKeyAuth); HTTP Basic auth (BasicAuth) is also supported, as declared in the spec. Local terminal integrations use a different transport that goes directly to the terminal's IP address. Through Jentic, the cloud credential is held encrypted in the vault and only a scoped token is exposed to the agent.

Can I take an in-person payment with the Adyen Terminal API?

Yes. POST /payment accepts a SaleToPOIRequest envelope containing a PaymentRequest body with the amount, currency, and SaleID/POIID identifiers. The terminal handles tap, chip, and contactless flows; the response carries the SaleToPOIResponse with the result and any printed receipt content.

Does the Terminal API support synchronous and asynchronous modes?

Yes. Both transport modes are documented in the API description: synchronous responses use https://terminal-api-test.adyen.com/sync and asynchronous responses use https://terminal-api-test.adyen.com/async, with results pushed to a configured webhook in async mode. Choose async for long-running flows such as signature capture; choose sync for simple tap-and-go.

How do I run end-of-day reconciliation through Jentic with the Adyen Terminal API?

Search Jentic for 'run Adyen terminal reconciliation', load the reconciliation schema, then execute with the SaleID, POIID, and a ReconciliationRequest specifying the period. Jentic injects X-API-Key from the encrypted vault. Get an account at https://app.jentic.com/sign-up.

What are the rate limits for the Adyen Terminal API?

Adyen does not publish a fixed numeric rate limit for Terminal in the spec; throughput is bounded by the terminal hardware itself for sync flows. For cloud transport, contact Adyen support if you receive 429 responses on a busy estate of terminals.

Can I print a custom receipt or display a prompt on the terminal?

Yes. POST /print accepts a PrintRequest with output content for the terminal printer; POST /display accepts a DisplayRequest with text and predefined content for the terminal screen. POST /input collects the cashier's or shopper's response from the screen, which is useful for cashier-prompt flows like loyalty enrolment or age verification.

Adyen Terminal API

Connect the Adyen Terminal API to your agent

Capabilities

Start building with Adyen Terminal API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs