In-person payments

Overview

What we support

Solutions

Locations and languages

Payment methods

Add payment methods

Manage payment methods

Terminals

Get started

Integration overview

Integration checklist

Go-live checklist

Design your integration

Account

Automate store management

Configure features

Local or cloud communications

Building a local integration

Protect with a library

Protect with your own code

Building a cloud integration

Network and connectivity

Network configuration

Wi-Fi profiles

Cellular connection

Bluetooth beacons

Bluetooth PAN and tethering

Bluetooth base station

Networking issues

End of 2G/3G network coverage

Terminal API

Notifications and webhooks

Display notifications

Tender states

Event notifications

Platform-generated webhooks

Implement the payment flow

Make a payment

Greece tax regulations

Pass application information

Cancel an in-progress transaction

Generate receipts

Refund a payment

Referenced refund

Unreferenced refund

Cancel unreferenced refund

Outcome of a refund

Verify transaction status

Handle responses

Refusal reasons

Raw responses

Penalty box

Time-outs

Test your integration

White-green Adyen POS test card

Blue-green Adyen POS test card

White Adyen POS test card

B2 test cards

Diagnostics

Make a diagnosis request

Check the cloud connection

Add payment features

Add information to a payment

Use tender options

SaleToAcquirerData

Alternative payment methods

Brazil meal vouchers

Gift cards

Activate

Make a payment

Check balance

Load funds

Undo a load transaction

Refund

Deactivate or cash out

One-time numeric code payments

QR code wallet payments

Capture

Card application selection

Cardholder Verification Methods

Cashback

Donations

Dynamic Currency Conversion

View the DCC dashboard

Installments

Brazil

Japan

Mexico

Mail Order/Telephone Order

AVS responses for point of sale

Manual Key Entry

Offline payments

Partial authorizations

Payment facilitators

Reconciling totals

Log in and log out

Retrieve totals from the terminal

Reconcile a balance mismatch

Risk management

Surcharge

Configuration-based surcharge

Dynamic surcharge

Tipping

Tipping from the POS app

Tipping from the terminal

Override tipping options

Override the amount to tip on

Tipping on the receipt

Tokenization

Add advanced flows

Authorization adjustment

Autonomous stores

Card acquisition

Identifiers

Insights

Card recognition

Card-based identification

Card check before refund

Tax-free shopping

Custom cards

Loyalty

Card and shopper identifiers

Wallet passes

NFC tags reading and writing

Pay at table

Quick chip

Shopper engagement

Create a flow

Display data on the terminal

Show a QR code

Show a receipt

Show an image

Show the standby screen

Get input on the terminal

Confirmation

Signature

Multiple choice—single answer

Multiple choice—multiple answers

Digit

Amount

Phone number

Rating

Rating—single key press

Text

Cancel collecting input

Print data on the terminal

Third-party interactions

STANDALONE TERMINALS

Standalone solution

Build a standalone solution

Integration checklist

Go-live checklist

Standalone setup

Use a standalone terminal

Terminal management

Get started manuals

Verifone Engage terminals

e280

e285p

M400

P400 Plus

UX300

UX410

V210

V240m Plus

V400c Plus

V400m

V400m with Bluetooth base

Android terminals

AMS1

M450

P630

S1E

S1E2L

S1E4Pro

S1F2

S1F4Pro

S1U2

SFO1

Card readers

NYC1

NYC1 with NYC1 dock

Legacy terminals

Deprecation of eVo terminals

e315 user manual

Inspect device security

Charging the e315

Install an iPod or iPhone

Turning it on and off

Board the terminal

Use the Admin menu

Understand the LED colors

Troubleshooting and Support

e355 user manual

Inspect device security

Charging the e355

Turning it on and off

Connect to your network

Board the terminal

Use the Admin menu

View device info

Attach and use the e355 frame

Attach a tablet to the frame

Attach the e355 to the frame

Remove a tablet from the frame

Remove the e355 from the frame

Connect the e355 frame to a power source

Make a payment over Bluetooth

Step 1- Clean the Bluetooth configuration

Step 2 - Pair the e355 with a mobile device

Step 3 - Start a transaction

