PayBridge Documentation

Production-grade Payment Orchestration for .NET

Build once. Route safely. Operate confidently.

PayBridge gives your team one integration surface for multi-gateway payments, verification, refunds, webhook security, and operational safeguards.

Start with Quick Start

What You Get

• Unified gateway abstraction for payment creation, verification, and refund operations.
• Secure webhook path with signature verification, replay protection, and fail-closed behavior.
• Deterministic automatic routing with clear configuration validation at startup.
• Testable architecture with unit and integration workflows aligned to release quality.

Documentation Paths

Start Here

• Quick Start: Configure, run, and process your first transaction flow.
• Automatic Routing: Understand route selection and fallback behavior.
• Payment Idempotency: Prevent duplicate effects across retries.

Security Hardening

• Webhook Security: Signature validation contracts and provider-specific expectations.
• Webhook Replay Protection: Replay detection strategy and operations notes.
• Dependency Security: Vulnerability management and CI safeguards.
• Credential Rotation: Incident response and secret hygiene.

Reliability and Operations

• Integration Testing: Sandbox preflight gates and run interpretation.
• Refund Persistence: Durable refund lifecycle handling.
• Flutterwave Refunds: Known behavior and current implementation notes.

Recommended Reading Order

1. Quick Start
2. Automatic Routing
3. Webhook Security
4. Integration Testing
5. Idempotency and Refund Persistence

Release Readiness Checklist

• Gateway credentials configured through secure runtime providers.
• Webhook signatures verified before payload parsing or fulfillment.
• Idempotency and replay controls active for mutation endpoints.
• Unit and integration test gates passing in CI.
• Documentation and package claims aligned with implementation.