Skip to main content
Sign in

Adyen Payments

Danielle
  • Updated

Table of Contents

Introduction

We’re excited to announce that Ordway now integrates with Adyen, a global leader in online payments. Adyen enables businesses to accept payments across multiple channels — including credit cards, debit cards, ACH, and Canadian payment methods — all through a single, secure platform.

With this integration, you can now process payments directly within Ordway, providing your customers with a fast, secure, and seamless checkout experience. Adyen’s advanced fraud protection, real-time reporting, and global reach make it an ideal solution for businesses looking to streamline their billing operations and improve customer satisfaction.

This integration not only simplifies payment collection but also reduces manual effort, enhances transaction visibility, and supports scalability as your business grows.

Prerequisites

Before you begin, ensure the following:

  • You have an active Ordway Admin account with access to Settings > Gateways.
  • You have (or can create) an Adyen Merchant Account.
  • You have permissions to manage API keys and credentials in Adyen.
  • You are familiar with basic payment gateway setup procedures in Ordway.

📝Note

 If you’re setting up Adyen for testing, use the Adyen test environment before switching to live.

Sign Up for an Adyen Account

You must have an Adyen account to connect it with Ordway.  This account gives you access to the Adyen dashboard and API credentials. Refer sign up for the test account. you get an email with a secure link to access the dashboard with username and password.

Environment Notes

Procedure

  1. Go to https://authn-test.adyen.com. The Adyen log in page appears. 
  2. Enter your credentials, then click Next. The Adyen Home page is displayed. 
  3. Once your account is approved, access your Adyen Customer Area (dashboard).

Connect Adyen with Ordway

Adyen’s test environment lets you safely simulate payment flows without using real funds.  You’ll need to generate API credentials that connect Adyen with Ordway.

  1. Log in to your Adyen Customer Area (Test): https://ca-test.adyen.com. 
  2. Navigate to Developers → API Credentials. Create or select an existing API Key.
  3. Copy the following details for Ordway setup: 
    • API Key
    • Merchant Account Name
    • Client Key (for frontend integrations)

⚠️Caution

 Do not use test credentials in a live environment. Doing so will cause payment failures.

Move to Live Credentials

After successful testing, switch to Adyen’s live environment to begin processing real payments.

  1. Log in to your Adyen Customer Area (Live): https://ca-live.adyen.com.

  2. Repeat the steps to create your API Key under: Developers → API Credentials.

  3. Create or copy the Live API Key, Merchant Account, and Client Key.

  4. Enter these live credentials into your Ordway Admin Settings.

  5. Change your environment from Test → Live.

💡Tip

 Review Adyen’s https://docs.adyen.com/online-payments/go-live-checklist/ before enabling live payments.

Verify Live Access

Validate that your Adyen–Ordway integration is working correctly with a live payment test.

  1. Perform a small test transaction (Example: $1). Refer Verify ACH Transactions – Ordway Support Portal
  2. Check the payment status in both Ordway and Adyen dashboards. 
  3. Confirm the payment is processed and settled successfully.

📝Note

 If your test transaction fails, verify your API key and merchant account mapping in both systems.

Configure Adyen Payments in Ordway

You can connect your Adyen account to Ordway to process payments using any combination of the following methods: Credit Card, ACH Bank Debit, and Canadian Bank Debit. Enable one or more options to match your business requirements.

Prerequisite

  • Ensure you have Adyen account credentials and the appropriate permissions in Ordway to configure payment gateways

Add Adyen Payments Gateway

  1. Log in to Ordway.

  2. In the left navigation pane, click (Setup) icon → Payments → Payment Gateways. 
    The Setup Electronic Payments page is displayed.

  3. If no payment gateway is configured, you are prompted to select a third-party provider 

  4. Select Adyen from the gateway list and click CONNECT.
    The Adyen dialog box is displayed.

  1. Complete the required fields in the Adyen dialog and click Connect. 

  2. The gateway is added and set by default.

  3. The interface updates to show gateway-specific controls such as Make Default and Manage. 

    a. To change the gateway configuration, click Manage for Adyen, then click Edit in the Adyen dialog and update settings as needed.

    b. Select one or more payment methods: Credit Card, ACH Debit, and/or Canadian Preauthorized Debits.
     
    c. Click Save.

📝Note

 When configuring Canadian Preauthorized Debits, you must also select ACH Debit, as both are currently linked.

Payment Methods

You can add or update payment methods on the Customer Details page in Ordway.

