Skip to main content

​
Overview

The Transaction API enables customers to transfer money between wallets, withdraw to bank accounts, perform bank transfers, and manage their transaction history—all while transacting across the entire FLEX ecosystem.
All transaction endpoints require customer authentication (Bearer token).
Complete API Specification: View the full SSO OpenAPI Spec for detailed schemas and all endpoint specifications.

​
Transaction Endpoints

P2P Transfer

POST /sso/transaction/p2p - Transfer to any PayTag across the ecosystem

Withdraw

POST /sso/transaction/withdraw - Withdraw funds to bank account

Bank Transfer

POST /sso/transaction/bank-transfer - Transfer to any Nigerian bank account

List Transactions

GET /sso/transaction - Get paginated customer transactions

Get Transaction

GET /sso/transaction/{reference} - Get transaction details by reference

Generate Statement

POST /sso/transaction/statement - Generate account statement

​
Key Features

​
Cross-Partner Transactions

Your customers can send money to any PayTag user on FLEX, regardless of which partner created their PayTag—creating a truly interconnected payment ecosystem.

​
Transaction Types

  • P2P Transfers: Send to any PayTag user across the ecosystem
  • Withdrawals: Transfer to bank account numbers
  • Bank Transfers: Full bank transfer with bank code
  • Statements: Generate PDF statements for any date range

​
Advanced Filtering

  • Date range filtering
  • Transaction type and status
  • Search by reference
  • Currency filtering
  • Pagination support

Integration Guide

Implementation examples

Wallet API

Check balances and limits

Payment Requests API

Request payments from others

OpenAPI Spec

Full API specification

​
Security

All transaction endpoints require:
  • x-client-id header (Partner ID)
  • x-api-key header (Partner API key)
  • Authorization: Bearer {customer_token} header

​
Error Responses

​
API Tags

The Transaction API includes endpoints under the SSO Transaction tag in the OpenAPI specification.
For complete request/response schemas, parameters, and examples, refer to the SSO OpenAPI Specification.