Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing

GET STARTED

API DirectoryBrowse 10,000+ APIs ready for AI agent integrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI readiness using our scorecardArazzo UIVisualize Arazzo workflows as interactive documentationArazzo EditorBuild and edit multi-step API workflows visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
All ResourcesEverything in one placeBlogLatest articles and insightsTech Talk NewsletterAPIs, AI agents, architecture and strategyWebinarsLive sessions and on-demand recordingsReports & WhitepapersOriginal research on enterprise AI
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
All ResourcesBlogTech Talk NewsletterWebinarsReports & Whitepapers
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / Payments / Adyen / Adyen Terminal API
Adyen Terminal API logo

Adyen Terminal API

Browse all Adyen APIs
47
AI ReadinessFoundational (D+)47/100
See full scorecard
Official vendor OpenAPI document · agent-readyPaymentsPos TerminalapiKey, basic19 EndpointsREST

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.

Jentic One on GithubView OpenAPI Document

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.

1

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fadyen.com%2Fadyen-terminal" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fadyen.com%2Fadyen-terminal" | 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

Display custom prompts on the terminal via POST /display and collect input via POST /input

Process loyalty enquiries and redemption via POST /loyalty alongside the payment

Acquire card details for a non-payment use case via POST /cardacquisition

Print a custom receipt on the terminal via POST /print and abort a request via POST /abort

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

POST

/cardacquisition

Acquire card data without payment

POST

/display

Display content on the terminal screen

POST

/print

Print a receipt on the terminal

Jentic AI Readiness Score

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

A

Adyen Terminal API

- Foundational (D+)
47/100
99
Foundational Compliance
55
Developer Experience & Jentic Compatibility
30
AI-Readiness & Agent Experience
94
Agent Usability
30
Security
49
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
99

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A+Signals: 4
97%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

100%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

55

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: CSignals: 4
0%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

25%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

93%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

30

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: FSignals: 4
72%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

0%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

49%

Summary Coverage

Coverage of summaries across operations/tags/info.

94

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1
94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

30

Security

Trust, risk posture, and security compliance.

Grade: FSignals: 1
30%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

49

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: D+Signals: 1
49%

Descriptive Richness

Clarity and depth of descriptions across API elements.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Adyen Terminal API by hand means handling its X-API-Key or basic auth over cloud transport and assembling the SaleToPOIRequest envelope for each POS interaction. Through Jentic you install once, import the Terminal API from the API Directory, store the key once, and your agent calls it.

Permission scoping

The Terminal API takes the terminal and transaction details in the request body rather than a resource id in the URL path, so you limit the agent to the operations it needs, such as reading transaction status or running a reconciliation. Because you pick the operations, taking a payment or a reversal stays out unless you include it.

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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Adyen POS Terminal Management API

→

Manage the fleet of terminals that drive Terminal API requests

Use Terminal Management to assign terminals to stores and inspect their config; use Terminal API to drive transactions on those terminals

Alternative

Adyen Checkout API

→

Online (CNP) equivalent of the in-person Terminal API

Choose Checkout for online and unattended commerce, Terminal for attended in-person payments at a physical till

Complementary

Adyen Payment API

→

Server-to-server card payments used in classic integrations

Use Payment API for backend card-not-present authorisations and Terminal API for the in-store leg of the same merchant

Complementary

Adyen Management API

→

Manage merchant accounts and stores referenced by Terminal API requests

Use Management API to provision stores and merchant accounts; reference those identifiers from Terminal API SaletoPOIRequest envelopes

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 through Jentic One, the self-hosted execution layer.

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.

Can I limit what my agent is allowed to do with the Adyen Terminal API?

Yes. Because Jentic One is self-hosted, your own rules decide which Terminal API operations and credentials the agent may use, and you grant only the ones it needs, such as querying transaction status via POST /transactionstatus or running end-of-day totals via POST /reconciliation and POST /gettotals. The Terminal API passes the terminal and transaction details in the request body rather than a resource id in the URL path, so you scope access by choosing operations rather than paths. Since you pick the operations, sensitive calls like taking a payment with POST /payment or reversing one with POST /reversal stay out of the agent's reach unless you explicitly include them.

GET STARTED

Start building with Adyen Terminal API

Explore with Jentic One
View OpenAPI Document