At ValPay, we leverage Adyen as our underlying payment processing platform. Below is a structured overview of the relevant documentation and resources, aligned with your requested priorities, including both ValPay-specific guidance and Adyen’s official technical documentation.
Priority 1: API Documentation
ValPay Overview (Recommended Starting Point)
This page outlines how ValPay leverages Adyen, including supported flows and high-level architecture:
Adyen API Reference
Comprehensive API reference covering REST endpoints, request and response schemas, and error codes for Payments, Checkout, and Management APIs:
Authentication
Adyen uses API key-based authentication with role-based permissions per environment:
https://docs.adyen.com/development-resources/api-credentials (we will be sharing the keys with you as soon as the account is set-up)
Integration Guides and Quick Start
End-to-end payment flow documentation:
Webhooks and Notifications
Documentation covering available events, payload schemas, and HMAC signature verification:
Priority 2: Sandbox and Testing
Test Environment
We will provide you with a full-featured sandbox environment that mirrors production behavior, including test API credentials and a dedicated test merchant account:
Test Cards and Scenarios
Test card numbers and scenarios for approvals, refusals, incremental authorizations, partial captures, and refunds:
Go-Live and Certification
We provide you with a house account to perform Go-Live testing once everything is finalized on Test.
Priority 3: Core Payment Features
Adyen provides native support for flexible transaction flows, including:
Pre-authorization with estimated amounts
Incremental authorization for additional charges during a guest’s stay
Delayed capture with final amount at checkout
Partial capture and partial refund
Card-on-file tokenization for no-shows and post-checkout charges
These flows support hospitality indicators and lodging-specific data fields where applicable.
Priority 4: Frontend and Terminal Integration
Hosted Checkout and Embedded Components
Options include hosted payment pages and embedded checkout components.
JavaScript SDK
Adyen Web Components allow secure handling of card data while maintaining full control over the user experience:
POS and Terminal Integration
Documentation covering supported terminal hardware, terminal APIs, SDKs, and provisioning processes: