Skip to Navigation | Skip to Content


Change History

Field Name Changes

The following changes were made to field names. The old names will still be accepted by Raven however all documentation has been updated to reference the new names.

Old name New name As of
CustomerBankNumber BankNumber v1.8
CustomerAccountNumber AccountNumber v1.8
CustomerAccountName AccountName v1.8
CustomerCardNumber CardNumber v1.8
CustomerCardExpiryDate ExpiryDate v1.8
CustomerCardStartDate StartDate v1.8
CustomerCardIssueNumber IssueNumber v1.8
PaymentReference Reference v1.8
PaymentReference2 Reference2 v1.8
PaymentReference3 Reference3 v1.8
MemoReference Description v1.8
PaymentDescription Description v1.9
ExpiryDate Expiry 2009-09-08
PaymentRoutingNumber PRN 2009-09-08
PaymentType PymtType 2009-09-08
CurrencyCode Currency 2009-09-08
AccountTaxNumber TaxNumber 2009-09-08
PoliticalDivision ProvState 1.73

The following fields were removed.  If they are in a file Raven will ignore them.

Previous name PaymentType As of version
CustomerState ACH 1.5?
DescriptivePaymentDate ACH 1.8
PayeeNameOverride ACH 1.8
PaymentDescription ACH 1.9

History of Changes to Documentation

Ver. Date Description of changes
1.0 Jan 20 2004 First draft.
1.1 Mar 8 2004 Minor cleanup, added Giro description, added German EFT section.
1.2 Mar 23 2004 Updated description of return address lines in cheque issue request files.
1.3 Apr 22 2004 Inserted descriptions for BACS Dutch EFT. Completed German EFT section. Minor corrections to ACH request fields table.
1.4 May 19 2004 Removed draft, moved Workbook info to back.
1.5 June 1 2004 Removed ‘Not Yet Deployed’ notice from German and Dutch EFT section.
1.6 June 3 2004 For the ‘Voided’ result code, added “If more detail about this Status is required, contact customer service.”
1.7 July 14 2004 Ensured footers correct on internal sections
Noted that same file names may be allowed but should not be submitted
Added Canadian EFT section
Updated section headers to be correct
1.8 July 16 2004 Reordered sections as Card, EFT Payments, Giro & Cheque issue. This keeps like types together.
Re-named ACH to ACH (US) Eft to be consistent with BACS (UK) Eft
Bit of work on Canadian EFT
Added section on how to submit test transactions
Added TestSucceeded code to response sections
Renamed fields to new field names as agreed. For example CustomerCardNumber to CardNumber.
Removed inapplicable ACH fields.
1.9 July 20 2004 Add SGDEFT section
1.10 July 26 2004 Added section describing format changes
1.11 Aug 4 2004 Removed Description as a field for US ACH to reflect reality. Updated payment cycle for newer payment types.
1.12 Aug 9 2004 Reference for DEEft should be Text not DTAUS Text as previously documented.
1.13 Aug 27 2004 Extended BACS section updating EFT cycle.
1.14 Aug 30 2004 Minor changes to BACS languageAdded Hong Kong EFT section.
1.15 Oct 8 2004 Formatting changes in Test File section.
1.16 Oct 18 2004 Added CoreReference field for BACS
1.17 Nov 18 2004 Minor spelling nits
1.18 Dec 22 2004 Added French and Spanish sections, also minor spelling nits
1.19 Feb 16 2005 Misc. field alias updates as well as the addition of the “Mail Merge” section for Cheque Issue.
1.20 Feb 23 2005 Updated PaymentDescription fields. Lengthening those for FR, NL, DE and ES. Indicated CA and BACS payment descriptions will be ignored.Added InstructionReference as a mandatory field for ES EFT.
1.21 Mar 1 2005 Add 10 character description field to US ACH.Corrected field name in CA EFT section.
1.22 April 6 2005 Added Australian EFT section.
1.23 April 15 2005 Spelling and grammar nits.
1.24 April 28 2005 Corrected some French field lengthsAdded European Standard Payment specification

Added Japanese EFT specification. This is not completed.

1.25 May 5 2005 Minor formatting changes to some tables
1.26 May 5 2005 Corrected section headings
1.27 May 20 2005 Added language indicating account numbers will be masked.
1.28 May 26 2005 Updated JPEFT field information.
1.29 May 30 2005 Removed instruction reference from ESEFT type. Corrected length of payment description field.
1.30 May 30 2005 More corrections to ESEFT.
1.31 June 19 2005 Made all the comment field description the same.Added Polish EFT type.

