Cashfree Payments Developer Documentation

Get Import Settlement Recon Details

curl --request POST \
  --url https://sandbox.cashfree.com/import/settlements/recon \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <x-client-id>' \
  --header 'x-client-secret: <x-client-secret>' \
  --data '
{
  "filter": {
    "start_date": "2025-09-01T01:01:01.00+05:30",
    "end_date": "2025-09-02T01:01:01.00+05:30",
    "cf_ica_settlement_ids": [
      123
    ],
    "settlement_utrs": [
      "UTR123456789"
    ]
  },
  "pagination": {
    "limit": 123,
    "cursor": "<string>"
  }
}
'

{
  "cursor": null,
  "limit": 1,
  "data": [
    {
      "event_id": "5114910810523",
      "entity": "recon",
      "event_type": "PAYMENT",
      "sale_type": "CREDIT",
      "event_time": "2024-08-02T13:32:27+05:30",
      "event_settlement_amount": 49856.58,
      "event_amount": 51000,
      "event_status": "SUCCESS",
      "event_currency": "INR",
      "order_id": "6f9db742-e423-40ed-afee-2e7898b98c9e",
      "customer_name": "Rachit",
      "customer_phone": "9101496247",
      "customer_email": "[email protected]",
      "cf_payment_id": null,
      "payment_amount": null,
      "order_amount": 51000,
      "payment_time": null,
      "payment_service_charge": 969,
      "payment_service_tax": 174.42,
      "payment_utr": "123",
      "cf_ica_settlement_id": 7,
      "vendor_commission": 0,
      "split_service_charge": 0,
      "split_service_tax": 0,
      "settlement_utr": null,
      "refund_note": null,
      "refund_id": null,
      "refund_arn": null,
      "refund_processed_at": null,
      "closed_in_favor_of": null,
      "resolved_on": null,
      "dispute_category": null,
      "dispute_note": null,
      "dispute_resolved_on": null,
      "adjustment_remarks": null,
      "adjustment": null,
      "service_tax": null,
      "service_charge": null,
      "amount_settled": null,
      "payment_from": null,
      "payment_till": null,
      "reason": null,
      "settlement_initiated_on": null,
      "settlement_settled_on": null,
      "settlement_type": null,
      "settlement_charge": null,
      "settlement_tax": null,
      "payment_group": "UPI",
      "remarks": null
    }
  ]
}

POST

import

settlements

recon

Get Import Settlement Recon Details

curl --request POST \
  --url https://sandbox.cashfree.com/import/settlements/recon \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <x-client-id>' \
  --header 'x-client-secret: <x-client-secret>' \
  --data '
{
  "filter": {
    "start_date": "2025-09-01T01:01:01.00+05:30",
    "end_date": "2025-09-02T01:01:01.00+05:30",
    "cf_ica_settlement_ids": [
      123
    ],
    "settlement_utrs": [
      "UTR123456789"
    ]
  },
  "pagination": {
    "limit": 123,
    "cursor": "<string>"
  }
}
'

{
  "cursor": null,
  "limit": 1,
  "data": [
    {
      "event_id": "5114910810523",
      "entity": "recon",
      "event_type": "PAYMENT",
      "sale_type": "CREDIT",
      "event_time": "2024-08-02T13:32:27+05:30",
      "event_settlement_amount": 49856.58,
      "event_amount": 51000,
      "event_status": "SUCCESS",
      "event_currency": "INR",
      "order_id": "6f9db742-e423-40ed-afee-2e7898b98c9e",
      "customer_name": "Rachit",
      "customer_phone": "9101496247",
      "customer_email": "[email protected]",
      "cf_payment_id": null,
      "payment_amount": null,
      "order_amount": 51000,
      "payment_time": null,
      "payment_service_charge": 969,
      "payment_service_tax": 174.42,
      "payment_utr": "123",
      "cf_ica_settlement_id": 7,
      "vendor_commission": 0,
      "split_service_charge": 0,
      "split_service_tax": 0,
      "settlement_utr": null,
      "refund_note": null,
      "refund_id": null,
      "refund_arn": null,
      "refund_processed_at": null,
      "closed_in_favor_of": null,
      "resolved_on": null,
      "dispute_category": null,
      "dispute_note": null,
      "dispute_resolved_on": null,
      "adjustment_remarks": null,
      "adjustment": null,
      "service_tax": null,
      "service_charge": null,
      "amount_settled": null,
      "payment_from": null,
      "payment_till": null,
      "reason": null,
      "settlement_initiated_on": null,
      "settlement_settled_on": null,
      "settlement_type": null,
      "settlement_charge": null,
      "settlement_tax": null,
      "payment_group": "UPI",
      "remarks": null
    }
  ]
}

