Elixir client for the Triple transaction data enrichment API.

Quick start

client = Triple.new(api_key: System.fetch_env!("TRIPLE_API_KEY"))

{:ok, enriched} =
  Triple.enrich_transaction(client, %{
    merchant_name: "AMZN MKTP UK",
    transaction_type: :CARD_TRANSACTION,
    transaction_id: Triple.Util.generate_transaction_id(),
    transaction_amount: 24.99,
    transaction_currency: "GBP"
  })

client is a plain Triple.Config struct — pass it explicitly everywhere. There's no global or process-dictionary state, which keeps the library safe to use with multiple Triple accounts/environments (e.g. sandbox and production) side by side in the same application.

Configuration

Every option can be passed to new/1 directly, or set application-wide:

config :triple, api_key: System.fetch_env!("TRIPLE_API_KEY")

See Triple.Config for the full list of options (timeouts, retries, custom Req options, an optional client-side rate limiter, etc).

Error handling

Every call returns {:ok, result} | {:error, %Triple.Error{}}. Each function also has a ! counterpart that raises Triple.Error instead — e.g. enrich_transaction!/2. See Triple.Error for the fields available on failure (HTTP status, field-level validation errors, retry-after, etc).

Context modules

Every resource also has its own module if you'd rather call it directly: Triple.Enrich, Triple.Brands, Triple.Feedback, Triple.Stocks, Triple.Cryptos, Triple.TLS.