Marqeta (marqeta v1.0.0)

Copy Markdown View Source

Production-grade Elixir client for the Marqeta Core, Credit, and DiVA APIs.

Quick start

config :marqeta,
  base_url: "https://sandbox-api.marqeta.com/v3",
  application_token: System.fetch_env!("MARQETA_APP_TOKEN"),
  admin_access_token: System.fetch_env!("MARQETA_ADMIN_TOKEN")

{:ok, user} = Marqeta.Users.create(%{
  first_name: "Jane",
  last_name: "Doe",
  email: "jane@example.com",
  identifications: [%{type: "SSN", value: "123456789"}]
})

API coverage

  • Core — Users, Cards, CardProducts, Businesses, Transactions, Balances
  • Funding — GPAOrders, ProgramFundingSources, ACH, InstantFunding, AutoReload
  • Spend controls — VelocityControls, AuthorizationControls, MCCGroups
  • Card lifecycle — CardTransitions, BulkCardOrders, PINs, DigitalWallets
  • Compliance — KYCVerification, FraudFeedback, ThreeDSecure
  • Disputes — Visa, Mastercard, PULSE, Evidence Collection
  • Credit (25 modules) — Full credit platform
  • DiVA (35 modules) — All analytics and reporting views
  • Platform — Webhooks, GatewayJIT, Simulations, Sandbox, CommandoMode

See Marqeta.Config for all configuration options. See Marqeta.Error for the error type and all error codes. See Marqeta.Stream for lazy auto-pagination across list endpoints. See Marqeta.Telemetry for observability hooks and metrics definitions.

Summary

Functions

Pings the Marqeta platform.

Pings the Marqeta platform. Raises Marqeta.Error on failure.

Returns the library version string.

Functions

ping(opts \\ [])

@spec ping(keyword()) :: {:ok, map()} | {:error, Marqeta.Error.t()}

Pings the Marqeta platform.

Useful for health checks and verifying credentials.

Example

{:ok, %{"version" => "3"}} = Marqeta.ping()

ping!(opts \\ [])

@spec ping!(keyword()) :: map()

Pings the Marqeta platform. Raises Marqeta.Error on failure.

version()

@spec version() :: String.t()

Returns the library version string.