Documentation Index

Fetch the complete documentation index at: https://docs.fype.dev/llms.txt

Use this file to discover all available pages before exploring further.

​

Cashfree Integration Guide

Cashfree is a robust payment gateway in India that offers advanced features like instant settlements and a wide variety of payment modes. Fype’s Cashfree integration allows you to leverage these features through a unified interface.

​

1. Obtain Cashfree API Credentials

To connect Cashfree to Fype, you need your App ID (Client ID) and Secret Key (Client Secret).

1. Log in to your Cashfree Merchant Dashboard.
2. Switch to the desired environment (Test or Production) using the toggle at the top right.
3. Navigate to Payment Gateway > Developers > API Keys.
4. Copy your App ID and Secret Key.

​

2. Connect to Fype

1. Log in to the Fype Dashboard.
2. Navigate to Connections.
3. Click Connect Cashfree.
4. Select the environment:
   • Sandbox: Use this for Cashfree Test credentials (App ID starts with TEST).
   • Live: Use this for Cashfree Production credentials (App ID starts with PROD).
5. Enter your App ID and Secret Key.
6. (Optional but Recommended) Enter a Webhook Secret. You will set this in the Cashfree Dashboard in the next step.
7. Click Save Connection.

​

3. Configure Cashfree Webhooks

Fype needs webhooks to receive real-time updates from Cashfree.

1. In the Cashfree Dashboard, navigate to Payment Gateway > Developers > Webhooks.
2. Click + Add New Webhook.
3. Webhook URL: Set this to https://api.fype.dev/v1/webhooks/cashfree.
4. Webhook Secret: Enter a strong, unique string. This must match the Webhook Secret you provided in the Fype Dashboard.
5. Events: Subscribe to the following events:
   • PAYMENT_SUCCESS_WEBHOOK
   • PAYMENT_FAILED_WEBHOOK
   • PAYMENT_USER_DROPPED_WEBHOOK
   • REFUND_STATUS_WEBHOOK
6. Click Save.

​

4. Verification

1. Test Transaction: Create a payment using your Fype Test API Key.
2. Checkout: Follow the checkout_url. Fype will load the Cashfree Web Checkout SDK.
3. Status Sync: Verify in the Fype Dashboard that the payment status transitions to succeeded.
4. Webhook Delivery: Confirm that your backend received the payment.succeeded event from Fype.

​

Troubleshooting

​

Signature Verification Failed

Cashfree signatures are sensitive to the raw request body. Ensure that the Webhook Secret in Fype matches the one in Cashfree exactly. If you are using a proxy or middleware that modifies the request body, signature verification will fail.

​

Order Expired

Cashfree orders have a default expiry. If a customer stays on the checkout page too long without completing the payment, the order will expire. Fype handles this by marking the payment as failed.

​

Refund Status Pending

Cashfree refunds may sometimes remain in PENDING state if the upstream bank is slow. Fype will update the refund status once it receives the REFUND_STATUS_WEBHOOK with a final state.