CashFree Wallets via Pine Labs

Accept CashFree Wallets payments from customers in India with Pine Labs as the payment service provider (PSP). The customer goes to a Pine Labs payment page, confirms the payment in their wallet and returns to your site.

Supported workflows

Before you begin

Complete these steps before you send your first CashFree Wallets payment through Pine Labs:

Set up a Pine Labs integration in your workspace. The Payrails Portal lists it as PineLabs. Contact your Payrails account team if it isn’t listed yet.
Ask Pine Labs to enable CashFree Wallets on your Pine Labs merchant account.
In the Payrails Portal, go to Settings → Integrations, open your PineLabs integration, select CashFree Wallets under Payment methods, and save.
Add CashFree Wallets as a payment option in your workflow.

Request fields for Pine Labs

Send these fields in the authorize request, in addition to the standard authorize fields. Payrails checks Required fields and returns an error when one is missing. Fields required by the PSP pass the Payrails checks but the PSP can decline the payment without them.

Field	Status	Description
`amount.currency`	Required by Pine Labs	Send `INR`. Payrails sends the amount to Pine Labs in minor units, without a currency.
`meta.customer.email`	Optional	Sent to Pine Labs as the customer email.
`meta.customer.name`, `meta.customer.lastName`	Optional	Sent to Pine Labs as the customer’s first and last name.
`meta.customer.phone`	Optional	Sent to Pine Labs as the customer’s mobile number.
`meta.customer.reference`	Optional	Sent to Pine Labs as your customer ID.
`meta.order.billingAddress`	Optional	Sent to Pine Labs as the billing address.
`meta.order.deliveryAddress`	Optional	Sent to Pine Labs as the shipping address, including the recipient’s name and phone.

Authorize a CashFree Wallets payment

Call authorize a payment with cashFreeWallet as the paymentMethodCode. The response includes the redirect to the Pine Labs payment page.

Authorize request

{
  "amount": {
    "value": "500.00",
    "currency": "INR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "cashFreeWallet",
      "amount": {
        "value": "500.00",
        "currency": "INR"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Aarav",
      "lastName": "Sharma",
      "email": "aarav.sharma@example.com",
      "reference": "customer-1234",
      "phone": {
        "countryCode": "91",
        "number": "9876543210"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

After the customer approves the payment, Pine Labs returns them to your success or error URL. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How Pine Labs handles CashFree Wallets

Pine Labs accepts only instant capture. Payrails captures CashFree Wallets payments immediately, and capture or cancel requests aren’t available through Pine Labs.
Pine Labs serves its payment pages to customers with an Indian IP address.
When the customer returns, Payrails checks the signature on the Pine Labs response before it updates the payment.
Payrails sends full and partial refunds to Pine Labs against the original transaction.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

CashFree Wallets via Pine Labs

Supported workflows

Before you begin

Request fields for Pine Labs

Authorize a CashFree Wallets payment

How Pine Labs handles CashFree Wallets

​Supported workflows

​Before you begin

​Request fields for Pine Labs

​Authorize a CashFree Wallets payment

​How Pine Labs handles CashFree Wallets

Supported workflows

Before you begin

Request fields for Pine Labs

Authorize a CashFree Wallets payment

How Pine Labs handles CashFree Wallets