Modules
Donations
The InChurch API's Donations module manages all aspects of your church's financial contributions, from payment processing to integration with accounting systems.
Overview
The donation system offers complete functionality for:
- Payment Processing - PIX, credit card, bank slip (boleto)
- Real-Time Tracking - Payment status and confirmations
- Automatic Notifications - Webhooks for payment events
- Accounting Integration - Synchronization with financial systems
- Detailed Reports - Complete history of donations
Key Concepts
Donation States
A donation can be in different states throughout its lifecycle:
| State | Description | When It Occurs |
|---|---|---|
pending | Donation created, awaiting payment | Form submitted |
paid | Payment confirmed | PIX received, card authorized |
failed | Payment failed | Gateway error, card declined |
expired | Payment expired | PIX QR Code or bank slip expired |
Payment Methods
The API supports multiple payment methods:
- PIX - Instant payment via QR Code or PIX key
- Credit Card - Processing via a payment gateway
- Debit Card - Direct debit from a bank account
- Boleto Bancário (Bank Slip) - Slip with a barcode for payment
Donation Types
The system allows for different donation categories:
- Tithe - Regular 10% contribution
- Offering - Voluntary contributions
- Missions - Donations for missionary work
- Construction - Funds for building projects
- Events - Contributions for specific events
Last modified on