Cashfree Payments - Settlements & Reconciliation

Reconcile Cashfree settlement payouts against orders, refunds, and bank statement UTRs.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/dasara-varun/orange --skill cashfree-payments-settlements-reconciliation-dasara-varun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Cashfree Payments - Settlements & Reconciliation
Source: https://github.com/dasara-varun/orange/tree/main/.cursor/cashfree-skills/settlements-and-reconciliation
Command: npx skills add https://github.com/dasara-varun/orange --skill cashfree-payments-settlements-reconciliation-dasara-varun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Finance and engineering teams struggle to explain why the money credited to their bank account differs from gross payment amounts, and to match bank statement UTRs back to individual Cashfree orders, refunds, and disputes. ## Core Features & Use Cases - Settlement Lifecycle Guidance: Explains T+1, T+2, weekly, instant, and on-demand settlement cycles plus the fee formula (service charge, GST, TDS, adjustments) behind net settled amounts. - Recon API Integration: Covers PGFetchSettlements, PGOrderFetchSettlement, PGSettlementFetchRecon, and PGFetchRecon with cursor pagination, event_type/sale_type schemas, and per-language SDK examples. - Webhook-to-Ledger Workflow: Provides the SETTLEMENT_SUCCESS ingestion pattern with signature verification, idempotent upserts, and a SQL query to detect reconciliation breaks. - Use Case: A merchant's accounts team sees a ₹97.94 credit instead of ₹100; use this Skill to pull the settlement recon rows, attribute the deduction to PG fee plus GST, and match the UTR on the bank statement. ## Quick Start Ask the assistant to explain why my Cashfree settled amount is less than the payment amount and show me how to fetch the settlement recon breakdown for a given UTR.

Frequently Asked Questions about Cashfree Payments - Settlements & Reconciliation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reconcile Cashfree settlements with my bank statement?▼

Match each bank statement credit to a settlement by its UTR, which maps one-to-one to a cf_settlement_id. Then pull event-level rows via POST /pg/settlement/recon and verify the signed sum of CREDIT and DEBIT events equals amount_settled.

Why is my Cashfree settled amount less than the payment amount?▼

Every settlement is net of the PG service charge, 18% GST on that charge, instant-settlement fees if applicable, adjustments from prior cycles, and TDS where applicable. The formula is amount_settled = payment_amount minus fees plus adjustments.

What is the difference between the settlement recon and PG recon APIs?▼

POST /pg/settlement/recon gives the event-level breakdown of settled funds per settlement, while POST /pg/recon returns every transaction in a date range regardless of settlement state. Use the latter for daily captured-payment reports.

How do I handle duplicate Cashfree settlement webhooks?▼

Cashfree webhooks use at-least-once delivery, so dedupe on cf_settlement_id or the x-idempotency-key header before writing to your ledger. Always verify the HMAC-SHA256 signature against the raw request body first.

When should I not use the settlements reconciliation skill?▼

Do not use it while still building the accept-payments flow, for outbound payouts to vendors, or for dispute response workflows. Those belong to the payments acceptance, payouts, and disputes skills respectively.