Guides for operators, engineers, and compliance
Every article captures a key PayCA programme flow — from master-account funding and fee settlement to webhook retries.
All guides
Bookmark the guides relevant to your team, or submit a pull request with edits when behaviours change.
Provider W Cardholder Integration
End-to-end guide for cardholder registration, approval and card issuance on Provider W BINs — the short B2B form and the full B2C identity check.
KYC Verification Flow
Upload identity documents, submit them for review, and get a cardholder KYC-approved — including how approval works and how to self-approve in sandbox.
Getting Started With PayCA
Spin up credentials, configure environments, and make your first PayCA API calls in less than an hour.
Cardholder Webhooks
Real-time webhooks for cardholder status changes in PayCA.
Passport Photo & Selfie at Cardholder Creation
How to upload a passport photo and a selfie-with-document for a cardholder.
Reloading BIN Fee Cache
How to refresh the in-memory BIN fee cache on workers without a restart.
Monthly Fees — Support Runbook
How TCC monthly fees are charged, idempotency model, and post-deploy verification.
API Authentication & Request Hygiene
Understand headers, idempotency keys, pagination, and error handling conventions for every PayCA endpoint.
Apple & Google Pay Tokenization
Enable wallet-ready BINs, start tokenization, and process webhook OTP payloads for wallet attachment.
Fees & Revenue Recognition
Track fees surfaced through PayCA APIs and webhooks so finance teams can reconcile revenue accurately.
Go-Live Runbook
Coordinate engineering, finance, and support for a smooth transition from sandbox to production.
Money Movement Overview
A client-facing map of how money moves across cards, master accounts, and fee entries.
Moving Funds & Reconciliation
Operate card liquidity from master accounts and reconcile every balance movement with webhook evidence.
Programme Entities
Understand the core objects exposed through the PayCA API for master-account integrations.
Sandbox Playbook
Use PayCA sandbox to simulate card spend, fees, and webhook retries before production launch.
Webhook Balance Effects
Exact webhook types, payload fields, and expected balance impact on master accounts and cards.
Webhook Handling Patterns
Verify signatures, store payloads idempotently, and replay missed deliveries with confidence.