The Ifeelgoods API enables you to generate printable e-cards that you can deliver directly to your end-users. This generated PDF, approved by the brands, contains all the information required for your customers to use their e-cards in store or online when appropriated.

This feature does not require you to integrate another API method. You can simply retrieve the link to the PDF in the reward_codes object in the response of the Redeem or Create and Redeem APIs. Find the object where usage is printable_document_url and retrieve value.

{
  "reward_codes": {
    "codes": [
      // ...
      {
        "name": "Printable document",
        "value": "https://app-sandbox.ifeelgoods.com/print/ecard/vx8zk-57tg3?o=1&t=6189c239c361dfb0a0a6f240678caddd",
        "format": "url",
        "usage": "printable_document_url"
      },
      // ...
    ]
    }
}

Another way is to change the media type you expect the Ifeelgoods API to return. Instead of asking for application/json in the Redeem or in the Create and Redeem methods, ask for application/pdf.

This will return the PDF as a binary octet stream. From here, you can store the response in a file or attach it to an email to make your customer enjoy it !

Personalize the message

The message and sender name in the PDF can be personalized. Simply send the following parameters with your redemption request:

data.customization.pdf.message
data.customization.pdf.sender_name

Exemple:

"data": {
  "user": { "email": "xxxxxxx@yyyyy.fr" },
  "order_id": "12345678987654",
  "value": { "amount": 150 },
  "customization": {
    "pdf": {
      "message": "I hope you enjoy this little gift.",
      "sender_name": "Daddy"
    }
  }
},