Multiple transactions batch

Our file format supports having multiple types of transaction in the same file - you could, if you wanted, include Immediate, Deferred, Queued and Queued Deferred transactions in the same file.

In this case, you need to supply the combination of fields for each of the four transactions types, and then ensure that fields are blank where needed. As an example, the only difference between an immediate transaction and a queued transaction is the additional of the RequestedValueDate field.

The following example file shows examples of each transction type.

SendCurrency,SendValue,RecipientName,RecipientCountry,RecipientCurrency,RecipientReference,AccountNumber,AccountSortCode,RateGroupDurationInDays,FundingType,RequestedValueDate
GBP,85.99,Tony Iommi,GB,GBP,Guitar Tuning,88833434,334422,,,
GBP,125,Ian Anderson,GB,GBP,Flute Repairs,49483948,124412,1,Deferred,
GBP,120,Geezer Butler,GB,GBP,Bass Lessons,66677667,887766,,,2020-06-09
GBP,500,Ozzy Osbourne,GB,GBP,Elocution,83724632,224466,1,Deferred,2020-06-09

If we ignore the mandatory fields common to all transaction types, the last three fields are those that determine what type of transaction is chosen. These are shown below.

In the above, there is some additional complexity depending on the values presented in the file.

FundingType

The FundingType value can be either Immediate (which is the default, so can be omitted entirely), Deferred, or FundingMerchantLookup. If it's the latter, then the determination of whether this is an immediate or deferred transaction is based on a lookup that it described in the Deferred Transactions batch example.

If you use FundingMerchantLookup here, the most probable outcome is that Immediate will be used. The actual value used is recorded as a note against the batch line, so you can see what was used by examining the batch.

RateGroupDurationInDays OR RateGroupId

In order for us to be able to successfully process a deferred transaction, we need to either be provided with a value for RateGroupDurationInDays, or a valid RateGroupId. If neither are supplied, and the FundingType resolves to Deferred, then that's an error and an appropriate message will be displayed against that batch line.

Also, if you supply values for both of these fields, that's an error too - we only need either RateGroupDurationInDays or RateGroupId and not both.

📘

Note

For immediate transactions, if you happen to supply a value for RateGroupDurationInDays or RateGroupId, these values will be ignored.