Build with a payment API designed for operators
API keys, idempotent payments, webhooks and sandbox testing — documented against the live OpenAPI contract.
Getting Started
Environments, sandbox keys and first request.
Authentication
API keys and dashboard session modes.
API Overview
Base URL, envelopes, idempotency and errors.
Payment Initialization
Create payments with amount_minor and currency.
Payment Verification
Retrieve payments, events and status.
Refunds
Create and retrieve refunds.
Webhooks
Endpoints, deliveries, retry and replay.
Error Handling
Common error codes from the API envelope.
Sandbox Testing
Test keys, sandbox providers and safe practices.
Authenticated payment create
curl -X POST "$API/v1/merchants/$MERCHANT_ID/payments" \
-H "X-API-Key: $TYVION_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"amount_minor":10000,"currency":"GHS","payment_method":"mobile_money"}'.png&w=3840&q=75)