POST
/
offers
curl --request POST \
  --url https://sandbox.cashfree.com/pg/offers \
  --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 '{
  "offer_meta": {
    "offer_title": "Test Offer",
    "offer_description": "Offer Description",
    "offer_code": "CFTESTOFFER",
    "offer_start_time": "2023-03-21T08:09:51Z",
    "offer_end_time": "2024-03-21T08:09:51Z"
  },
  "offer_tnc": {
    "offer_tnc_type": "text",
    "offer_tnc_value": "Terms and Condition of the Offer"
  },
  "offer_details": {
    "offer_type": "DISCOUNT_AND_CASHBACK",
    "discount_details": {
      "discount_type": "flat",
      "discount_value": "10",
      "max_discount_amount": "10"
    },
    "cashback_details": {
      "cashback_type": "percentage",
      "cashback_value": "10",
      "max_cashback_amount": "10"
    }
  },
  "offer_validations": {
    "min_amount": 15,
    "max_allowed": 100,
    "payment_method": {
      "card": {
        "type": [
          "cc"
        ],
        "bank_name": "hdfc bank",
        "scheme_name": [
          "visa"
        ]
      }
    }
  }
}'

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

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

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.

Body

application/json

create offer backend request object

​
offer_details
object
required

Offer details and type

​
offer_meta
object
required

Offer meta details object

​
offer_tnc
object
required

Offer terms and condition object

​
offer_validations
object
required

Offer validation object

Response

200 - application/json

Offer entity object

​
offer_details
object

Offer details and type

​
offer_id
string
​
offer_meta
object

Offer meta details object

​
offer_status
string
​
offer_tnc
object

Offer terms and condition object

​
offer_validations
object

Offer validation object

Was this page helpful?

Get eligible Payment MethodsGet Offer by ID