Skip to main content

Official package

Installation

Basic usage

What the SDK handles automatically

  • Generates token via POST /v1/auth/token
  • Refreshes token before expiration
  • Sends Authorization: Bearer on protected routes
  • Throws SafefyApiError with status, code, and details

Logging example

Available modules

  • sdk.transactions: create, list, retrieve, and simulate transactions
  • sdk.cashouts: create, list, and retrieve cashouts
  • sdk.customers: create, list, retrieve, and update customers
  • sdk.balance: retrieve balance

Versioning

The SDK follows semantic versioning in MAJOR.MINOR.PATCH format.
  • MAJOR: may contain breaking changes
  • MINOR: new backward-compatible features
  • PATCH: fixes and internal improvements