By using Batch File you can continuously reward users for their activity on your online and offline channels. Rewarding becomes as easy as uploading a CSV file to a SFTP server.

Used with the Fanmiles Connect the Batch File integration is the most comprehensive and flexible loyalty tool Fanmiles offers to continuously reward customers.

Which actions can you reward?

Partners that integrate the Batch File Technology can reward any action imaginable that happens on any channel. The action is specified within the Batch File. It uses actions and objects.

The following overview shows use cases of the Fanmiles Batch File integration. 

Objects are the touchpoints a customer can perform actions on.   

Actions are the specific interaction a customer is performing.

Contact our developer support for further questions. We are happy to receive your inputs and discuss implementation ideas. Please contact us via developers@fanmiles.com.

Batch File allows you to make earn transactions with a standard CSV file

By using Batch File you can continously reward users for their activity on your online and offline channels. Rewarding becomes as easy as uploading a CSV file to a SFTP server.

Getting started

  1. Begin by setting up your Fanmiles Account
  2. Request access to our AdFan platform and we will create your Fanmiles Page, from which you can manage and track your loyalty campaigns.
  3. Once activated we will provide you with your App-ID and secret SFTP credentials, so that you can start uploading your Batch Files.
  4. Create a CSV file which contains an entry for each transaction that you want to make (Specifications available upon request).
  5. Connect to the Fanmiles SFTP server using a standard FTP client and upload the CSV file you created to the UPLOAD folder.

Additional Information

File Transfer

Fanmiles provides a SFTP server for downloading and uploading files. The SFTP server is accessible through the domain sftp.fanmiles.com on port 10222. A scheduled job will move uploaded files immediately to the internal Fanmiles Loyalty platform. For downloading and uploading files you need a SFTP client. The Fanmiles SFTP server is based on a Unix System and is working with case sensitive syntax.

Error Handling

The CSV file cannot be processed

In the case that there is an issue with the file structure or any other uncorrectable error, the complete file will not be processed and will be delivered back without any changes to the sender. In the event that this happens, the file must be corrected and sent again with the same filename.

Rows inside the CSV file cannot be processed

In the case that a CSV file can be parsed correctly, it will pass through all rows and begin processing transactions. Records which lead to errors or that cannot be processed, will be added to a newly generated error answer file. These records will be annotated with an error code and error message. The records need to be corrected and uploaded to the Fanmiles SFTP server using a new filename.

Download Specification

Contact our developer support for further questions. We are happy to receive your inputs and discuss implementation ideas. Please contact us via developers@fanmiles.com.

Did this answer your question?