Production-grade Elixir client for the Wise Platform API.

Installation

Add wise to your mix.exs dependencies:

def deps do
  [{:wise, "~> 1.0"}]
end

Quick Start

# Build a config
config = Wise.Config.new!(
  personal_token: System.fetch_env!("WISE_API_TOKEN"),
  sandbox: true
)

# Use any service
{:ok, profiles} = Wise.Services.Profiles.list(config)
{:ok, quote}    = Wise.Services.Quotes.create(config, profile_id, %{
  sourceCurrency: "USD",
  targetCurrency: "GBP",
  sourceAmount:   1000
})
{:ok, transfer} = Wise.Services.Transfers.create(config, %{
  targetAccount:         recipient_id,
  quoteUuid:             quote["id"],
  customerTransactionId: Wise.IdempotencyKey.new()
})
{:ok, _funded}  = Wise.Services.Transfers.fund(config, profile_id, transfer["id"])

Error Handling

case Wise.Services.Transfers.fund(config, pid, tid) do
  {:ok, result}                                    -> result
  {:error, %Wise.Error{code: "SCA_REQUIRED"}}      -> redirect_to_sca()
  {:error, %Wise.Error{type: :circuit_open}}       -> handle_open_circuit()
  {:error, %Wise.Error{type: :network, message: m}} -> Logger.warn(m)
end

All 42 API Groups

Advanced Features

• Rate limiting — token-bucket GenServer (10 req/s, burst 20)
• Circuit breaker — CLOSED/OPEN/HALF_OPEN state machine GenServer
• Retry — exponential back-off with cryptographic jitter (:crypto.strong_rand_bytes/1)
• Request/response hooks — telemetry, logging, custom headers
• HMAC-SHA256 webhook verification — constant-time comparison
• Connection pooling — hackney pool via Wise.Application
• OTP supervision — started automatically as part of the application tree