|
| 1 | +--- |
| 2 | +title: Commercial-feeds.md |
| 3 | +description: Commercial feeds |
| 4 | +--- |
| 5 | +# Overview |
| 6 | +Commercial feeds are the most reliable way to import company card expenses. They remain unaffected by changes to bank login credentials or UI updates, making them highly recommended for those eligible. |
| 7 | +The easiest way to confirm your eligibility for a commercial feed is to ask your bank directly. |
| 8 | +# Prerequisites for enabling a commercial feed |
| 9 | +If you haven't already, you need to create a workspace before setting up a commercial feed. Go to Settings > Workspaces > New workspace to create one. |
| 10 | +Additionally, you’ll need to enable company cards on your workspace by navigating to Settings > Workspaces > [your workspace] > More features, and toggling on Company cards. Note that upgrading to the Control plan is required to access this feature. |
| 11 | +# How to set up a Mastercard commercial feed |
| 12 | +Your bank must access Mastercard's SmartData portal to complete the process. Expensify is a registered vendor in the portal, so no additional Mastercard forms are required. Your bank may, however, have its own forms. |
| 13 | +## Steps to add a Mastercard commercial feed: |
| 14 | +Contact your banking relationship manager and request that your CDF (Common Data File) feed be sent directly to Expensify in the Mastercard SmartData Portal (file type: CDF version 3 Release 11.01). Specify the earliest transaction date you need in the feed. |
| 15 | +The bank will initiate feed delivery by selecting Expensify in Mastercard's portal and will email you the distribution ID. |
| 16 | +While waiting for your bank, ensure your Control plan workspace in Expensify is set up. |
| 17 | +Submit the distribution ID in Expensify by navigating to Settings > Workspaces > [your workspace] > Company cards > Add cards, selecting your bank (choose "Other" if not listed), and then selecting Mastercard Commercial Cards. |
| 18 | +Once submitted, Expensify will connect the feed and notify you when it’s enabled. |
| 19 | +# How to set up a Visa commercial feed |
| 20 | +## Steps to add a Visa commercial feed: |
| 21 | +Contact your banking relationship manager and request that your VCF (Variant Call Format) feed be sent directly to Expensify. Share this with your bank: "There’s a checkbox in your Visa Subscription Management portal that can be selected to enable the feed, eliminating the need for a test file." |
| 22 | +Request the feed filename or raw file information, including the Processor ID, Financial Institution (bank) ID, and Company ID. |
| 23 | +While waiting for your bank, ensure your Control plan workspace in Expensify is set up. |
| 24 | +Submit the required IDs in Expensify by navigating to Settings > Workspaces > [your workspace] > Company cards > Add cards, selecting your bank (choose "Other" if not listed), and then selecting Visa Commercial Cards. |
| 25 | +Once submitted, Expensify will connect the feed and notify you when it’s enabled. |
| 26 | + |
| 27 | +# How to set up an American Express corporate feed |
| 28 | +To begin, fill out Amex's required forms and send them to Amex for processing. Download the forms [here](https://drive.google.com/file/d/1zqDA_MCk06jk_fWjzx2y0r4gOyAMqKJe/view?usp=sharing). |
| 29 | + |
| 30 | +## Instructions for filling out the Amex forms: |
| 31 | +PAGE 1 |
| 32 | +Corporation Name: The legal name of your company on file with American Express |
| 33 | +Corporation Address: The legal address of your company |
| 34 | +Requested Feed Start Date: The earliest transaction date you want in Expensify (use international date format: DD/MM/YY or spelled out, e.g., January 1, 1900). |
| 35 | +Requestor Contact: Name of the person completing the request |
| 36 | +Email Address: Email of the person completing the request |
| 37 | +Control Account Number: The master or basic control account number for the cards you’d like to add (not a credit card number). Contact Amex if you need assistance identifying the correct number. |
| 38 | +PAGE 2 |
| 39 | +No information required |
| 40 | +PAGE 3 |
| 41 | +Client Registered Name: The legal name of your company on file with American Express |
| 42 | +Master Control Account or Basic Control Account: Same as the control account number on page 1 |
| 43 | +PAGE 4 |
| 44 | +Country List: The country where the account originates |
| 45 | +Client Authorization: Complete your full name, job title, and date (use international date format i.e., DD/MM/YY). Sign where indicated. |
| 46 | + |
| 47 | + |
| 48 | +## Steps to add an American Express corporate feed: |
| 49 | +Send the completed forms to electronictransmissionsteam@aexp.com and request they send your corporate card feed to Expensify. You should receive a confirmation email within a few days. |
| 50 | +While waiting, ensure your Control plan workspace in Expensify is set up. |
| 51 | +Amex will send a Production Letter with delivery file name information (e.g., R123456_B123456789_GL1025_001_$DATE$$TIME$_$SEQ$). |
| 52 | +Submit the delivery file name in Expensify by navigating to Settings > Workspaces > [your workspace] > Company cards > Add cards > American Express > American Express Corporate Cards. |
| 53 | +Once submitted, Expensify will connect the feed and notify you when it’s enabled. |
| 54 | + |
| 55 | +# How to assign company cards |
| 56 | +Once your feed is connected, you can assign cards to employees. To do this, navigate to Settings > Workspaces > [your workspace] > Company cards. |
| 57 | + |
| 58 | +{:width="100%"} |
| 59 | + |
| 60 | +If you have multiple feeds, click the feed name at the top left to select the appropriate one. |
| 61 | + |
| 62 | +{:width="100%"} |
| 63 | + |
| 64 | +Click Assign card to select an employee. All workspace members appear in the list. |
| 65 | + |
| 66 | +{:width="100%"} |
| 67 | + |
| 68 | +Select the card you want to assign. Cards only appear if they have recent transactions. |
| 69 | + |
| 70 | +{:width="100%"} |
| 71 | + |
| 72 | +Choose a start date: |
| 73 | +From the beginning: Imports all available transactions (typically 30-90 days). |
| 74 | +Custom start date: Allows you to specify a date. |
| 75 | +{:width="100%"} |
| 76 | +Review the details and click Assign card. Transactions will import immediately. |
| 77 | +{:width="100%"} |
| 78 | + |
| 79 | +# Managing cards |
| 80 | +Clicking an assigned card opens the Card details page, where you can: |
| 81 | +Change the card name. |
| 82 | +Select a card-specific export account (if connected to accounting software like QuickBooks, NetSuite, Xero, etc.). |
| 83 | +Update the card to pull recent transactions. |
| 84 | +Unassign the card (note: unassigning deletes unsubmitted expenses on draft reports in the cardholder’s account). |
| 85 | +{:width="100%"} |
| 86 | + |
| 87 | +{% include faq-begin.md %} |
| 88 | + |
| 89 | +## My commercial feed is connected. Why is a specific card not appearing for assignment? |
| 90 | +Cards appear for assignment if they’re active and have at least one recent transaction. If a card meeting these criteria doesn’t appear, contact your account manager or message concierge@expensify.com. |
| 91 | + |
| 92 | +## Is there an extra fee for using commercial feeds? |
| 93 | +No, commercial feed setup is included in the Control plan. |
| 94 | + |
| 95 | +## What’s the difference between a direct feed and commercial feed? |
| 96 | +Direct feeds use login credentials for quick setup, but can require re-authenticating from time to time. Commercial feeds require bank involvement for setup but offer the most reliable connection. |
| 97 | + |
| 98 | +## I have a Small Business Amex account. Am I eligible to set up a commercial feed? |
| 99 | +Small Business or Triumph Amex accounts may not be eligible for a commercial feed and might need to use an Amex direct feed. |
| 100 | + |
| 101 | +## Are commercial feeds the best option if my bank isn’t one where Expensify supports direct feeds? |
| 102 | +Yes. If direct feeds are not available for your bank, commercial feeds are the best option for importing company card transactions. Currently, Expensify supports direct feeds for: |
| 103 | +American Express |
| 104 | +Bank of America |
| 105 | +Brex |
| 106 | +Capital One |
| 107 | +Chase |
| 108 | +Citibank |
| 109 | +Stripe |
| 110 | +Wells Fargo |
| 111 | + |
| 112 | + |
| 113 | +{% include faq-end.md %} |
| 114 | + |
| 115 | + |
| 116 | + |
0 commit comments