Connect Cashfree Payments

Take UPI, cards, net banking, wallets and Pay Later in rupees through your own Cashfree account - API keys, webhook, test payment and going live.

Cashfree Payments lets customers pay in rupees by UPI, cards, net banking, wallets and Pay Later. It works for invoices from every Ellibo app, POS bills and bookings.

Before you start

• A Cashfree Payments account. Sign up at cashfree.com. Test (sandbox) keys are ready straight away. For live payments, finish KYC on the Merchant Dashboard: PAN, business documents, bank account, and your website or app.
• You must be an admin of the business in Ellibo.

Step 1: Get your API keys

1. Sign in to the Cashfree Merchant Dashboard and open Payment Gateway.
2. Choose the Test (sandbox) or Production environment.

3. Go to Developers › API Keys.

   • Test keys are made for you.
   • For production, click Generate API Keys and confirm with the code Cashfree sends.
4. Click the eye icon (View API Key) and copy the App ID (also called Client ID) and the Secret Key.

Step 2: Connect in Ellibo

1. Open Settings › Integrations › Payments.
2. On the Cashfree Payments tile, click Connect.

Step 3: Add the webhook

1. In Ellibo, under Your gateways › Cashfree Payments, click Copy next to Webhook URL.
2. In the Cashfree dashboard, go to Developers › Webhooks and add a webhook endpoint.
3. Paste the address and choose the Payment Link events (paid, partially paid, cancelled, expired).
4. Save. Cashfree signs each message with your Secret Key, so there's no extra secret to copy.

Step 4: Try a test payment

1. Open the Pay now link of a small invoice and choose Cashfree Payments.

2. Pay with Cashfree's test details:

   • UPI: testsuccess@gocash (or testfailure@gocash);
   • Card: see Test card details in Cashfree's developer docs.
3. Check the invoice shows Paid in Ellibo, then cancel the test receipt.

Step 5: Go live

1. When KYC is approved, generate Production keys.
2. In Ellibo, click Keys, paste them, set Account type to Live, and Save.
3. Add the webhook again in Production.

Fees, payouts and refunds

• Cashfree pays out to your bank on its schedule (usually T+1 or T+2 working days). Record payouts in Accounting › Online Payments.
• Refund with the Refund button in Ellibo.
• Cashfree is for rupee invoices only. Invoices in other currencies show other gateways.

If something goes wrong

See also Fix payment problems.