Cashfree Payments icon

Cashfree Payments

Interact with Cashfree Payments API
Join our community

Actions9

Overview

This node integrates with the Cashfree Payments API to create a new payment order. It allows users to specify detailed order information including amount, currency, customer details, shipping and billing addresses, payment methods, and terminal information. This node is useful for businesses that want to automate order creation and payment processing through Cashfree, enabling seamless payment collection and order management.

Use Case Examples

  1. An e-commerce platform creating a payment order for a customer's purchase with detailed shipping and billing information.
  2. A merchant setting up an order with specific payment methods and enabling features like One Click Checkout or Verify and Pay.

Properties

Name Meaning
Order Amount The total amount for the order to be created.
Order Currency The currency in which the order amount is specified.
Customer ID Unique identifier for the customer placing the order.
Customer Phone Phone number of the customer.
Customer Email Email address of the customer (optional).
Customer Name Name of the customer (optional).
Customer Bank Account Number Customer's bank account number, required for Third Party Verification (optional).
Customer Bank IFSC Customer's bank IFSC code, required for Third Party Verification (optional).
Customer Bank Code Customer's bank code, required for net banking payments with TPV (optional).
Order ID Order identifier in the user's system, alphanumeric with '_' and '-' allowed (optional).
Order Note Reference note for the order (optional).
Order Expiry Time Expiry time of the order in ISO 8601 format (optional).
Return URL URL to redirect the customer after payment completion (optional).
Notify URL HTTPS URL for server-to-server notifications (optional).
Payment Methods Comma-separated list of allowed payment methods (optional).
Cart Name Name of the cart associated with the order (optional).
Customer Note Note from the customer (optional).
Shipping Charge Shipping charges for the order (optional).
Shipping - Full Name Full name for the shipping address (optional).
Shipping - Country Country for the shipping address (optional).
Shipping - City City for the shipping address (optional).
Shipping - State State for the shipping address (optional).
Shipping - Pincode Pincode for the shipping address (optional).
Shipping - Address Line 1 Primary address line for shipping (optional).
Shipping - Address Line 2 Secondary address line for shipping (optional).
Billing - Full Name Full name for the billing address (optional).
Billing - Country Country for the billing address (optional).
Billing - City City for the billing address (optional).
Billing - State State for the billing address (optional).
Billing - Pincode Pincode for the billing address (optional).
Billing - Address Line 1 Primary address line for billing (optional).
Billing - Address Line 2 Secondary address line for billing (optional).
Terminal Type Type of terminal (e.g., SPOS) for SoftPOS orders (optional).
Terminal ID Terminal ID for merchant reference (optional).
Terminal Phone Number Mobile number of the terminal/agent/storefront (optional).
Terminal Name Name of terminal/agent/storefront (optional).
Terminal Address Location of terminal (optional).
Terminal Note Note given by merchant while creating the terminal (optional).
Enable One Click Checkout Enable One Click Checkout feature (optional).
Enable Verify and Pay Enable Verify and Pay feature (optional).

Output

JSON

  • order_id - Identifier of the created order.
  • order_status - Status of the created order.
  • order_amount - Amount of the created order.
  • order_currency - Currency of the created order.
  • customer_details
    • customer_id - Customer identifier associated with the order.
    • customer_phone - Customer phone number.
    • customer_email - Customer email address.
  • order_shipping_address - Shipping address details if provided.
  • order_billing_address - Billing address details if provided.
  • payment_methods - Allowed payment methods for the order.

Dependencies

  • Cashfree Payments API
  • API credentials including Client ID, Client Secret, and optionally Payout Authorization Token

Troubleshooting

  • Missing or incorrect API credentials will cause authentication errors. Ensure Client ID and Client Secret are configured for payment gateway operations, and Payout Authorization Token for Cashgram operations.
  • Invalid JSON format in 'Link Notes' property will cause parsing errors. Validate JSON before input.
  • Required fields such as Order Amount, Order Currency, Customer ID, and Customer Phone must be provided to avoid validation errors from the API.
  • Network or API endpoint issues may cause request failures. Verify environment setting (sandbox or production) and network connectivity.

Links

Discussion