Remove configuration and reboard

Troubleshoot the Bluetooth connection

Understand the LED colors

Troubleshooting and support

MX925 user manual

Inspect device security

Board the terminal

Use the Admin menu

View device info

Troubleshooting and support

VX675 user manual

Inspect device security

Turning it on and off

Connect to your network

Install or replace paper rolls

Board the terminal

Use the Admin menu

View device info

Make special payments

Print transaction totals

Perform a Refund

Troubleshooting and support

VX680 user manual

Inspect device security

Charging the VX680

Turning it on and off

Install or replace paper rolls

Connect to your network

Board the terminal

Use the Admin menu

View device info

Make special payments

Perform a Refund

Print transaction totals

Troubleshooting and support

VX690 user manual

Inspect device security

Install or replace paper rolls

Connect to your network

Board the terminal

Connect to a base station with Bluetooth

Understand the Bluetooth base station LED colors

Use the Admin menu

View device info

Make special payments

Perform a Refund

Print transaction totals

Troubleshooting and support

VX820 user manual

Inspect device security

Board the terminal

Use the Admin menu

View device info

Troubleshooting and support

VX820 Duet user manual

Inspect device security

Install or replace paper rolls

Board the terminal

Use the Admin menu

View device info

Make special payments

Perform a Refund

Print transaction totals

Troubleshooting and support

Menus and passcodes

Android terminals

App requirements

App deployment

Upload apps and certificates

Deploy using API requests

Deploy using profiles

Deploy using Customer Area

Accessibility

Accessibility from the POS app

Accessibility from the terminal

Barcode scanning

Button activated scan

API single scan

API batch scan

Kiosk mode

Remote troubleshooting

Theme customization

Manage your terminal fleet

Order, return, or replace terminals

Do a security inspection

Assign terminals

Board the terminal

Customize terminal settings

Manage battery power

Maintain performance

Automate terminal management

Order terminals

Assign terminals

Configure terminals

Troubleshooting terminals

Run connection tests

Run hardware tests

Mobile solutions

What we support

Android Mobile solutions

System requirements

Security

Checklists

Understand the solutions

Build your solution

Tap to Pay on Android

Card reader on Android

Android Payments app

Manage your solution

Error handling

iOS Mobile solutions

System requirements

Security

Checklists

Understand the solutions

Build your solution

Tap to Pay on iPhone

Card reader on iOS

Manage your solution

Error handling

Releases

Update to a new release

Manually schedule updates

Sneak peek

Release notes

Classic integrations

Deprecation of classic libraries

Library integrations

Network configuration

Java Native Interface integration

Legacy documentation

Get started with the Java Native Interface

Calls and callbacks

Key steps

Initialize the library

Logging

Register the application with Adyen

Registering the PED

Register the PED with Adyen

Register the PED with Adyen using a StoreID

Process a basic transaction

Create the tender

Pass tender options

Handle and extract data from Callbacks

Handle the Signature callback

Handle the Additional Data callback

Handle the Print Receipt callback

Handle progress events

Handle the final state callback

Query the PED object for device information

Determine the current and final tender state

Cancel or refund a transaction

Cancel a transaction

Refund a completed transaction

Refund a transaction from the POS

Partially refund a balance

Refund a balance to a card

Exit the library

Extras

Start Alipay and WeChat Pay transactions

Handle Dynamic Currency Conversion

Handle the PED Exception Callback

Get transaction data from TxStoreReport

Display a screen on a large screen terminal

Start gift card transactions

Manual Keyed Entry and passing of card details

Override the card mask

Activate a gift card

Tip from a gift card

Cash out a gift card

Deactivate a gift card

Refund a balance to a gift card

Cashback or cashout from a card

COM extension for Windows integration

Legacy documentation

Get started with the COM extension for Windows

Reference the Adyen COM Object to a .NET project

Pass variables with the Adyen.POS service and COM

Calls and callbacks

Key steps

Initialize the library

Library flags

Register the application with Adyen

Set cash register application details

Registering the PED

Register the PED with the Adyen payments platform

Register the PED with Adyen using a StoreID

Process a basic transaction

Create the tender

Pass tender options

