AdyenClient

Production-grade Elixir client for the Adyen Payments Platform.

Covers every Adyen API — 200+ endpoints across 30+ namespaces — with retry, circuit breaker, rate limiting, HMAC webhook validation, Plug integration, Dialyzer-clean typespecs, and structured error handling throughout.

See USAGE_GUIDE.md for the complete usage reference.

Installation

# mix.exs
def deps do
  [
    {:adyen_client, "~> 1.0"},
    {:plug, "~> 1.15"}   # only needed for AdyenClient.Webhooks.Plug
  ]
end

Configuration

# config/config.exs
config :adyen_client,
  api_key:          System.get_env("ADYEN_API_KEY"),
  environment:      :test,                # :test | :live
  merchant_account: "YourMerchantECOM",
  timeout:          30_000,
  max_retries:      3,
  webhook_hmac_key: System.get_env("ADYEN_HMAC_KEY")

# config/prod.exs
config :adyen_client, environment: :live

Quick Example

# Create a payment session (Drop-in / Components)
{:ok, session} =
  AdyenClient.Checkout.Sessions.create(%{
    amount:          %{currency: "EUR", value: 1000},
    merchantAccount: "YourMerchantECOM",
    reference:       "order-1234",
    returnUrl:       "https://yourapp.com/result"
  })

# Capture an authorised payment
{:ok, _} =
  AdyenClient.Checkout.Modifications.capture("PSP-REF", %{
    merchantAccount: "YourMerchantECOM",
    amount: %{currency: "EUR", value: 1000}
  })

# Receive and validate a webhook
:ok = AdyenClient.Webhooks.process(raw_body, hmac_key, MyApp.AdyenHandler)

Error Handling

Every function returns {:ok, body} or {:error, %AdyenClient.Error{}}:

case AdyenClient.Checkout.Payments.create(params) do
  {:ok, %{"resultCode" => "Authorised"} = resp} -> handle_success(resp)
  {:error, %AdyenClient.Error{type: :auth_error}} -> Logger.error("Bad API key")
  {:error, %AdyenClient.Error{retryable: true}}   -> schedule_retry()
end

License

MIT