PATCH
/
orders
/
{order_id}

Authorizations

x-client-id
string
headerrequired

Client app ID. You can find your app id in the Merchant Dashboard.

x-client-secret
string
headerrequired

Client secret key. You can find your secret in the Merchant Dashboard.

Headers

x-api-version
string
default: 2023-08-01required

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

x-request-id
string

Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree

x-idempotency-key
string

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

Path Parameters

order_id
string
required

The id which uniquely identifies your order

Body

application/json

Request to terminate an active order at Cashfree

order_status
string
required

To terminate an order, pass order_status as "TERMINATED". Please note, order might not be terminated - confirm with the order_status in response. "TERMINATION_REQUESTED" states that the request is recieved and we are working on it. If the order terminates successfully, status will change to "TERMINATED". Incase there's any active transaction which moved to success - order might not get terminated.

Response

200 - application/json

The complete order entity

cf_order_id
string

unique id generated by cashfree for your order

order_id
string

order_id sent during the api request

entity
string

Type of the entity.

order_currency
string

Currency of the order. Example INR

order_amount
number
order_status
string

Possible values are

  • ACTIVE: Order does not have a sucessful transaction yet
  • PAID: Order is PAID with one successful transaction
  • EXPIRED: Order was not PAID and not it has expired. No transaction can be initiated for an EXPIRED order. TERMINATED: Order terminated TERMINATION_REQUESTED: Order termination requested
payment_session_id
string
order_expiry_time
string
order_note
string

Additional note for order

created_at
string

When the order was created at cashfree's server

order_splits
object[]
customer_details
object

The customer details that are necessary. Note that you can pass dummy details if your use case does not require the customer details.

order_meta
object

Optional meta details to control how the customer pays and how payment journey completes

order_tags
object

Custom Tags in thr form of {"key":"value"} which can be passed for an order. A maximum of 10 tags can be added

cart_details
object

Cart Details in the Order Entity Response