Librarify Help

Appearance

How to connect Cashfree ​

Connect your own Cashfree account to let members pay online. Money goes to your Cashfree account, and Librarify marks the receipt as paid when the payment succeeds.

Who can do thisOwner, Org admin by default, or any staff role given Integrations → Manage and Org Settings → Manage in Settings → Staff role permissions.

Before you start ​

  • You need a Cashfree merchant account. To take real payments, it must be activated by Cashfree.
  • Your App ID and Secret Key from the Cashfree Merchant Dashboard.

Steps ​

  1. In Librarify, open Settings → Integrations → Payment Gateways.
  2. Under Checkout methods, make sure Payment gateway is on.
  3. Under Available Payment Gateways, click the Cashfree tab, then Configure (it says Manage once connected).
  4. Paste your App ID and Secret Key.
  5. Choose the Environment: Production for real payments, or a test option with test keys while you try it out.
  6. Click Save configuration. The gateway is turned on straight away and its badge changes to Active. Members now see Cashfree Payments at checkout.
The Cashfree gateway card with its credentials form
  1. App IDFrom your Cashfree dashboard
  2. Secret KeyStored encrypted, shown as *****
  3. Webhook URLYour library's own address; copy it
  4. On/off switchPause or resume the gateway
  5. Save configurationReads "Update configuration" once connected

Payments are confirmed when the member returns to your site after paying. A webhook also tells Librarify about payments where the member closed the page too early.

  1. On the Cashfree card, click Manage and click the copy button next to Webhook URL.
  2. In the Cashfree dashboard under Developers → Webhooks, add a webhook with that URL and subscribe to PAYMENT_SUCCESS_WEBHOOK and PAYMENT_FAILED_WEBHOOK.
  3. If Cashfree gives you a webhook secret, paste it into Webhook secret. It is optional.
  4. Click Update configuration.

Change keys or pause the gateway ​

  • Saved keys show as *****. Leave them as they are to keep them. To replace them, type both the new App ID and Secret Key. To change the Environment, enter both keys again too.
  • To stop taking payments through Cashfree for a while, turn off the switch on its card. It saves on its own, so you don't need to click anything else. The badge shows Configured, off, and members won't see Cashfree Payments until you turn it back on.

What members see ​

At checkout, members choose Cashfree Payments under Payment Method and pay by UPI, card, netbanking or wallet. When the payment succeeds, the receipt is marked paid, and the seat or locker is assigned if auto-assign is on.