The getLogos API returns a zip file of 88x31 and 120x60 merchant logos. By default it includes your selected merchants; set complete=1 to include every merchant available to your account. Merchants without a logo on file are not included. Merchant screenshots (280x210 and 600x450) are not included in the zip; their URLs are returned by the getMerchants API.
For mapping purposes, logo names match the FMTC MerchantID. If a merchant changes networks, you will need to update your logos to reflect the new FMTC MerchantID.
Custom logos of any size can be added by the account holder. This feature must first be enabled in Feed Settings. You will then be able to add a custom logo on the Manage Merchants page by clicking the customize icon next to the merchant name. The image must be hosted on your own site and you simply need to provide us with the URL.
You can download logos on the Merchant Logos page or by using the getLogos API.
API Endpoints
-
getLogos
-
Description: Get logos for the merchants that FMTC supports.
-
Example Request: https://s3.fmtc.co/api/4.0.0/get-logos?api_token=API_KEY
-
What’s New?
-
Return an error upon mismatching request parameters.
getLogos
Request Parameters
|
Name |
Value(s) |
Description |
Required |
Default |
|---|---|---|---|---|
|
api_token |
APIKEY |
API key for authentication, available on the API Keys & Calls page. |
Yes |
N/A, must always be provided |
|
size |
String(s) 88x31 120x60 |
Specify the size of logo that you would like or omit it to receive all logo sizes. |
No |
|
|
merchantids |
Number(s) |
Comma-separated list of merchant IDs. Returns logos only for those merchants. Unless |
No |
|
|
sincedate |
Date |
Only return items added or modified since this date. The time pasted will be treated as UTC time. |
No |
|
|
complete |
0,1 |
If true, returns logos for all merchants available to your account. If false, returns logos for your selected merchants only. |
No |
0 |
Implementation
Response Elements
The response is a zip file of the logos, with one folder per size (88x31/, 120x60/). Each logo file is named with the FMTC Merchant ID (e.g. 88x31/12345.png). If no logos match, the response is JSON: {"message": "No data found"}.