Documentation
Playbooks

Guides for operators, engineers, and compliance

Every article captures a key PayCA programme flow — from onboarding users and settling fees to processing webhook retries.

All guides

Bookmark the guides relevant to your team, or submit a pull request with edits when behaviours change.

Guide • Updated 09 Jul 2025

Sandbox Playbook

Use PayCA’s sandbox to simulate card spend, fees, and webhook retries before you ship to production.

Guide • Updated 08 Jul 2025

Getting Started With PayCA

Spin up credentials, configure environments, and make your first PayCA API calls in less than an hour.

Guide • Updated 07 Jul 2025

Webhook Handling Patterns

Verify signatures, store payloads idempotently, and replay missed deliveries with confidence.

Guide • Updated 06 Jul 2025

Programme Entities

Understand the objects exposed through the PayCA API so you can organise users, cards, balances, and event streams.

Guide • Updated 05 Jul 2025

Moving Funds & Reconciliation

Move money between your tenant balance and user wallets, then confirm activity with API responses and webhooks.

Guide • Updated 04 Jul 2025

Fees & Revenue Recognition

Track fees surfaced through PayCA APIs and webhooks so finance teams can reconcile revenue accurately.

Guide • Updated 03 Jul 2025

API Authentication & Request Hygiene

Understand headers, idempotency keys, pagination, and error handling conventions for every PayCA endpoint.

Guide • Updated 02 Jul 2025

Go-Live Runbook

Coordinate engineering, finance, and support for a smooth transition from sandbox to production.

Guide • Updated 02 Jan 2024

User Lifecycle & Control Flows

End-to-end reference for creating users, managing their accounts and cards, and enforcing status-driven controls across PayCA APIs.

Guide • Updated 01 Jan 2024

User Onboarding Checklist

Provision, fund, and monitor new users with predictable KYC, card issuance, and liquidity workflows.