Valpay

Technical resources for integrated partners.

Integrations & API's

Quick Intro on integrating with Valpay and Adyen

Getting Started

Understand what Adyen is and how it works from a developer perspective. Learn the core concepts, APIs, payment flows, and components used to integrate and process payments securely within your…

What is Adyen

Learn how Adyen is used within Valpay for payment processing. Understand the integration model, developer responsibilities, and how Valpay complements Adyen with additional APIs beyond the core payment flow.

How Adyen is used within Valpay

Introduction

Learn how to set up your Adyen account for use with Valpay. Request a Valpay-provisioned test account, understand why direct Adyen accounts won’t work, and get access to a house…

Adyen Account Setup

Learn how to securely use and manage your Adyen API credentials within Valpay. Understand how credentials are provided, how to store them safely, and best practices to avoid disruptions in…

API Credentials

Prerequisites

Build and validate your Adyen integration safely using the test environment. Simulate payments, test flows, and verify webhooks without processing real transactions.

Test Environment

Process real payments using Adyen’s live environment. Learn when to switch, what changes in production, and how to ensure your integration is ready for real customers.

Live Environment

Follow a step-by-step guide to move your integration to production. Configure live URLs, credentials, and webhooks to start processing real payments securely.

Going Live

Learn how to configure, switch, and go live with Adyen environments safely.

Environments

Build your first Adyen payment using the Web Drop-in. Learn how to create a session, integrate the frontend, and process a test transaction end-to-end within your application.

Make Your First Payment

Validate your payment integration end-to-end. Test success, failures, 3D Secure flows, and ensure webhooks are working correctly before moving to production.

Verify the Integration

Quick Start

A technical roadmap for ValPay’s Adyen integration, covering APIs, testing, and specialized hospitality payment workflows.

💳 ValPay Payment Integration Guide: Powered by Adyen

Online payment integrations for accepting card and alternative payment methods in web and mobile applications using ValPay-supported payment providers.

Online Payments

Understand how online payments work with Valpay and Adyen: the integration architecture, the server-side flows, supported payment methods, and how to choose an integration method.

Online Payments Overview

The categories of payment methods you can accept through Valpay and Adyen, and how the methods available for each transaction are determined.

Supported Payment Methods

How the parts of an online payments integration fit together: your server, your client, the Adyen Checkout API, and webhooks.

Architecture Overview

Overview

The end-to-end sequence of a typical online payment with Valpay and Adyen, using the recommended Sessions flow.

Standard Payment Flow

Compare Adyen's two server-side flows so you can choose the right integration for your payments.

Sessions vs Advanced Flow

How authorization reserves funds and capture moves them, including automatic, delayed, and manual capture.

Authorization and Capture

The states a payment moves through, and why the webhook, not the synchronous result code, carries the authoritative outcome.

Payment Lifecycle States

Different Payment Flows and when to use them

Payment Flow

Create and share payment links using Adyen to collect payments without a full checkout. Learn how to generate links, handle customer payments, and process results securely using webhooks.

Pay by Link

Redirect shoppers to an Adyen-hosted payment page, the lowest-effort and lowest-PCI-scope way to accept online payments with Valpay.

Hosted Checkout

Use Adyen Drop-in, a single prebuilt UI component that renders every enabled payment method and handles the full payment flow.

Drop-in Integration

This guide explains how to integrate ValPay/Adyen using the Adyen Web Drop-in component. It is language-agnostic and provides pseudocode and field explanations to help you implement the integration in any…

Drop-in Integration Step by Step Guide

Place individual Adyen payment-method Components into your own checkout layout for more control than Drop-in, using the same session-based model.

Components Integration

Build your own checkout UI and call the Adyen Checkout API directly with the Advanced flow, the option with the most control and the highest PCI scope.

API Integration

Integration Methods

How to accept credit and debit card payments through Adyen, including the Card Component and the brands configuration you need to recognize schemes such as Discover.

Card Payments

What Apple Pay is, its high-level requirements, and how it works through Adyen Drop-in and Components.

Apple Pay

What Google Pay is, its high-level requirements, and how it works through Adyen Drop-in and Components.

Google Pay

How redirect payment methods work, where the shopper authorizes at a bank or provider and returns to your returnUrl, with the final outcome confirmed by webhook.

Redirect Methods

An overview of local and alternative payment methods available through Adyen, how availability varies by market and account, and how they integrate through Drop-in and Components.

