Skip to main content
Skip table of contents

How-to: Import a Recovery File (Merchant Portal)

Procedure

  • Log in

  • Access the Recovery Section

    • Navigate to the Main Menu and select Recovery.

  • Navigate to Import Files

    • Click the Import Files option.

  • Upload the Recovery File

    • Click Upload File button.

  • Select the Record Type

    • Select Recovery Item Batch as the record type that you are uploading.

  • (Optional) Select the Field Mapping Configuration

    • Select the Field Mapping Configuration that you are using. This is only necessary if you had a need to map fields from your system to our system.

  • Select the File

    • Click Browse Files or drag and drop the file you want to upload.

  • Confirm Upload

    • Click the Upload button once the file is selected.

  • Complete the Process

    • Click Done after the upload is complete.

  • Close the Upload Window

    • Click the Close button to exit the upload interface.

  • Review the Status

    • Check the Status column:

      • Processed means the file successfully created one or more payments.

      • Failed indicates an issue with processing; download the response file for more details.

  • Check the Results

    • Review the Results column to see the number of payments created.

  • (Optional) Download the Response File
    Tip: If the file failed or not all records were successfully created, download the Response File for detailed information.

    • Click Actions and then select Download Response File to view line-by-line results and any error messages.

File Upload Formats

Our system accepts files in .zip, .pdf, .ach, .x937, .x9, .937, .dat, and .icl formats.

Related Files

PaymentFile-Sample.xlsx - This example file shows you what the payment file should look like.

PaymentFile-Empty.xlsx - This is an empty file that you can use for uploading your payments.

Fields

The following table provides clarification on the fields contained in a payment file.

Field

Required

Description

MerchantId

Always

The unique Id of the originating Merchant to associate this transaction with.

This value will be provided to you when your Merchant account is setup.

Name

Required when Face_Transaction is PPD, CCD, TEL, WEB, RCK and Draft.

The name of the receiver. This is the person who wrote the original check or authorized the original payment.

Face_Amount

Always

The amount of the original item.

Original_Item_Date

Always

The date of the original item. This is the date on the original check or the date the original payment was authorized.

Return_Date

Always

The date the item was returned.

Route_Number

Always

The nine digit routing number of the financial institution.

Account_Number

Always

The account number at the financial institution.

Account_Type

Always

The type of account at the financial institution.

Values: GeneralLedger, BusinessChecking, BusinessSavings, PersonalChecking, PersonalSavings

Face_Transaction

Always

The NACHA Standard Entry Class Code for the ACH payment.

Values:

CCD - Use this code for business accounts EXCEPT if it was a business check

PPD - Use this code for debits to personal accounts when authorization was provided by signed agreement or when sending a credit to a personal account

RCK - Use this code if there was a personal check that was originally deposited at the bank and has since returned

TEL - Use this code for debits to personal accounts when oral authorization was obtained over the telephone

WEB - Use this code for debits to personal accounts when authorization was obtained in accordance with the requirements for internet-initiated entries

Return_Reason

Always

Check_Number

Required when Face_Transaction is ARC, BOC, POP, RCK or Draft.

Identification_Number

Optional

Typically this indicates an account number or identifier in the original system of record. The value in this field may be shown on the receivers bank statement.

ACH_Payment_Type_Code

Required when Face_Transaction is TEL or WEB.

Used to indicate additional information regarding TEL or WEB payments.

Values: S, R.

S = Authorization was for a single payment

R = Authorization was for a recurring payment

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.