Error Handling Guide

All AdyenClient functions return {:ok, body} or {:error, %AdyenClient.Error{}}.

Error struct

%AdyenClient.Error{
  type:          :server_error,
  status:        503,
  message:       "Service unavailable",
  error_code:    nil,
  psp_reference: nil,
  raw:           %{"message" => "Service unavailable"},
  retryable:     true
}

Pattern matching

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

Error types