Gift Card
There are two different payment methods for the customers to redeem the Cash Back in their account.
- PayPal (multiple currencies supported)
- Gift Card (USD only at this time)
Gift Card is a payment method where the user who has a redeemable amount greater than 5 USD can receive a gift card of a supported merchant of their choice. Wildfire currently only supports redeeming the full amount available in the user's account. There are three API endpoints:
- Get Redeemable Amount
- Redeem (create a gift card redemption link)
- Get Redemption History
The get redeemable amount call will return the balance of a user's account. This is useful for determining if a user is eligible for a Gift Card based on the minimum 5 USD threshold required to redeem.
Endpoint : https://api.wfi.re/v2/giftcard/:device_id/redeemable
Method : GET
Parameters
device_id (Required): The device id of the user. Note: If a user has multiple devices, any device ID associated with the user will return the same redeemable amount.
Sample response
Amount: Amount available to redeem for the particular user.
- If a request is sent for a device id that isn't associated with the application, the API will respond with the following.
- If there is no rewards associated with the sender id, the API will respond with the following.
Note that "sender" is a reference to your user ID. This response denotes that any of the associated devices can be passed into this API but the response is not specific to that device.
- If there is no sender id associated with the device id, the API will respond with the following.
This POST call will give all the details of a user along with the URL to redeem the Gift Card and amount available to redeem.
Endpoint: https://api.wfi.re/v2/giftcard
Method: POST
Request Body:
deviceID (Required): The device ID of a user which may or may not be the same as the one in the previous Get Redeemable Call (a user can have multiple device IDs)
Sample response
- senderID: The ID of the user. Unlike device ID, sender ID is unique to a logged-in user.
- url: Unique URL generated by Wildfire which is a direct link to redeem the newly-generated Gift Card on Reward Link website. This URL should not be shared with anyone. Since there is no additional security around using this URL to redeem, it should be considered the same as cash.
To test the URL one can copy and paste it into any browser to be redirected to the Reward Link redemption website.
- If a request is made without a device id, the API will respond with the following.
- User account balance should be greater than 5 USD for the user to redeem the gift card. If the user account balance is less than 5 USD the API will respond with the following.
- If a request is sent for a device id that isn't associated with the application, the API will respond with the following.
- If there is no rewards associated with the sender id, the API will respond with the following.
- If there is no sender id associated with the device id, the API will respond with the following.
The Get Redemption History call returns all the previous redemptions for a given user based on any of their device IDs.
Endpoint: https://api.wfi.re/v2/giftcard?device_id=9318216
Parameters
device_id (Required): Any device ID associated with the user.
Sample response
- senderID: The ID of the user. Unlike device ID, sender ID is unique to a logged-in user.
- amount: Amount redeemed by the user (which is the same as the entire redeemable amount at the time of request for a Gift Card).
- url: Unique URL generated by Wildfire which is direct link to redeem the Gift Card in the Reward Link website.
- createdDate: The date which the user requested the Gift Card.
- If a request is made without a device id, the API will respond with the following.
- If the user sends a wrong device id, user will receive below error message
- If a request is made with the wrong device id (i.e. a device ID not associated with the application), the API will respond with the following.
- If there is no redeemable links associated with the sender id, the API will respond with the following.
- If there is no sender id associated with the device id, the API will respond with the following.