Add Payment Methods

  1. Create or open the Customer record. Refer Basics of Customer Accounts and Subscriptions – Ordway Support Portal 

  2. Set Payment Gateway to Adyen and click Save. 

  3. On the Customer Details page, click Add Payment Method and choose one of the following:

Add a Credit Card

  1. Enter required fields for Credit Card payment method: Card number, Expiry date, and Security code. Refer to the test card numbers to test your integration.

     
  2. Click Add Card. The card details are added and the confirmation message “The payment method successfully added” message appears. 

Add an ACH Debit Account

  1. Select the Bank Account Type from the list for ACH debit payment method. 
  2. Enter required fields: Account Holder Name, Account Number, and Routing Number in the respective fields.

Test ACH Data

Use the below bank account details to test ACH in the sandbox environment.

Account Number: 123456789

Routing Number: 011000138 or 121000358

Add a Canadian Preauthorized Debit (CPAD) Account

  1. Select the Bank Account Type from the list for Canadian preauthorized debit payment method. 
  2. Enter required fields: Account holder name, Account number, Institution number, and Transit number in the respective fields. 

  3. Click Add Bank. The bank details are added and the confirmation message “The payment method successfully added” message appears. 

Test CPAD Data

Use the below bank account details to test CPAD in the sandbox environment.

Option 1

Bank account number :123456789012

Bank location ID:16001

Bank code:621

Option 2

Bank account number :1234567

Bank location ID:00011

Bank code:001

Limitations

  • Account validation using Giact gVERIFY is only supported in the live environment.

  • To reduce costs, use Giact validation only for the shopper’s initial transaction and when the shopper updates their bank account information.

Ordway Status to Adyen Equivalents

Adyen Payment and Refund Status mapping and notes.

Ordway Status Adyen Status
Pending Received
Processed Settled, Scheduled Settled, Authorized, Submitted for settlement
Failed Error, Refused
Cancelled Cancelled
Failed. Reason - Time Out  Expired
Refund - Pending Sent for Refund
Refund - Processed Refunded

Webhooks Overview

Webhooks are user-defined HTTP callbacks that let one application notify another in real time whenever an event occurs, eliminating the need for polling and enabling instant data flow between systems.

How Webhooks Work

  • A third-party provider system exposes events and lets customers register a callback URL (the webhook endpoint).
  • When an event fires, the provider sends an HTTP request (usually POST with a JSON payload) to the registered URL.
  • The receiving service processes the payload and returns an HTTP status code to confirm delivery; providers often retry on non-success responses.

Create and Configure Adyen Webhook with HMAC

HMAC authentication enhances webhook security by validating request payloads using a shared secret. This replaces the earlier basic authentication method and ensures data integrity and authenticity.

Applies To

  • Adyen Webhooks
  • Ordway Gateway Integration
  • HMAC Authentication

Prerequisites

  • Access to the Adyen 
  • Access to Gateway Connect
  • Endpoint URL generated from Adyen Gateway
  • Required credentials (Account Name, Merchant Name, Client Key, API Key)

Before You Begin

  • Ensure you have copied the Endpoint URL from Gateway Connect.
  • Verify that you have permission to create webhooks in Adyen.

Create a New Webhook (HMAC Authentication)

  1. Navigate to Adyen Gateway Connect and copy the Endpoint URL. This URL will be used to receive webhook events.
  2. Log in to your Adyen.
  3. On the left navigation pane, click Developers.
  4. Click Webhooks. The Webhooks page is displayed.
  5. Click Create new webhook in the top-right corner.
  6. Select Standard webhook.
  7. Under Webhook configuration, enter:
    • Description: Enter a short, meaningful name for the webhook.
    • URL: Paste the Endpoint URL copied from Adyen Gateway Connect.
  8. Navigate to the HMAC section:
    • Click Generate to create a new HMAC key.
    • Save the configuration.
  9. In the Recommended webhooks section, click Add for the events you want to subscribe to.

    Supported events:
    • Payments
    • Refunds

Note: Disputes and payout events are not supported and will not be processed.

  1. Click Save configuration.
  2. Confirm the webhook appears in the Webhooks list and note its status.
  3. Copy the generated HMAC key and configure it in Adyen Gateway Connect:
    • Paste it into the Webhook HMAC Key field.

Result

  • The webhook is created and listed as active.
  • Events are delivered securely using HMAC authentication.
  • Webhook payloads are validated for integrity and authenticity.

Related Topic

Was this article helpful?
0 out of 0 found this helpful
Please sign in to submit a request.
Return to top

Related articles

Comments

0 comments

Please sign in to leave a comment.