Wildfire APIs

Country filtering and multiple applications

2min

Wildfire supports flexible use cases for partners that have user audiences in one or more countries.  Wildfire supports some use cases by creating separate applications that use discrete country-specific business rules.

Partners have access to all merchant offers in our JSON feeds, across all countries.  

An application can be limited to one or more serviceable countries. A serviceable country indicates that the merchant ships to the country.

Single Country Scenarios

US-Only Example: An application configured to be limited to US-servicing merchants will exclude programs that don’t explicitly ship to the US.  This model supports international merchants that are based outside the US but ship to the US as well as US-based merchants.

If an application needs to serve users in multiple countries (i.e. AU-based users and CA-based users), we suggest creating an application for each country/user market.  Each application can then be configured to filter only merchants that service the respective country.

Multiple Country Scenarios

Canada and Australia Example: A partner that has users in Australia and Canada would have Wildfire create two applications: One application for the partners' Australian users and another for Canadian users.

The Australia application would filter out merchants that don’t service Australia.  A merchant that services both Australia and Canada would be present in both applications but a merchant that only services Australia would not be present in the Canada application.  Similarly, a merchant that services both Australia and Canada but offers a different MaxRate (maximum cashback amount) would ensure that users see the correct MaxRate for their location.