Alternative Payment Methods

Payment Methods

How 3D Secure 2 adds an authentication step to card payments, how it relates to PSD2 SCA, and how your Adyen integration handles it.

3D Secure 2 and Strong Customer Authentication (SCA)

How PCI DSS applies to card data in your integration, why Hosted Checkout, Drop-in, and Components reduce your scope, and good practices to follow.

PCI Considerations

Security & Compliance information and guides

Security & Compliance

How to build a structured test plan that exercises the full payment lifecycle, including 3D Secure 2 and failures, before going live.

Simulating Scenarios (3DS, failures)

Adyen test card numbers for validating your online payments integration, and how to use them.

Test Cards

How to test your online payments integration in the Valpay and Adyen test environment before going live.

Testing Online Payments

Testing

Documentation for accepting and managing in-person (card-present) payments using ValPay, including terminals, Tap to Pay, and mobile POS integrations.

In Person Payments

How card-present payments work with Valpay and Adyen, where shoppers pay on a physical Adyen terminal driven by your point-of-sale app.

In-Person Payments Overview

The components of an in-person integration and the two ways your POS app can communicate with an Adyen terminal: cloud and local.

How to make an in-person payment with Adyen's Terminal API, from the SaleToPOIRequest your POS app sends to the response and confirming webhook.

Terminal API Payment Flow

The states an in-person payment moves through, from terminal authorization and the confirming webhook to capture, refunds, and reversals.

Payment Lifecycle

Accept in-person contactless card and wallet payments directly on a supported phone or tablet, with no separate payment terminal.

Tap to Pay Overview

Tap to Pay

Tap to Pay on Android (TTPOA) allows merchants to accept contactless card and wallet payments directly on NFC-enabled Android devices without requiring a dedicated payment terminal.

Known constraints of Tap to Pay on Android, including contactless-only acceptance, device requirements, and PIN handling.

Limitations

Learn the device, Android OS, and Adyen account requirements needed to enable Tap to Pay on Android, including supported hardware, API credentials, and merchant configuration.

Tap to Pay on Android Requirements

Overview of integrating Tap to Pay on Android with Adyen, including both Mobile SDK integration and the Adyen Payments App approach for accepting contactless payments on NFC-enabled Android devices.

Tap to Pay on Android Integration

Documentation for integrating and using Tap to Pay on Android (TTPOA) with ValPay and Adyen, enabling NFC-enabled Android devices to accept contactless payments without a dedicated payment terminal.

Tap to Pay on Android

What webhooks are, why they are essential to your Adyen integration, and how the rest of this section is organized.

How to receive, acknowledge, and process Adyen webhooks correctly, including idempotency and out-of-order delivery.

Handling Webhooks

The Standard webhook is the main webhook for payment lifecycle events, including how to set it up and what each notification contains.

Standard Notifications

The common eventCode values your server should handle, grouped by payment lifecycle and disputes.

Event Types

How to secure webhooks with HMAC signature verification, basic authentication, and IP allowlisting.

Security (HMAC Validation)

Webhooks

How Adyen tokenization stores a shopper's payment details so you can charge them again for subscriptions, card-on-file, and recurring billing.

Tokenization & Recurring Payments

How to capture or refund less than the full amount of a payment, including single and multiple partial captures and partial refunds.

Partial Captures & Refunds

Handle payments where the final amount is unknown up front by pre-authorizing, adjusting the authorized amount, and capturing the final total.

Multi-step Payments

Advanced Topics

Learn how to make your first ValPay API request in minutes. This guide covers obtaining an API key, choosing an environment, authenticating requests, and retrieving your first data from the…

Quickstart

Understand what the ValPay API provides, how it is structured, and the types of data available. This page explains the API’s purpose, common use cases, and its primarily read-only design.

API Overview

Learn how to request an API key from ValPay support and how keys are issued for partners or merchants. This guide also explains how to securely store and manage your…

Getting an API Key

Learn about the available ValPay API environments. This page explains when to use the test environment for development and when to switch to the production environment.

All API requests must include a valid API key. This guide explains how to authenticate requests using the x-api-key header and how authentication errors are handled.

Authentication

Explore the main API endpoint groups including transactions, deposits, disputes, merchants, stores, statements, and branding configuration.

Endpoints Overview

Many endpoints support advanced filtering using MongoDB Query Language (MQL). This page explains how to build filter queries to retrieve specific data from the API.

