Cashfree Payments icon

Cashfree Payments

Interact with Cashfree Payments API

Overview

This node interacts with the Cashfree Payments API to create a refund for a specific order. It is useful in scenarios where a merchant needs to refund a payment partially or fully to a customer. For example, if a customer returns a product, the merchant can use this node to initiate a refund transaction through Cashfree's payment gateway.

Use Case Examples

  1. Refunding a customer for a returned product by specifying the order ID, refund amount, and refund ID.
  2. Issuing an instant refund to a customer by setting the refund speed to INSTANT.

Properties

Name Meaning
Order ID The identifier of the order for which the refund is being created.
Refund Amount The amount to be refunded to the customer.
Refund ID A unique identifier for the refund transaction.
Refund Note An optional note or reason for the refund.
Refund Speed The speed at which the refund should be processed, either STANDARD or INSTANT.
Request ID An optional request ID for the API call, useful for troubleshooting with Cashfree support.
Idempotency Key A unique key to ensure the API call is idempotent, preventing duplicate refunds if the request is retried.

Output

JSON

  • json - The JSON response from the Cashfree API containing details of the created refund.

Dependencies

  • Cashfree API credentials including Client ID, Client Secret, and API version.

Troubleshooting

  • Ensure that the Client ID and Client Secret are correctly configured in the credentials; otherwise, the node will throw an error indicating missing credentials.
  • If the refund creation fails, check the refund amount and refund ID for correctness and uniqueness.
  • Use the Request ID and Idempotency Key to safely retry requests and avoid duplicate refunds.
  • Common error messages include missing credentials, invalid refund amount, or duplicate refund ID. Verify all required parameters are provided and valid.

Discussion