Transaction lifecycle, designed for certainty.
How SwitchX takes in, validates, routes, tracks and reconciles a UPI-style transaction.
Authenticated API requests with an Idempotency-Key and a correlation ID.
Schema, decimal-safe amounts, institution authorization and supported types.
Versioned, priority-ordered rules select an eligible partner, with a full evaluation trace.
One adapter per partner maps requests, responses, timeouts and status inquiry.
received → validated → routing → processing → success / failed / pending verification.
Partner codes map to SwitchX codes (SX00, SX51, SX91…) with clear messages.
A timeout becomes pending_verification. It's never marked failed without a status inquiry.
Retries return the stored response; a reused key with a different body is rejected.
Partner reports are matched daily, and alerts flag failure-rate and latency changes.