On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/batch/user/all/so/batch-upload/batch-files-managing/batch-files-managing-template-create.md)  
Filter  
FILTER BY TAG

Create a Custom Batch File Template {#batch-files-managing-template-create}
===========================================================================

Custom batch file templates enable you to send batch files that contain information for transaction services not included with the standard template, such as direct debit and direct debit refunds. You must generate two transaction security keys---one for the ` Cybersource ` production environment and one for the test environment. For information about generating and using security keys, see the [*Creating and Using Security Keys*](https://developer.cybersource.com/docs/cybs/en-us/security-keys/user/all/ada/security-keys/keys-about-guide.md "") guide.

> Files that include non-ISO-8859-1 characters are processed, but the characters appear as question marks when you view the transaction details in the ` Business Center ` and in reports.

1. Follow these steps to create a custom template using a spreadsheet application or custom script:

2. Enter the file header information.

   #### ADDITIONAL INFORMATION

   These fields are required in the header:

   #### ADDITIONAL INFORMATION

   * merchantID: Your merchant identifier, which consists of up to 30 alphanumeric characters.
   * transactionType: The type of transaction requests contained in the batch file. Possible values:
     * `authorization`
     * `sale`
     * `capture`
     * `credit`
     * `ecDebit`
     * `ecCredit`
   * statusEmail: Email address where *batch status alerts* are sent.
   * recordCount: Change the value from 0 (which is invalid) to the number of transactions (data records) in the file.
   * targetAPIVersion
3. Add this text string at the end of the file header, and make sure to include the leading comma:

   #### ADDITIONAL INFORMATION

   ```
   ,Template=custom
   ```

   #### ADDITIONAL INFORMATION

   This example shows the header portion of a custom batch file template:

   ```
   merchantID=infodev,batchID=12345,creationDate=2007-06-12,
   recordCount=3,purchaseTotals_currency=USD,statusEmail=test@example.com,
   targetAPIVersion=1.90,
Template=custom
   ```
4. Following the file header, beginning in row 4, add a data record for each payment transaction request.

   #### ADDITIONAL INFORMATION

   When you create a custom template from a standard template, request fields do not have to be in a specific order. For information about the supported fields in a transaction request, see [Reference: Request Fields for Batch Files](/docs/cybs/en-us/batch/user/all/so/batch-upload/batch-ref-fields.md "").

5. Save the template.  
   RELATED TO THIS PAGE