Giro / Bank Transfer Payments
Unlike the other payment types, giro / bank transfer payments do not involve a request file. Instead, your customers instruct their bank to submit a payment to you. RAVEN then reports those payments to you as they are received. The payment processing cycle is as follows:
- You provide your customers a way of making giro / bank transfer payments with the correct bank, account and giro / bank transfer information. This is commonly done by utilizing pre-printed giro / bank transfer slips that contain the correct bank, account and giro / bank transfer numbers.
- Your customers use these giro / bank transfer slips to send payments to the account specified.
- Once these payments have been received RAVEN will send you a response file containing the payment details.
- Please note: the transaction type giro_credit_advice is to be used for advice only, these are not confirmed transactions (it is possible for the bank to reverse a transaction on the day it occurs, if they make an error). You will need to use the information in the daily giro / bank transfer Payments file for transaction type giro_credit for confirmed payments received (reported on the next day, showing all transactions up to the close of business the previous working day).
Response fields
The following table defines the result fields for giro / bank transfer payments. The column O/C/M indicates if a field is optional, conditional or mandatory.
| Field Names | Type | Max. Size | O/C/M | Remarks |
|---|---|---|---|---|
| PaymentRoutingNumber | N | 6 | M | The 6-digit payment routing number assigned to you. |
| PaymentType | T | 25 | M | Describes the type of payment line:
|
| Amount | N | 10 | M | Value supplied in base unit of currency, with no decimal. E.g. $150.00 is 15000 |
| PaymentReference | T | 30 | O | The payment reference, if provided, as supplied by the receiving bank. |
| CurrencyCode | T | 3 | M | The three-character ISO currency code (e.g. USD or EUR) the transfer was valued in. |
| CountryCode | T | 2 | M | The two-character ISO country code (e.g. US, GB) used to verify the country of the account where the transfer originated. |
| PayorName | T | 150 | O | The name of the payor, if supplied by the bank, otherwise blank |
| CreditDate | T | 10 | O | Date of credit to the account, if supplied by the bank, in YYYY-MM-DD format. Otherwise blank. |
| Description | T | 150 | O | All additional information as supplied by the bank. |
| AccountNameAddress | T | 150 | O | Name and/or address associated with the account from which the payment originated. Otherwise blank. |
| BankNumber | T | 20 | O | The bank or branch code of the originating account, if supplied by the bank. |
| AccountNumber | T | 50 | O | The originating account number, if supplied by the bank. |
| Status | A | 50 | M | The current status of the payment. At present, it is always ‘Received’. |
| TrackingNumber | N | 9 | M | RAVEN will return a unique tracking number for each payment processed, independent of PaymentType. |