The Guides section provides comprehensive resources that combine foundational concepts with practical instructions. Each guide covers what a feature or process is, why it matters, and how to work with it — with references to the full API documentation where relevant. These guides apply across all integration types (Standard Checkout, Custom Checkout, and Plug and Play) unless stated otherwise.
Guides are organized into two branches: conceptual guides that explain how Nimbbl processes payments, and integration guides that walk through implementation tasks.
How Nimbbl Works
The conceptual guides establish the mental model you need before writing integration code. They explain the core entities (Orders, Payments, Refunds), how those entities relate to each other, and the role that payment partners play in processing transactions. Two sub-branches cover payment modes and currencies in depth.
Start here if you are new to Nimbbl or need to understand the data model and lifecycle of a transaction before integrating.
Guides in this branch:
- Orders — purchase intent, order lifecycle, and state management
- Payments — payment attempts, lifecycle states, and edge-case handling
- Refunds — refund types, lifecycle, and processing via API or Command Center
- Payment Partners — external processors, routing, and partner management
- Payment Modes — Cards, UPI, EMI, Pay Later, Netbanking and Wallets
- Currencies — multi-currency support, ACC, and DCC
Explore all conceptual guides: How Nimbbl Works
Integration
The integration guides provide step-by-step instructions for tasks you perform during and after implementation. They cover choosing the right integration path, setting up webhooks, validating responses, handling encryption and PII, and moving from test to production.
Start here if you have a working understanding of Nimbbl concepts and need to complete a specific implementation task.
Guides in this branch:
- Choosing Your Integration — compare no-code, low-code, and full API paths
- Webhooks and Transaction Enquiry — real-time and pull-based status updates
- Validating Payment Response with Signature — HMAC signature verification
- Using Encrypted Payloads — AES-GCM payload encryption and decryption
- Handling PII Data — personal data masking and compliance
- Testing and Going Live — test credentials and production readiness
Explore all integration guides: Integration Guides