Minor corrections to Spanish EFT type.

1.32 June 21 2005 Several numbering sequences were not starting at 1.
1.33 Jan. 18 2006 Added first version of real-time documentation section. Also updated the introduction and the section on testing.Spanish EFT now marked as released.
1.34 Jan. 25 2006 Further edits to real-time.
1.35 May 31 2006 Removed real-time materialAdded CHAPS material

Updated ACH section to include AccountType

1.36 June 7 2006 Added general Return File section and Card Payment specific returned payment status codes.
1.37 Jan 31, 2007 Removed the Customer prefix from field names in examples.
1.38 Feb 9, 2007 Added section on BR EFT payments.
1.39 Feb 9, 2007 Added first, still incomplete section describing the CardIssue payment type.
1.40 March 5, 2007 Added password to card issueAdded card load credit to card issue section.
1.41 March 8, 2007 Added card serial number as a return value.
1.42 Mar 29 2007 Add mention of receipt file to cheque and card issue sections.
1.43 Apr 12 2007 Added extra documentation to CA EFT section.
1.44 May 24, 2007 Added description of AccountAmount column.
1.45 June 20, 2007 Minor clarification to description of Text field type.
1.46 July 4, 2007 Replaced ‘Collected’ EFT status by ‘Submitted’.
1.47 July 9, 2007 Added config error return codes to Cheque Issue section.
1.48 Sept. 9, 2007 Added documentation for template payments.
1.49 Sept 12, 2007 Added documentation for Card Payment Fraud Scoring
1.50 April 18, 2008 Clarified that template fields are indicated by an *.
1.51 Sept 9, 2008 Added cash issue credit as a payment type.
1.52 Sept 12, 2008 Removed references to “Test Succeeded”
1.53 Sept 17, 2008 Added “CVV2ResponseCode” result column for cards
1.54 Nov 17, 2008 Added IE Eft details
1.55 Nov 20, 2008 Corrected IE Eft customer name field
1.56 Dec 4, 2008 Added structured address information.
1.57 Dec 16, 2008 Added instruction reference in IE Eft as a required field.Changed length of core reference in BACS to 12 from 9  to reflect the change made to support Northway.
1.58 Jan 24, 2009 Added AT EFT and CH EFT.
1.59 Jan 26, 2009 Corrections to AT and CH EFT
1.60 Feb 17, 2009 Added note on limitations of template payments.
1.61 Feb 20, 2009 Updated AT documentation
1.62 April 27, 2009 Updated comments on characters accepted.Changed response “TestSuceeded” to Invallid:TestChannel.

Added documentation on testing of card numbers and magic numbers.

1.63 May 6, 2009 Added section on submitting scanned cheques.
1.64 May 7, 2009 Changed max field lengths of some fields in CH EFT section.
1.65 May 7, 2009 Moved non-standard services to end of document.
1.66 May 12, 2009 Updated to add IBAN field to CH and change some validation rules.
1.67 June 2, 2009 Updated description of REJECTED file.
1.68 June 2, 2009 Added description of web folders v.s. Raven Online to the introduction section.
1.69 July 7, 2009 Added a few additional cheque issue merge fields.
1.70 Aug 19, 2009 Added account amount to all eft payment types.Changed length of city field to 35.
1.71 Aug 27, 2009 Corrected status response codes for CHAPSCorrected result fields for ChequeIssue payments
1.72 Sept. 1, 2009 Added additional notes to clients regarding addresses.
1.72 Sept. 8, 2009 Converted to HTML.
1.73 Nov. 23, 2009 Finalized HTML Conversion

  • Added Setup
  • Added Integration Options
  • Added Introduction to Payments
  • Renamed columns as described in “Field Name Changes” table
  • Added Quick Start to Cheque Issue section.
  • Lots of minor tidy up
  • Recast tables to have REQ/RSP and MAN/OP columns
  • Added a discussion on Fraud Scoring and Flagging Payments
1.74 Dec 3, 2009 Updates to CH EFT section.
1.75 Feb 15, 2010 Template values for EFT clarified. Now shows the following template fields will be used:

  • AccountName
  • BankNumber
  • AccountNumber
  • FullBankAccountNumber (IBAN RIB etc)
  • BIC
August 15, 2010 Deprecated existing API and replaced it with on using HMAC signing and requiring a request ID.