Issuing cheques using batch files
In MAS, you submit cheque payments using a batch file. Single cheque payments are not supported.
Upload your batch file here: MAS > Money Out > Batches.
Each row in the batch file generates a separate payment instruction.
For more information about batch processing and batch file structure, see Using batch files.
Required fields for cheque batches
Create a .CSV batch file using the headers below.
Fields marked with * are mandatory. Bracketed asterisks (*) are for mandatory parameters with exceptions.
Header | Description | Example |
|---|---|---|
| How you want to send the cheque. Use | PostalCheque |
| The Vitesse account ID that funds the cheque. | 999 |
| Currency code for the amount sent. You can send cheques to the US from other countries. | GBP |
| The payment amount. We recommend that the amount includes two decimal places. There is no value limit for cheques. | 1250.00 |
| Legal recipient name that is printed on the cheque. Separate multiple names with a comma, or 'and'. Maximum length 180 characters. | Michael Thompson and Amy Thompson |
| The country where the recipient resides. For cheques, you must use | US |
| Currency in which the cheque is issued. For cheques, you must use | USD |
| The text shown on the cheque memo line. | Property Damage Claim-45821 |
RecipientAddress* |
| For address fields and validation rules, see Structured postal address format. |
|
The recipient’s email address. |
Optional fields for cheque batches
Optional fields include envelope and reconciliation data (for example PostalRecipientName, ExternalReference) and remittance metadata.
Fields prefixed with X- appear in the remittance advice on an additional page of the cheque document.
Add the relevant headers in the .CSV batch file:
| Header | Description | Example |
|---|---|---|
PostalRecipientName | Additional field for postal cheque recipient address. The For Attention Of name printed on the envelope. | Michael Thompson |
PostalRecipientCompanyName | Additional field for postal cheque recipient address. The company name to print on the envelope. | Vitesse PSP Limited |
ExternalReference1 | Vitesse automatically populates this field with the generated cheque number. If your integration maps another value to ExternalReference1, we append the cheque number to that value. | 182910 |
ExternalReference2 | Optional external metadata field for reporting or reconciliation purposes, for example a claim or reconciliation reference. | CLM-45821 |
ExternalReference3 | Optional external metadata field for reporting or reconciliation purposes, for example a claim or reconciliation reference. | Loss Settlement Q1 |
X-ClaimantName | Name of the claimant associated with the cheque payment. | Laura Bennett |
X-CheckDate | Date printed on the cheque, in ISO 8601 format: YYYY-MM-DD. | 2024-02-15 |
X-Adjuster | Name of the claims adjuster handling the case. | James Carter |
X-DateOfLoss | Date the insured loss occurred, in ISO 8601 format: YYYY-MM-DD. | 2025-11-03 |
X-ServiceDates | Date services were provided or completed, in ISO 8601 format: YYYY-MM-DD. | 2025-11-10 |
X-PayeeName | Name of the payee if different from the primary recipient. | Bennett Restoration Services |
X-Comments | Internal or external reference notes included with the payment. | Water damage claim settlement |
X-PersonalMessage | Message printed on the remittance or included with the cheque. | Please retain this cheque for your records. |
Configuring multifactor authentication for batch file eChecks
You can optionally enable multifactor authentication (MFA) for each eCheck transaction in a batch file. If an eCheck has MFA applied, the recipient must verify their identity before accessing the cheque.
For more information, see Multifactor authentication for eChecks.
Fields marked with * are mandatory. Bracketed asterisks (*) are for mandatory parameters with exceptions.
| Header | Description | Example |
|---|---|---|
EChequeVerificationType | Optional. Set to SmsCode or Passphrase to enable verification for the specific transaction. If omitted, no verification is required. | Passphrase |
RecipientPhoneNumber(*) | Required when EChequeVerificationType is SmsCode. Provide a mobile number in international E.164 format. | +14155552671 |
EChequeVerificationPassphrase(*) | Required when EChequeVerificationType is Passphrase. Contact Vitesse to configure the passphrase type prior to sending eChecks. | 45821 |
MFA access limits
| Verification type | Limits |
|---|---|
| SMS | Up to 3 attempts to enter the code Up to 3 resend attempts Locked out for 10 minutes after failed attempts |
| Passphrase | Up to 5 attempts before locked out |
eCheck batch example
RouteType,SendAccountID,SendCurrency,SendValue,RecipientName,RecipientEmail,RecipientCountry,RecipientCurrency,RecipientReference,RecipientAddressStreetName,RecipientAddressBuildingNumber,RecipientAddressTownName,RecipientAddressPostCode,RecipientAddressCountrySubDivision,RecipientAddressCountry,EChequeVerificationType,RecipientPhoneNumber
Cheque,999,USD,1250.00,Michael Thompson,[email protected],US,USD,Claim-45821,Main Street,742,Springfield,62704,IL,US,SmsCode,+12175550123
Cheque,999,USD,320.50,Sarah Williams,[email protected],US,USD,Invoice-2024-019,Oak Avenue,118,Boston,02116,MA,US,SmsCode,+16175550124
Cheque,999,USD,9875.75,Daniel Martinez,[email protected],US,USD,Settlement-7845,Sunset Boulevard,2101,Los Angeles,90028,CA,US,SmsCode,+13235550125Postal cheque batch example
RouteType,SendAccountID,SendCurrency,SendValue,RecipientName,RecipientCountry,RecipientCurrency,RecipientReference,RecipientAddressStreetName,RecipientAddressBuildingNumber,RecipientAddressTownName,RecipientAddressPostCode,RecipientAddressCountrySubDivision,RecipientAddressCountry
PostalCheque,999,USD,1250.00,Michael Thompson,US,USD,Claim-45821,Main Street,742,Springfield,62704,IL,US
PostalCheque,999,USD,320.50,Sarah Williams,US,USD,Invoice-2024-019,Oak Avenue,118,Boston,02116,MA,US
PostalCheque,999,USD,9875.75,Daniel Martinez,US,USD,Settlement-7845,Sunset Boulevard,2101,Los Angeles,90028,CA,USWhat happens next?
After we process the batch, we:
- Generate a cheque number and append it to
ExternalReference1 - Post the transaction to your account entries
- Issue the cheque:
- The eCheck link is emailed to the recipient
- The postal cheque is printed, ready for mailing
For information about delivery times and so on, see Cheque processing.
Updated 24 days ago