• Home
  • Merchants
  • Developers
  • Partners
  • Contact
  • Home
  • Merchants
  • Developers
  • Partners
  • Contact

HOME / Partner Docs / Virtual Terminal User Guide / Recurring and Installment Import Specifications

    Recurring and Installment Import Specifications

    367 views 0

    1. Recurring and Installment Import Overview

    Merchants with an existing database of customers on a recurring or installment payment plan can import that database into Charge Anywhere’s Virtual Terminal, saving time and reducing the potential for manual errors. This guide covers how to import your customer database into Charge Anywhere’s Virtual Terminal for recurring and installment payments.

    2. Charge Anywhere Recurring Import File Description and Specifications

    Recurring File Description: The recurring import setup uses a simple comma-delimited file format to import data.

    Fields must be in the following sequence:

    Conventions:

    • N – Numeric only.
    • AN – Alpha Numeric.
    • DATE – Date Format (DD/MM/YYYY)

    Note: An import file can only accommodate either recurring or installment payments at a time. Both recurring and installment payments cannot be included together within the same import file.

    Field NameFormatRequiredDescription
    Effective DateDATEREffective Date when the Payment Sequence will start (ex. 06/24/2019).
    FrequencyN1R0 = Daily
    1 = Weekly
    2 = Bi-Weekly
    3 = Monthly
    4 = Yearly
    5 = Quarterly
    6 = Semi-Annually
    Number Of PaymentsN1-4RequiredThe Number of Payments to be executed.
    Use (1) when unlimited number of payments in recurring, else use (0).
    Customer NumberAN50OptionalCustomer Number for the transaction.
    Payment TypeN1Required2 = Credit
    3 = ACH
    Account NumberN6-19RequiredCredit card number with no dashes or spaces (ex. 4446661234567892).
    Bank Account number with no dashes or spaces (ex. 123456789).
    Routing NumberAN9RequiredOnly applies when the payment type 3=ACH.
    Routing number of the ACH Account. Use blank if not used.
    Use blank when payment type is 2=Credit.
    Account TypeN1RequiredOnly applies when the payment type 3=ACH.
    0 = Personal Savings
    1 = Personal Checking
    2 = Business Checking
    Use blank when payment type is 2=Credit.
    Expiration DateAN4RequiredOnly applies when the payment type 2=Credit.
    Expiration Date for Card. (ex. 1224).
    Use blank when payment type is 3=ACH.
    AddressAN50OptionalStreet Address for the transaction.
    Zip CodeAN5-9OptionalZip Code for the transaction.
    Amount RequiredNo dollar signs allowed (ex. 1.01, 10.01).
    Recurring: Amount to process for the Frequency passed.
    Installment: Total Installment Amount.
    Invoice NumberAN50OptionalInvoice Number of the transaction.
    Full NameAN50OptionalOnly applies when the payment type 3=ACH.
    Full Name of the transaction.
    UnlimitedN1RequiredRecurring: (1) if Unlimited, else (0)
    Installment: always (0)

    3. Importing Your File

    1. Log into Transaction Manager. Select Recurring Database from the Virtual Terminal pull-down menu.

    2. Click Upload Recurring.

    3. You will be brought to the following screen which provides options to Download Recurring Import Template or to select an existing file and then import. 

    4. Click Download Recurring Import Template. You will see a download arrow at the top right of your screen. Click on it to access the template that you can populate.

    5. Populate the template according to the specifications provided above.

    6. Select Choose File to locate the file you created. Once selected, the file name will appear to the right of the Choose File button.

    7. Click Import.

    If there are any errors in the file, you will receive a message stating what needs correcting according to the specification. Otherwise, your file is uploaded and ready to be processed for recurring or installment payments. 

    Note: If you have customers on both recurring and installment payment plans, create one file for all recurring customers and a second file for all installment payment customers so that you can upload both.

    Was this helpful?

    Yes  No
    Previously
    Batch Transactions for Merchants Guide
    Up Next
    Advanced Integration Protocol

    This website and content contains confidential, trade secret information, which is proprietary to Charge Anywhere, LLC, and its subsidiaries (collectively “Charge Anywhere®”) and is provided solely for the recipient's use in connection with the recipient’s participation in one of the Charge Anywhere’s Payment Gateway Programs. Charge Anywhere reserves the right to make changes to the specifications at any time and without notice. The information furnished by Charge Anywhere in this publication is believed to be accurate and reliable as of the date of its release; however, no responsibility is assumed by Charge Anywhere for its use, nor for infringements of patents or other rights of third parties resulting from its use, nor for the violation, misinterpretation, or misapplication of any laws, or any regulation of any credit card association including Visa USA, Visa International, or MasterCard International. No general license is granted under any patents, copyrights, or other intellectual property rights owned by Charge Anywhere and the recipient is only granted an end user license to use this information for the purpose of participating in one of Charge Anywhere’s Payment Gateway Programs, pursuant to an agreement with Charge Anywhere or one of its authorized Program partners. All modifications or improvements to any of the information and specifications in this document shall belong exclusively to Charge Anywhere, LLC. No unauthorized copying, disclosure, or use of this document is permitted without the express written consent of the Charge Anywhere, LLC.

    • Privacy Policy
    • Terms of Use
    • Copyright 2025 Charge Anywhere. All Rights Reserved

    ×