CORE API Overview

Base URL

https://api.transacty.ai

There is no separate sandbox hostname. Test and live use the same URL; the API key chooses the environment.

Core merchant endpoints:

• Identity: GET /v1/me
• Balance: GET /v1/balance (read items[] for every pocket, including NGN and PYUSD-USDC)
• Transactions: GET /v1/transactions and GET /v1/transactions/:transactionId

All endpoints require signed headers:

• X-Transacty-Key
• X-Transacty-Signature — HMAC-SHA256 of {timestamp}.{rawBody}, lowercase hex
• X-Transacty-Timestamp — Unix seconds
• Content-Type: application/json on POST/PATCH

GET requests have an empty body — the signing payload is {timestamp}. (trailing dot).