Cashfree Payouts

Integrate Cashfree Payouts APIs for fund disbursals to bank accounts, UPI, cards, and wallets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Integrating a payout system involves many moving parts: beneficiary management, transfer initiation, async status tracking, webhook signature verification, and two-factor authentication. This Skill provides the complete Cashfree Payouts integration flow with correct V2 API shapes, headers, and security rules so you avoid costly mistakes like duplicate transfers or unverified webhooks. ## Core Features & Use Cases - Beneficiary & Transfer APIs: Create beneficiaries and initiate transfers via IMPS, NEFT, UPI, card, Paytm, and Amazon Pay using the V2 nested request body format. - Webhook Handling: Configure V2 webhooks and verify HMAC-SHA256 signatures in Node.js or Python before processing TRANSFER_SUCCESS, FAILED, REVERSED, and other events. - Batch Transfers & Legacy V1: Send bulk payouts in one API call and reference V1 legacy endpoints, RSA 2FA signature generation, and status codes via the references file. - Use Case: A marketplace needs to pay vendors weekly. Use this Skill to add each vendor as a beneficiary, trigger a batch transfer, and reconcile final statuses through verified webhook events. ## Quick Start Ask the AI to integrate Cashfree Payouts by creating a beneficiary and initiating a sandbox transfer with the correct V2 headers and nested request body.

Frequently Asked Questions about Cashfree Payouts

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

FAQPage Schema
How do I integrate Cashfree Payouts to send money to a bank account?▼

Create a beneficiary via POST /payout/beneficiary with account number and IFSC, then initiate a transfer via POST /payout/transfers using the nested beneficiary_details object. Authenticate every request with x-client-id, x-client-secret, and x-api-version headers.

How to verify Cashfree payout webhook signatures in Node.js?▼

Compute an HMAC-SHA256 digest of the x-webhook-timestamp header concatenated with the raw request body, using your client secret, then base64-encode it and compare with the x-webhook-signature header. Always use the oldest active client secret.

What is the difference between Cashfree Payouts V1 and V2 APIs?▼

V2 uses direct x-client-id and x-client-secret header authentication with nested transfer bodies, while V1 requires a Bearer token from /payout/v1/authorize that expires in 6 minutes. V1 directTransfer is deprecated and migration to Transfers V2 is recommended.

Why did my Cashfree payout transfer fail or get reversed?▼

Transfers fail with status codes like IMPS_MODE_FAIL, INVALID_BENE_ACCOUNT_OR_IFSC, or INSUFFICIENT_BALANCE, and can be reversed by the beneficiary bank after SUCCESS. Check transfer status via GET /payout/transfers?transfer_id= and handle TRANSFER_FAILED and TRANSFER_REVERSED webhooks.

Can I send bulk payouts with Cashfree in one API call?▼

Yes, use POST /payout/transfers/batch with a batch_transfer_id and a transfers array, where each entry follows the same nested shape as a single transfer. On a 5XX response, check batch status first instead of retrying to avoid duplicate payouts.