Production-grade Elixir client for the Paysafe API.

Overview

This library provides complete coverage of the Paysafe developer platform:

• Payments API — Payment handles, payments, settlements, refunds, payouts, verifications, and customer/vault management.
• Payment Scheduler API — Plans and subscriptions for recurring billing.
• Applications API — Programmatic merchant onboarding.
• Value Added Services — FX Rates, Customer Identity (KYC), Bank Account Validation, Network Tokenization, Account Updater.
• Webhooks — HMAC-SHA256 verification and typed event parsing.

Configuration

Build a config struct from your credentials:

config = Paysafe.Config.new!(
  username: "1001062690",
  password: "B-qa2-0-...",
  environment: :test,
  account_id: "1009688230"
)

Or load from config/config.exs:

# config/config.exs
config :paysafe,
  username: System.get_env("PAYSAFE_USERNAME"),
  password: System.get_env("PAYSAFE_PASSWORD"),
  environment: :test,
  account_id: "1009688230"

# runtime:
config = Paysafe.Config.from_env!()

Quick start — card payment

config = Paysafe.Config.new!(
  username: "...",
  password: "...",
  environment: :test,
  account_id: "1009688230"
)

# 1. Create a payment handle
{:ok, handle} = Paysafe.create_payment_handle(config, %{
  merchant_ref_num: "order-669170",
  amount: 5000,
  currency_code: "USD",
  payment_type: "CARD",
  transaction_type: "PAYMENT",
  card: %{
    card_num: "4111111111111111",
    card_expiry: %{month: 12, year: 2030},
    cvv: "123",
    holder_name: "Jane Doe"
  },
  billing_details: %{
    street: "123 Main St",
    city: "New York",
    state: "NY",
    country: "US",
    zip: "10001"
  },
  settle_with_auth: true
})

# 2. Use the token in a payment
{:ok, payment} = Paysafe.create_payment(config, %{
  merchant_ref_num: "payment-001",
  amount: 5000,
  currency_code: "USD",
  settle_with_auth: true,
  payment_handle_token: handle.payment_handle_token
})

Payment method coverage

The Payments API supports 30+ payment methods:

• Cards — Visa, Mastercard, Amex, Discover, Debit, Prepaid, Corporate.
• Digital Wallets — Apple Pay, Google Pay, PayPal, Venmo, Skrill, Neteller.
• Bank Transfers — iDEAL, EPS, BLIK, Interac e-Transfer, Mazooma, Pay by Bank.
• Direct Debit — ACH (US), BACS (UK), EFT (CA), SEPA (EU).
• Cash — PaysafeCash.
• Vouchers — PaysafeCard, Openbucks, Multibanco.
• LatAm — SafetyPay (Pix, Boleto, KHIPU, MACH), PagoEfectivo, Rapid Transfer.
• Crypto — Pay with Crypto.

Architecture

• Config validated at construction via NimbleOptions.
• All requests have exponential backoff retry on transient failures.
• Token-bucket rate limiting per account via ExRated.
• Telemetry events on every request (:paysafe, :request, :start/:stop/:exception).
• HMAC-SHA256 webhook verification with constant-time comparison.

• All public functions return {:ok, result} | {:error, %Paysafe.Error{}}.