POST
/
settlement
/
recon
curl --request POST \
  --url https://sandbox.cashfree.com/pg/settlement/recon \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "pagination": {
    "limit": 10,
    "cursor": "eyJzZWFyY2hBZnRlciI6eyJsaXN0IjpbMTg4NjcxNDVdLCJlbXB0eSI6ZmFsc2V9LCJyZWNvbkFQSVR5cGUiOiJMRURHRVIifQ=="
  },
  "filters": {
    "cf_settlement_ids": [
      "4234233"
    ],
    "settlement_utrs": [
      "utr1",
      "utr2"
    ],
    "start_date": "2022-07-20T00:00:00Z",
    "end_date": "2022-07-21T23:59:59Z"
  }
}'
{
  "cursor": "cursor",
  "limit": 7,
  "data": [
    {
      "cutomer_details": {
        "customer_bank_account_number": "1234567",
        "customer_bank_code": "123",
        "customer_bank_ifsc": "SBIN000123",
        "customer_email": "manideep.ellur@cashfree.com",
        "customer_id": "Manideep",
        "customer_name": "Manideep",
        "customer_phone": "8281554863"
      },
      "dispute_details": {
        "closed_in_favor_of": null,
        "dispute_category": null,
        "dispute_note": null,
        "dispute_resolved_on": null,
        "resolved_on": null
      },
      "event_details": {
        "entity": "recon",
        "event_amount": 200,
        "event_currency": "INR",
        "event_id": "43594",
        "event_remarks": "null,",
        "event_service_charge": 2,
        "event_service_tax": 0,
        "event_settlement_amount": 200,
        "event_status": "SUCCESS",
        "event_time": "2025-01-16T15:06:41+05:30",
        "event_type": "PAYMENT",
        "sale_type": "CREDIT"
      },
      "order_details": {
        "order_amount": 3000,
        "order_currency": "INR",
        "order_id": "order_1527072DQpGNwTMBlnAc1GfxmWalriHBG",
        "order_tags": {
          "key1": "value1",
          "key2": "value2"
        }
      },
      "payment_details": {
        "bank_reference": 210396,
        "cf_payment_id": "1234881617186388204",
        "charges_currency": "INR",
        "forex_conversion_handling_charge": 0,
        "forex_conversion_handling_tax": 0,
        "payment_amount": null,
        "payment_currency": "INR",
        "payment_mode": "CREDIT_CARD",
        "payment_service_charge": 2,
        "payment_service_tax": 0,
        "payment_time": null,
        "status": null
      },
      "refund_details": {
        "refund_arn": "null,",
        "refund_id": "null,",
        "refund_note": "null,",
        "refund_processed_at": null
      },
      "settlement_details": {
        "adjustment": null,
        "amount_settled": null,
        "cf_settlement_id": "1639775422",
        "payment_from": null,
        "payment_till": null,
        "reason": null,
        "remarks": null,
        "service_charge": null,
        "service_tax": null,
        "settlement_charge": null,
        "settlement_date": "2025-01-16T18:33:51+05:30",
        "settlement_initiated_on": "2025-01-16T15:33:51+05:30",
        "settlement_tax": null,
        "settlement_type": null,
        "split_service_charge": 0,
        "split_service_tax": 0,
        "utr": "PGI45406",
        "vendor_commission": 0
      }
    },
    {
      "cutomer_details": {
        "customer_bank_account_number": "1234567",
        "customer_bank_code": "123",
        "customer_bank_ifsc": "SBIN000123",
        "customer_email": "manideep.ellur@cashfree.com",
        "customer_id": "Manideep",
        "customer_name": "Manideep",
        "customer_phone": "8281554863"
      },
      "dispute_details": {
        "closed_in_favor_of": "MERCHANT",
        "dispute_category": "1402-Duplicate Processing",
        "dispute_note": "test",
        "dispute_resolved_on": "2025-01-16 10:15:10",
        "resolved_on": "2025-01-16 10:15:10"
      },
      "event_details": {
        "entity": "recon",
        "event_amount": 200,
        "event_currency": "INR",
        "event_id": "43594",
        "event_remarks": "null,",
        "event_service_charge": 2,
        "event_service_tax": 0,
        "event_settlement_amount": 200,
        "event_status": "SUCCESS",
        "event_time": "2025-01-16T15:06:41+05:30",
        "event_type": "DISPUTE",
        "sale_type": "DEBIT"
      },
      "order_details": {
        "order_amount": 3000,
        "order_currency": "INR",
        "order_id": "order_1527072DQpGNwTMBlnAc1GfxmWalriHBG",
        "order_tags": {
          "key1": "value1",
          "key2": "value2"
        }
      },
      "payment_details": {
        "bank_reference": 210396,
        "cf_payment_id": "1234881617186388204",
        "charges_currency": "INR",
        "forex_conversion_handling_charge": 0,
        "forex_conversion_handling_tax": 0,
        "payment_amount": null,
        "payment_currency": "INR",
        "payment_mode": "CREDIT_CARD",
        "payment_service_charge": 2,
        "payment_service_tax": 0,
        "payment_time": null,
        "status": null
      },
      "refund_details": {
        "refund_arn": "null,",
        "refund_id": "null,",
        "refund_note": "null,",
        "refund_processed_at": null
      },
      "settlement_details": {
        "adjustment": null,
        "amount_settled": null,
        "cf_settlement_id": "1639775422",
        "payment_from": null,
        "payment_till": null,
        "reason": null,
        "remarks": null,
        "service_charge": null,
        "service_tax": null,
        "settlement_charge": null,
        "settlement_date": "2025-01-16T18:33:51+05:30",
        "settlement_initiated_on": "2025-01-16T15:33:51+05:30",
        "settlement_tax": null,
        "settlement_type": null,
        "split_service_charge": 0,
        "split_service_tax": 0,
        "utr": "PGI45406",
        "vendor_commission": 0
      }
    },
    {
      "cutomer_details": {
        "customer_bank_account_number": "1234567",
        "customer_bank_code": "123",
        "customer_bank_ifsc": "SBIN000123",
        "customer_email": "manideep.ellur@cashfree.com",
        "customer_id": "Manideep",
        "customer_name": "Manideep",
        "customer_phone": "8281554863"
      },
      "dispute_details": {
        "closed_in_favor_of": null,
        "dispute_category": null,
        "dispute_note": null,
        "dispute_resolved_on": null,
        "resolved_on": null
      },
      "event_details": {
        "entity": "recon",
        "event_amount": 200,
        "event_currency": "INR",
        "event_id": "43594",
        "event_remarks": "FUND_SWEEP_REVERSAL",
        "event_service_charge": null,
        "event_service_tax": null,
        "event_settlement_amount": 200,
        "event_status": "SUCCESS",
        "event_time": "2025-01-16T15:06:41+05:30",
        "event_type": "FUND_SWEEP_REVERSAL",
        "sale_type": "CREDIT"
      },
      "order_details": {
        "order_amount": null,
        "order_currency": null,
        "order_id": null,
        "order_tags": null
      },
      "payment_details": {
        "bank_reference": null,
        "cf_payment_id": null,
        "charges_currency": null,
        "forex_conversion_handling_charge": null,
        "forex_conversion_handling_tax": null,
        "payment_amount": null,
        "payment_currency": null,
        "payment_mode": null,
        "payment_service_charge": null,
        "payment_service_tax": null,
        "payment_time": null,
        "status": null
      },
      "refund_details": {
        "refund_arn": "null,",
        "refund_id": "null,",
        "refund_note": "null,",
        "refund_processed_at": null
      },
      "settlement_details": {
        "adjustment": null,
        "amount_settled": null,
        "cf_settlement_id": "1639775422",
        "payment_from": null,
        "payment_till": null,
        "reason": null,
        "remarks": null,
        "service_charge": null,
        "service_tax": null,
        "settlement_charge": null,
        "settlement_date": "2025-01-16T18:33:51+05:30",
        "settlement_initiated_on": "2025-01-16T15:33:51+05:30",
        "settlement_tax": null,
        "settlement_type": null,
        "split_service_charge": 0,
        "split_service_tax": 0,
        "utr": "PGI45406",
        "vendor_commission": 0
      }
    }
  ]
}

Authorizations

x-client-id
string
header
required

Client app ID. You can find your app id in the merchant dashboard.

x-client-secret
string
header
required

Client secret key. You can find your secret in the merchant dashboard.

Headers

Content-Type
string

application/json

x-api-version
string
default:2025-01-01
required

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

x-request-id
string

Request ID for the API call. It can be used to resolve technical issues. Include this in your tech-related queries to Cashfree.

x-idempotency-key
string

An idempotency key is a unique identifier in your API call. If the request fails or times out, you can retry it with the same key to prevent duplicate actions.

Accept
string

application/json

Body

application/json
Request Body for the settlement reconciliation

Recon Request Object

pagination
object
required

To fetch the next set of settlements, pass the cursor received in the response to the next API call. To receive the data for the first time, pass the cursor as null. Limit would be number of settlements that you want to receive.

filters
object
required

Specify either the Settlement ID, Settlement UTR, or start date and end date to fetch the settlement details.

Response

200
application/json
OK

Recon object for settlement

cursor
string

Specifies from where the next set of settlement details should be fetched.

limit
integer

Number of settlements you want to fetch in the next iteration.

data
object[]