Headers

x-client-id

string

required

Client ID generated from the merchant dashboard.

x-client-secret

string

required

Client secret generated from the merchant dashboard.

x-api-version

string

default:2023-08-01

required

API version to be used. Format is in YYYY-MM-DD.

Body

application/json

filter

object

required

Show child attributes

filter.start_date

string

Start date for fetching settlement recon details.

Example:

"2025-09-01T01:01:01.00+05:30"

filter.end_date

string

End date for fetching settlement recon details.

Example:

"2025-09-02T01:01:01.00+05:30"

filter.cf_ica_settlement_ids

number[]

List of ICA Settlement IDs for fetching related recon events

filter.settlement_utrs

string[]

List of ICA Settlement UTRs for fetching corresponding recon events

pagination

object

required

Show child attributes

pagination.limit

number

Limit on number of entries to fetch

pagination.cursor

string

Cursor from which entries to be fetched

Response

Success response for getting the import settlement recon details.

cursor

object

Cursor for pagination, used to fetch the next set of results

limit

number

Maximum number of records to return per page

Example:

3

data

object[]

Show child attributes

data.event_id

string

Unique identifier for the event

Example:

"14934603727"

data.entity

string

Entity associated with the event

Example:

"recon"

data.event_type

string

Type of the event (e.g., PAYMENT, REFUND)

Example:

"PAYMENT"

data.sale_type

string

Type of sale (e.g., CREDIT, DEBIT)

Example:

"CREDIT"

data.event_time

string

Time when the event occurred

Example:

"2024-06-17T23:28:19+05:30"

data.event_settlement_amount

object

Amount related to the settlement of the event

data.event_amount

number

Amount involved in the event

Example:

10000

data.event_status

string

Status of the event (e.g., SUCCESS, FAILURE)

Example:

"SUCCESS"

data.event_currency

string

Currency used for the event

Example:

"INR"

data.order_id

string

Unique identifier for the order associated with the event

Example:

"da34745f-70e9-4c9b-9dcd-1c7aed01b7a6"

data.customer_name

string

Name of the customer associated with the event

Example:

"Rachit"

data.customer_phone

string

Phone number of the customer

Example:

"9101496247"

data.customer_email

string

Email address of the customer

Example:

"[email protected]"

data.cf_payment_id

object

Payment ID

data.payment_amount

object

Amount of payment made

data.order_amount

number

Total order amount

Example:

10000

data.payment_time

object

Time when the payment was processed

data.payment_service_charge

object

Service charge applied to the payment

data.payment_service_tax

object

Tax applied to the service charge

data.payment_utr

string

Unique transaction reference for the payment

Example:

"123"

data.cf_ica_settlement_id

object

Unique ID for the settlement associated with the event

data.vendor_commission

object

Commission paid to the vendor

data.split_service_charge

object

Split service charge, if applicable

data.split_service_tax

object

Split service tax, if applicable

data.settlement_utr

object

Unique transaction reference for the settlement

data.refund_note

object

Notes related to any refund issued

data.refund_id

object

Unique ID for the refund

data.refund_arn

object

ARN (Acquirer Reference Number) for the refund

data.refund_processed_at

object

Date and time when the refund was processed

data.closed_in_favor_of

object

Indicates if the case was closed in favor of any party

data.resolved_on

object

Date and time when the dispute or issue was resolved

data.dispute_category

object

Category of the dispute, if applicable

data.dispute_note

object

Notes related to the dispute, if applicable

data.dispute_resolved_on

object

Date and time when the dispute was resolved

data.adjustment_remarks

object

Any remarks regarding adjustments made to the event

data.adjustment

object

Adjustment amount, if applicable

data.service_tax

object

Tax on the service, if applicable

data.service_charge

object

Charge for the service, if applicable

data.amount_settled

object

Amount that has been settled for the event

data.payment_from

object

Start time of the payment period

data.payment_till

object

End time of the payment period

data.reason

object

Reason for the event or transaction

data.settlement_initiated_on

object

Date and time when the settlement was initiated

data.settlement_settled_on

object

Date and time when the settlement was completed

data.settlement_type

object

Type of settlement (e.g., Full, Partial)

data.settlement_charge

object

Charges applied during settlement

data.settlement_tax

object

Tax applied during settlement

data.payment_group

string

Payment group used for the transaction (e.g., UPI, Credit Card)

Example:

"UPI"

data.remarks

object

Additional remarks related to the event

Get Import Settlement Details Webhooks

⌘I

Payments API

v2025-01-01

Other Versions

Get Import Settlement recon details

Headers

Body

Response