REST & GraphQL APIs for Global Payments — build sovereign-grade payment infrastructure with comprehensive, versioned APIs.
Three authentication methods designed for every use case — from quick prototypes to enterprise-grade deployments.
Generate scoped API keys from the dashboard. Keys support read, write, and admin permissions with optional IP allowlisting.
Server-to-server authentication using RS256 signed JSON Web Tokens with configurable expiry and custom claims.
Delegate authorization for third-party integrations with full OAuth 2.0 compliance and refresh token rotation.
Every endpoint is versioned, idempotent, and returns structured JSON responses with consistent error codes.
| Method | Path | Description |
|---|---|---|
| POST | /v1/transfers | Create and execute a cross-border transfer |
| GET | /v1/transfers/:id | Retrieve transfer status and details |
| GET | /v1/accounts | List all wallet accounts |
| POST | /v1/accounts/:id/fx | Execute FX conversion at market rate |
| GET | /v1/rates/:pair | Get real-time exchange rate for a currency pair |
| POST | /v1/webhooks/endpoints | Register a webhook endpoint |
Subscribe to real-time events with idempotent delivery, automatic retries, and HMAC-SHA256 signature verification.
HMAC-SHA256 signed payloads
Automatic retry with exponential backoff
Idempotent delivery guarantees
Sub-second latency on event dispatch
Subscribe to any combination of events via the dashboard or API.
A new transfer has been initiated
Transfer has been settled at the destination
Transfer failed due to insufficient funds or compliance
An account received an incoming payment
A currency conversion has been executed
Compliance flag raised on a transaction
Every plan includes predictable rate limits with burst capacity for traffic spikes. All limits reset on a per-second sliding window.
Install any SDK with a single command. All SDKs share the same idiomatic API surface.
# TypeScript / JavaScript
npm install @payledger/sdk
# Python
pip install payledger-python
# Go
go get github.com/payledger/go-sdk
# Rust
cargo add payledger-rsExplore every endpoint, parameter, and response schema in our interactive API reference. Try requests live from your browser.