POST
/
import
/
transactions
/
{cf_payment_id}
curl --request POST \
  --url https://sandbox.cashfree.com/import/transactions/{cf_payment_id} \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <x-client-id>' \
  --header 'x-client-secret: <x-client-secret>' \
  --form 'importer_name=<string>' \
  --form 'invoice_number=<string>' \
  --form invoice_file=@/path/to/file.pdf
{
  "uploaded_documents": [
    {
      "doc_name": "shop_or_brand_name",
      "doc_type": "VALUE",
      "doc_status": "VERIFIED",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    },
    {
      "doc_name": "invoice_number",
      "doc_type": "VALUE",
      "doc_status": "VERIFIED",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    },
    {
      "doc_name": "importer_name",
      "doc_type": "VALUE",
      "doc_status": "IN_REVIEW",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    },
    {
      "doc_name": "invoice_file",
      "doc_type": "DOCUMENT",
      "doc_status": "IN_REVIEW",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    }
  ],
  "missing_documents": [
    {
      "doc_name": "ecommerce_order_serial_number",
      "doc_type": "VALUE",
      "doc_status": "ACTION_REQUIRED",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    },
    {
      "doc_name": "hs_code",
      "doc_type": "VALUE",
      "doc_status": "ACTION_REQUIRED",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    },
    {
      "doc_name": "shipment_date",
      "doc_type": "VALUE",
      "doc_status": "ACTION_REQUIRED",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    },
    {
      "doc_name": "port_of_loading",
      "doc_type": "VALUE",
      "doc_status": "ACTION_REQUIRED",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    },
    {
      "doc_name": "awb_number",
      "doc_type": "VALUE",
      "doc_status": "ACTION_REQUIRED",
      "remarks": null,
      "added_on": null,
      "last_updated_on": null
    }
  ],
  "errors": []
}

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
required

API version to be used. Format is in YYYY-MM-DD. Ensure to pass 2025-01-01 in header to ensure this version is invoked.

Path Parameters

​
cf_payment_id
integer
required

Successful payment id for the created order.

Body

multipart/form-data · object

The request body can include multiple document entries. Each key represents a valid doc_name. The value for each key can be either:

  • A string (when doc_type is VALUE)
  • A file (when doc_type is DOCUMENT)

Response

200
application/json

This response can represent either a successful upload (when all documents are processed correctly) or a partial success (when some documents are successfully uploaded while others are missing or encountered errors). - Full Success: All documents are uploaded and processed without any issues. - Partial Success: Some documents are uploaded successfully, but others are either missing or encountered errors. - If documents are missing or errors occur, these will be returned in the response in the missing_documents or errors fields.

The response is of type object.