Handle and extract data from Callbacks

Handle the Signature callback

Handle the Additional Data callback

Handle the Print Receipt callback

Handle the final state callback

Handle progress events

Determine the current and final tender state

Cancel or refund a transaction

Cancel a transaction

Refund a transaction from the PED

Refund a transaction from the POS

Partially refund a balance

Refund a balance to a card

Exit the library

Extras

Start Alipay and WeChat Pay transactions

Handle Dynamic Currency Conversion

Handle the Exception Callback

Handle the LibraryLog callback

Query the PED object for device information

Get transaction data from TxStoreReport

Display a screen on a large screen terminal - COM

Start gift card transactions

Manual Keyed Entry and passing of card details

Override the card mask

Activate a gift card

Tip from a gift card

Cash out a gift card

Deactivate a gift card

Refund a balance to a gift card

Cashback or cashout from a card

COM Extension for Windows - Objects

AdditionalData

AppInfo

PedDevice

POS

Receipt

Receipts

Tender

TenderOption

TxStoreReport

pspResultObj

CancelOrRefundObj

C library integration

Legacy documentation

Get started with the C library

C library process flow

Calls and callbacks

Implement callbacks

Implement callbacks with register_device_request

Key steps

Initialize the library

Register the application with Adyen

Register the PED with the Adyen payments platform

Process a basic transaction

Create the tender

Handle the Signature callback

Handle the Additional Data callback

Handle the Print Receipt callback

Handle the PED State Change callback

Handle progress events

Handle the final state callback

Cancel or refund a transaction

Refund a balance to a card

Cancel a transaction

Refund a transaction from the PED

Refund a transaction from the POS

Partially refund a balance

Exit the Library

Extras

Start Alipay and WeChat Pay transactions

Enable third party sharing

Handle Dynamic Currency Conversion

Get transaction data from tx_store_report - C

Display a screen on a large screen terminal - C

Start gift card transactions

Manual Keyed Entry and passing of card details

Override the card mask

Activate a gift card

Tip from a gift card

Cash out a gift card

Deactivate a gift card

Refund a balance to a gift card

Cashback or cashout from a card

Structs

additional_data_struct

balance_inquiry_request

cancel_or_refund_request

cancel_or_refund_on_terminal_request

cancel_or_refund_on_terminal_response

card_operation_request

create_tender_request

create_tender_response

echo_struct

final_strct

init_library_request

load_request

ped_device_info

receipt_line

receipt_set

receipt - C library

receipts_strct

refund_request

register_app_request

register_app_response

register_device_request

response_header

show_screen_request

show_screen_response

special_tender_request

tx_store_query_request

tx_store_query_response

tx_store_report

ADYEN_RESULT

iOS integration

Get started with the iOS integration

Use the library in a custom application

Update library sources

Key steps

Set the integratorName - iOS

Log in

Register a device

Board a device

Process a basic transaction

Make a payment

Handle signatures

Handle additional data

Handle receipts

Handle referrals

Handle transaction state changes

Handle the final state

Pass tender options - iOS

Cancel or refund a transaction

Check the status of a refund

Extras

Handle the Dynamic Currency Conversion delegate

Make an Alipay or WeChat Pay payment - iOS

Start gift card transactions - iOS

Fetch transaction data

Android integration

Download the library and example application

Add the Adyen library module as a dependency

Install and integrate the Android library

Migrate to Android 1.21.2 and later

Create a recurring contract

Handle signatures

Partial authorization

Shopper recognition

Use cases and process flows

Transaction flows

Use case: Registration

Use case: Sale transaction

Use case: Sale transaction with loyalty

Use case: Sale with Dynamic Currency Conversion

Use case: Refund

EMV Refund flows

Use case: Automatic recovery

Use case: Manual recovery

Home In-person payments ... Java Native Interface integration Legacy documentation

Legacy documentation

View source

This document applies for library version 1.13.

Company

About Adyen
Careers
Contact

Resources

Academy
Knowledge Hub
Help

Developers

Example integrations
Developer newsletter
Release notes
llms.txt

Legal

Licenses
Terms & Conditions

Privacy
Cookies
Disclaimer
© 2026 Adyen