Deep Offer API

Deep offers Product allows you to offer the customized offers i.e. discounts/cashback to your customers io order your platforms to increase their loyalty towards encouraging them to make transactions on your platforms regularly. You can now pass user and cart context while initiating a transaction with PhonePe. This context can be used to run differential offers and provide differential transaction experience. This is available for all the platforms (Web, Android, iOS)

Differential Offers

As a part of debit requests, merchants need to pass offer context in the following format:

  "merchantId": "M12345",
  "transactionId": "TX12345",
  "amount": 100,
  "mobileNumber": "91XXXXXX11",
  "merchantContext": {
    "offerContext": {
    "tags": [{
        "id": "GOLD_CATEGORY",
        "amount": 100 }]

Tag IDs are defined in two systems(Merchant’s and PhonePe’s) in advance operationally before starting the offer. For example, we wish to run an offer of 10% cashback upto Rs 50 for all Gold Category customers. In this case.

  1. A tag GOLD_CATEGORY is defined in both merchant’s and PhonePe’s system
  2. At PhonePe this tag is linked to an offer id that provides 10% cashback up to Rs 50
  3. Whenever a Gold Category customer transacts, Merchant passes tag id as GOLD_CATEGORY
  4. PhonePe applies the 10% cashback up to Rs 50 offer


  • Currently, the tag amount should be equal to the total amount, else transaction will fail
  • Merchants can pass more than one tag in tags array, in such cases we can apply best offer logic or can add up multiple offers depending on the offer configuration

Transaction Reversals

No impact on transaction reversals. The reversal signature remains the same.

Offer Discovery

Primary offer discovery should happen at the merchant's site. However, to ensure the user does not lose the transaction context, the offer information will be shown inside the PhonePe container as well. PFB the screenshot, how an offer is displayed for a user.