Filtering

Understand how the API communicates errors using standard HTTP status codes and how your integration should handle authentication issues, invalid requests, and server errors.

Error Handling

Best practices for building reliable ValPay API integrations, including secure API key usage, pagination tips, and error handling. Also learn where to find the latest API documentation and how to…

Best Practices & Support

Documentation for integrating with the ValPay API, including authentication, endpoints, filtering, and transaction updates.

ValPay API & Developer Guide

Troubleshooting Failed Webhooks in Adyen

Understand why you receive AUTHORISATION webhooks but no CAPTURE notifications. Learn how capture configuration (automatic vs manual) affects webhook behavior and how to enable capture events correctly.

Missing CAPTURE Webhooks

This guide explains how missing brands configuration can prevent certain card schemes from working and shows how to update your component so Discover and other supported cards are accepted.

Discover (or Other Card Brands) Not Accepted in Adyen Web Card Component

Troubleshooting

Reporting Portal

PCI Compliance

Find answers and get help from Intercom Support and Community Experts

Conversations you've started through the messenger will appear here.

No conversations created by you

Try using different keywords or checking for typos.

No conversations found

Title

This site employs cookies and other technologies that we and our third party vendors use to monitor and record personal information about you and your interactions with the site (including content viewed, cursor movements, screen recordings, and chat contents) for the purposes described in our Cookie Policy. By continuing to visit our site, you agree to our {websiteTermsLink}, {privacyPolicyLink} and {cookiePolicyLink}.

This site uses cookies and similar technologies ("cookies") as strictly necessary for site operation. We and our partners also would like to set additional cookies to enable site performance analytics, functionality, advertising and social media features. See our {cookiePolicyLink} for details. You can change your cookie preferences in our Cookie Settings.

We use cookies to make our site work and also for analytics and advertising purposes. You can enable or disable optional cookies as desired. See our {cookiePolicyLink} for more details.

Advertising cookies are set by our advertising partners to collect information about your use of the site, our communications, and other online services over time and with different browsers and devices. They use this information to show you ads online that they think will interest you and measure the ads' performance. Social media cookies are set by social media platforms to enable you to share content on those platforms, and are capable of tracking information about your activity across other online services for use as described in their privacy policies.

These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.

These cookies are necessary for the website to function and cannot be switched off in our systems.

These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site.

You have the right to opt out of the sale of your personal information. See our {cookiePolicyLink} for more details about how we use your data.

Your Privacy Choices

We use cookies to enhance your experience. You can customize your cookie preferences below. See our {cookiePolicyLink} for more details.

Cookie Settings

Empty Help Center

Uh oh. That page doesn’t exist.

Home

Search results

Disappointed

Neutral

Smiley

Thinking...

Searching through sources...

Analyzing...

Tickets submitted through the messenger or by a support agent in your conversation will appear here.

No tickets created by you

No tickets found

Track the progress of all tickets and conversations related to your company.

Customer Portal.

Track the progress of all tickets related to your company.

Tickets portal.

{assigneeName} needs more information from you

Tickets

No access to tickets portal

Search

Skip the search. Describe what you’re trying to do and get a grounded answer.

Browse articles and guides in this topic.

Create your workspace and invite the people you work with.

Set up your account

Build your first workflow and watch it run end to end.

Ship something

Connect the tools your team already uses to bring data in.

Connect your stack

A quick lap of the product so you know where everything lives.

{appName} in 60 seconds

This prototype demo is aware that you are reading “{title}”. It can point you back to the current article, but a production article-aware Fin contract is still follow-up work.

Prototype article-aware answer

Because you already asked about invitations, this prototype demo can add the follow-up: use the role selector before sending each invite to limit access to the teammate responsibilities.

Prototype role-limiting follow-up

This prototype demo suggests starting with your workspace profile, inviting the team members who need access, and then connecting the integrations you use.

Prototype getting-started answer

In this prototype demo, integrations are configured from workspace settings. Choose the integration, connect the account, and review the enabled permissions.

Prototype integrations answer

In this prototype demo, invite teammates from workspace settings, then choose the access each teammate needs before sending the invitation.

Prototype invite-team answer

This prototype demo does not have a scripted answer for that question yet. Try asking how to invite your team or open a source article. No production Fin API was called.

Prototype answer unavailable

I’ve got this page open. Ask me anything about it and I’ll answer from the docs.