Plugin cannot connect to Adyen LIVE: no setting for the live endpoint URL prefix

Open
#151 1 comment 0 reactions 0 assignees View on GitHub

@kccrcodes is already working on this.

Since Nov 18, 2026.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
74/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
java
Domain
backend, payments

Research direction

Start with AdyenSDKClientImpl.java and AdyenConfigProperties.java to trace how tenant settings reach the Adyen client; check README.md for the documented configuration. Add support for the merchant's LIVE URL prefix and pass it when building the client. Update or add tests for client configuration, then confirm the README explains the setting and LIVE operations can use the merchant endpoint.

Written by the indexing model from the issue text.

Description

Description

With enviroment=LIVE, every call from the plugin to Adyen (checkout session, purchase, void, refund) fails before reaching Adyen. Adyen's LIVE Checkout API address is unique per merchant (https://<prefix>-checkout-live.adyenpayments.com/checkout). The Adyen SDK requires this prefix for LIVE, but the plugin has no setting for it and never passes one. TEST is unaffected because it uses a single fixed address.

Steps to reproduce

  1. Upload the tenant Adyen config with org.killbill.billing.plugin.adyen.enviroment=LIVE and a LIVE API key and merchant account.
  2. Trigger any Adyen operation for that tenant: a checkout session, a recurring purchase, a refund or a void.

Expected

The plugin calls the merchant's LIVE endpoint, https://<prefix>-checkout-live.adyenpayments.com/checkout/v68/..., and the operation reaches Adyen.

Actual

The Adyen client cannot be created and the operation fails with:

IllegalArgumentException: Please provide your unique live url prefix on the setEnvironment() call on the Client or provide checkoutEndpoint in your config object.

No request reaches Adyen.

Evidence

Plugin

Adyen SDK 17.3.0

Reproduced with SDK 17.3.0, building the client the same way as the plugin:

TEST, no prefix  -> https://checkout-test.adyen.com/checkout/v68/sessions
LIVE, no prefix  -> IllegalArgumentException: Please provide your unique live url prefix ...
LIVE + prefix    -> https://abc123-XYZ-checkout-live.adyenpayments.com/checkout/v68/sessions
Dominant language
Java
Stars
11
Forks
31
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from killbill/killbill-adyen-plugin

All issues in killbill/killbill-adyen-plugin

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.