API Documentation
EndPoint | Field Name | Xpath | Description | Category | Validation Rules |
---|---|---|---|---|---|
All Scheduled Payments | Permission | XXX/Data/Permission | Specifies the Open Banking service request types. | Mandatory | We will only accept permission code 'Create'. |
All Endpoints (Excluding File Payments) | ReadRefundAccount | XXX/ReadRefundAccount | Specifies to share the refund account details with PISP. | Optional | If populated as 'Yes', we will provide the the Creditor and Creditor Agent details in the refund block of our response. |
Domestic Payments | EndToEndIdentification | OBDomestic2/EndToEndIdentification | Unique identification assigned by the initiating party to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain. | Mandatory | For FPS payments, Customer/ TPP to provide unique reference which can be used for reconciliation. Up to 30 chars supported. |
Domestic Scheduled Payment | EndToEndIdentification | OBInternationalScheduled2/EndToEndIdentification | Unique identification assigned by the initiating party to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain. | Optional | Customer to provide unique reference to enable reconciliation by the creditor. If no value provided then AIB will populate "NOT PROVIDED" in the EndToEndIdentification field and will travel with the payment. Up to 30 chars supported. |
All Domestic Endpoints | LocalInstrument | OBDomestic2/LocalInstrument | This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level. | Optional | Optional but Validated for UK. Currently only supported value is UK.OBIE.FPS |
All Domestic Endpoints | Reference | OBDomestic2/RemittanceInformation/Reference | Unique reference, as assigned by the creditor, to enable reconciliation by the beneficiary | Optional | For FPS payments, Customer to provide unique reference to enable reconciliation by the creditor. Please note that only the 18 characters will travel with payment to the recipient bank. For Bill payments, Customer to provide unique Biller Account or Invoice number to enable reconciliation by the Service Provider / Merchant. For Non FPS payments, the information will not travel with the payment. |
All Domestic Endpoints | Unstructured | OBDomestic2/RemittanceInformation/Unstructured | Information supplied to enable the matching/reconciliation of an entry with the items that the payment is intended to settle, such as commercial invoices in an accounts' receivable system, in an unstructured form. | Optional | For all payments, the information contained in this tag will travel with the payment to the recipient bank. Up to 70 chars supported. |
All Endpoints | SchemeName | XXXX/DebtorAccount/SchemeName | Name of the identification scheme, in a coded form as published in an external list. | Optional | For all payments, Debtor account must be in UK.OBIE.SortCodeAccountNumber |
All Endpoints | Name | XXXX/CreditorAccount/Name | The account name is the name or names of the account owner(s) represented at an account level. | Mandatory | For all payments, the information contained in this tag will travel with the payment as a Creditor Name to the recipient bank. Incorrect Creditor Name might be resulted into payment rejection. |
All International Endpoints | Name | XXX/Creditor/Name | Name by which a party is known and which is usually used to identify that party. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor AddressType | XXXX/PostalAddress/AddressType | Identifies the nature of the postal address. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor Department | XXXX/PostalAddress/Department | Identification of a division of a large organisation or building. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor SubDepartment | XXXX/PostalAddress/SubDepartment | Identification of a sub-division of a large organisation or building. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor StreetName | XXXX/PostalAddress/StreetName | Name of a street or thoroughfare. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor BuildingNumber | XXXX/PostalAddress/BuildingNumber | Number that identifies the position of a building on a street. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor PostCode | XXXX/PostalAddress/PostCode | Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor TownName | XXXX/PostalAddress/TownName | Name of a built-up area, with defined boundaries, and a local government. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor CountrySubDivision | XXXX/PostalAddress/CountrySubDivision | Identifies a subdivision of a country such as state, region, county. | Not Required | For all payments, the information will not travel with the payment. |
All Endpoints | Creditor Country | XXXX/PostalAddress/Country | Nation with its own government. | Not Required | For all payments, the information will not travel with the payment. |
All Domestic Endpoints | Creditor AddressLine | XXXX/PostalAddress/AddressLine | Information that locates and identifies a specific address, as defined by postal services, presented in free format text. | Optional | Information in this block will travel with payment if available. |
All International Endpoints | Creditor AddressLine | XXXX/PostalAddress/AddressLine | Information that locates and identifies a specific address, as defined by postal services, presented in free format text. | Mandatory | The information in this block will travel with the payment. Please note that only 105 characters (AddressLine 1 & 2) will travel with the payment to the recipient bank. |
Domestic | SchemeName | OBDomesticScheduled2/CreditorAccount/SchemeName | Identification assigned by an institution to identify an account. This identification is known by the account owner. | Mandatory | For FPS payments, the SchemeName must be UK.OBIE.SortCodeAccountNumber |
All Endpoints | AuthorisationType | Authorisation/AuthorisationType | Level of authentications require to authorise the consent | Optional | For all payments, only "Any" value is supported by AIB. AIB default the AuthorisationType as "Any" if tag or no value present. AIB will reject the payment request if value is other than "Any". |
All Endpoints | CompletionDateTime | Authorisation/CompletionDateTime | Defined the date time for the payment order authorisation to be completed | Not Required | AIB does not support this field. AIB will reject the Consent if any value is populated. |
Domestic Standing Order | FirstPaymentDateTime | OBDomesticStandingOrder3/FirstPaymentDateTime | The date on which the first payment for a Standing Order schedule will be made | Mandatory | AIB will reject the Consent with value in this field if it is same as Today's or past date |
Domestic Standing Order | RecurringPaymentDateTime | OBDomesticStandingOrder3/RecurringPaymentDateTime | The date on which the first recurring payment for a Standing Order schedule will be made. | Not Required | AIB does not support this field. AIB will reject the Consent if any value is populated. |
Domestic Standing Order | NumberOfPayments | OBDomesticStandingOrder3/NumberOfPayments | Number of the payments that will be made in completing this frequency sequence including any executed since the sequence start date. | Conditional | AIB only supports maximum 4 digits (i.e. Up to 9999 recurring payments for a Standing Order). |
Domestic Standing Order | FinalPaymentDateTime | OBDomesticStandingOrder3/FinalPaymentDateTime | The date on which the final payment for a Standing Order schedule will be made. | Conditional | AIB supports recurring payments Up to 35 years. And will reject the consent if request receive to setup the standing order for more than 35 years. AIB supports either "FinalPaymentDateTime" or "NumberOfPayments" to setup a Standing Order. And will reject the Consent if AIB recieve the values in both the fields. AIB will reject the Consent if value in "FinalPaymentAmount" block is available and there is no value in "FinalPaymentDateTime" tag. |
Domestic Standing Order | Frequency | OBDomesticStandingOrder3/Frequency | Frequency of Payments for a Standing Order | Mandatory | AIB does not support values: EvryDay or EvryWorkgDay, QtrDay (ENGLISH, SCOTTISH or RECEIVED), WkInMnthDay And will reject the consent if AIB receive any of the above values. 3rd Attribute in the schedule code should match with value in "FirstPaymentDateTime" field. In case of mismatch, AIB will reject the Consent. |
Domestic Standing Order | Reference | OBDomesticStandingOrder3/Reference | Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. | Mandatory | This field is mandatory to capture the unique creditor narrative that can be referred for reconciliation purpose. AIB supports only 18 characters and will truncate if length is more than 18 characters. |
International Payment | EndToEndIdentification | OBInternational/EndToEndIdentification | Unique identification assigned by the initiating party to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain. | Mandatory | Customer to provide unique reference to enable reconciliation by the creditor. E.g. Creditor Narrative Only 30 characters will travel with the SWIFT instruction to the recipient bank and 35 characters for SEPA instruction. |
International Payment | Purpose | XXX/Purpose | Specifies the external purpose code in the format of character string with a maximum length of 4 characters. | Not Required | For Non SEPA payments, the information will not travel with the payment. |
All International Endpoints | ExtendedPurpose | XXX/ExtendedPurpose | Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes. | Optional | For all International payments, the information will not travel with the payment. |
All International Endpoints | LocalInstrument | XXX/LocalInstrument | This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level | Not Required | AIB will not process the LocalInstrument Code value supplied in the Consent. AIB will derive payment clearing option using the internal payment processing rules. Value (if tag is provided) must be provided from an OB defined list. |
All International Endpoints | ChargeBearer | XXX/ChargeBearer | Specifies which party/parties will bear the charges associated with the processing of the payment transaction. -BorneByCreditor -BorneByDebtor -FollowingServiceLevel -Shared |
Optional | For International payments we support only Shared charging option. ServiceLevel, BorneByCreditor or BorneByDebtor: AIB will reject the Consent with this charging option AIB default the value with ""Shared"" if tag or no value present. |
All Scheduled Payments | RequestedExecutionDateTime | XXX/RequestedExecutionDateTime | Date at which the initiating party requests the clearing agent to process the payment. Usage: This is the date on which the debtor's account is to be debited. | Mandatory | AIB will accept consents with requested execution date up to 90 days into the future. Consent will be rejected, if the RequestedExecutionDateTime has expired at the time of consent. |
All International Endpoints | InstructionPriority | XXX/InstructionPriority | Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction. | Optional | AIB default the priority as "Normal" if tag or the value not present. All payments with "Urgent" priority will be processed through Swift. To initiate a SEPA payment, priority should be set to "Normal" and Creditor IBAN should be SEPA reachable. |
All International Endpoints | CurrencyOfTransfer | XXX/CurrencyOfTransfer | Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account. | Conditional | AIB supports a different set of currencies for their Business customers on basis of InstructionPriority. AIB will reject the Consent if request receive with currency that is not supported for respective type of customers. UK Business / Corporate Customer: Refer below AIB link for supported currencies https://aibni.co.uk/business/business-docs/ways-to-bank/ibb/ibb-international-payments.pdf |
All International Endpoints | DestinationCountryCode | XXX/DestinationCountryCode | Country in which Credit Account is domiciled. Nation with its own government. | Mandatory | For all payments, this information is mandatory |
All International Endpoints | Currency | XXX/InstructedAmount/Currency | A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds". | Mandatory | For Business / Corporate Customers: If Instructed Currency is not the same as CurrencyOf Transfer, then it should be the same as Debit Account Currency. If this is not the case, AIB will reject the Consent. |
All International Endpoints | ExchangeRateInformation | XXX/ExchangeRateInformation | Provides details on the currency exchange rate and contract. | Conditional | This block is only required to process the Cross Currency payment using Dealer (pre-agreed rate with AIB only), and is only offered to Business / Corporate customers. |
All International Endpoints | UnitCurrency | XXX/ExchangeRateInformation/UnitCurrency | Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP. | Mandatory | For UK region value must be "GBP". |
All International Endpoints | RateType | XXX/ExchangeRateInformation/RateType | Specifies the type used to complete the currency exchange. | Mandatory | Agreed: Only to be used when a customer wants to process the payment using a Dealer or Forward Contract Rate If Rate Type equals Agreed, then values in ExchangeRateInformation or Forward Contract block are mandatory. Actual / Indicative: AIB will reject the Consent with these RateType values |
All International Endpoints | Name | OBInternational2/CreditorAgent/Name | Name by which an agent is known and which is usually used to identify that agent. | Optional | Creditor Agent Name will travel with CreditorAgent/PostalAddress/AddressLine if provided. In certain scenarios, this information will not travel if UK.OBIE.BICFI and IE.AIB.LCC is populated. |
All International Endpoints | SchemeName | XXX/CreditorAgent/SchemeName | Name of the identification scheme, in a coded form as published in an external list. | Optional | AIB supports below values - UK.OBIE.BICFI - UK.OBIE.NCC.[ISO3166-aplha2-CountryCode] In case of "UK.OBIE.BICFI" , customer must provide the valid BIC ( 8 or 11 characters) in Identification field ( OBInternational2/CreditorAgent/Identification) In case of ""UK.OBIE.NCC.[ISO3166-aplha2-CountryCode]"" customer must provide the valid Bank Code in Identification field (OBInternational2/CreditorAgent/Identification) For SEPA payments, the SchemeName should not be populated , as AIB will derive the BIC for SEPA payments. AIB will reject the Consent if only SchemeName or only Identification is provided. |
All International Endpoints | PostalAddress | XXX/CreditorAgent/PostalAddress | Information that locates and identifies a specific address, as defined by postal services. | Optional | Addressline information in this block will travel with payment if available |
All International Endpoints | AddressType | XXX/CreditorAgent/PostalAddress/AddressType | Identifies the nature of the postal address. | Not Required | For all payments, the information will not travel with the payment. |
All International Endpoints | Department | XXX/CreditorAgent/PostalAddress/Department | Identification of a division of a large organisation or building. | Not Required | For all payments, the information will not travel with the payment. |
All International Endpoints | SubDepartment | XXX/CreditorAgent/PostalAddress/SubDepartment | Identification of a sub-division of a large organisation or building. | Not Required | For all payments, the information will not travel with the payment. |
All International Endpoints | StreetName | XXX/CreditorAgent/PostalAddress/StreetName | Name of a street or thoroughfare. | Not Required | For all payments, the information will not travel with the payment. |
All International Endpoints | BuildingNumber | XXX/CreditorAgent/PostalAddress/BuildingNumber | Number that identifies the position of a building on a street. | Not Required | For all payments, the information will not travel with the payment. |
All International Endpoints | PostCode | XXX/CreditorAgent/PostalAddress/PostCode | Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail. | Not Required | For all payments, the information will not travel with the payment. |
All International Endpoints | TownName | XXX/CreditorAgent/PostalAddress/TownName | Name of a built-up area, with defined boundaries, and a local government. | Not Required | For all payments, the information will not travel with the payment. |
All International Endpoints | CountrySubDivision | XXX/CreditorAgent/PostalAddress/CountrySubDivision | Identifies a subdivision of a country such as state, region, county. | Not Required | For all payments, the information will not travel with the payment. |
All International Endpoints | Country | XXX/CreditorAgent/PostalAddress/Country | Nation with its own government. | Optional | For all payments, this information is optional. |
All International Endpoints | AddressLine | XXX/CreditorAgent/PostalAddress/AddressLine | Information that locates and identifies a specific address, as defined by postal services, presented in free format text. | Optional | Information in this block will travel with payment if available. Please note that only the 105 characters (AddressLine 1 & 2) will travel with the payment to the recipient bank. |
All International Endpoints | ContractIdentification | XXX/ExchangeRateInformation/ContractIdentification | Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent. | Conditional | The field should be used to supply Unique and unambiguous Dealer Reference. |
All International Endpoints | ForwardContract | XXX/SupplementaryData/ForwardContract/Identification | FX rate contract agreed for conversion of an amount from one currency to another. | Conditional | This block is only required to process the Cross Currency payment using Forward Contract Rate (i.e. pre-agreed rate with AIB only). AIB supports up to 5 Forward Contracts for a payment. This services is only offers to Business / Corporate customers. |
All International Endpoints | Reference | XXX/RemittanceInformation/Reference | Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. | Optional | If provided, this information will not travel with the payment. |
All International Endpoints | Unstructured | XXX/RemittanceInformation/Unstructured | Information supplied to enable the matching/reconciliation of an entry with the items that the payment is intended to settle, such as commercial invoices in an accounts' receivable system, in an unstructured form. | Mandatory | For all payments, the information contained in this tag will travel with the payment to the recipient bank. This field is mandatory and must contain a purpose of payment e.g. wages. Failure to provide a clear payment purpose can result in the payment being delayed or rejected. Please note that only the 105 characters will travel with the payment to the recipient bank. |
All Endpoints | SCASupportData | OBWriteInternationalConsent5/Data/SCASupportData | Supporting Data provided by TPP, when requesting SCA Exemption. | Mandatory | AIB will accept and store the data, but it will not use or validate this block for Payment Initiation. |
Supported Character Set:
a b c d e f g h i j k l m n o p q r s t u v w x y z
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
0 1 2 3 4 5 6 7 8 9
/ –. , ‘
Space
Special Rules:
FPS/CHAPS | Only Customer with their account in Branch 238590 can initiate FPS/CHAPS payments with priority as Urgent |
---|---|
Bank Code Requirement | PISP should provide the Bank code for below countries & currencies: USD (US) AUD (Australia) CAD (Canada) ZAR (South Africa) GBP (UK) INR (India) NZD (New Zealand) Bank Code format is available on below link: https://aib.ie/our-products/current-accounts/international-payments/country-specific-receiver-bank |
Domestic Endpoint | PISP to use Domestic Endpoint only for: - SEPA Payments (EUR payments to SEPA Reachable Creditor Agent) OR EUR Account Transfer within AIB. - CurrencyofTransfer is EUR - Debit Account should be in EUR |
International Scheduled Payment Endpoint | International Scheduled payment is only supported for Business / Corporate customers. AIB will reject the International Scheduled Payment Consent for Personal customers and UK Customers. |
International Endpoint | PISP to use International Endpoint to : - Initiate SEPA payments for UK Customers. - Initiate AccountTransfer invloving FX or transfer in non-Domestic Currencies within AIB Group. - Initiate International Payments. |
P7 Refunds
- Functionality allowing TPPs to receive customer account details for potential future refunds.
- Applies to all PISP Domestic & International endpoints.
- Does not apply to File Payments.
- TPP submits ReadRefundAccount field within the Data block of the Consent Request (e.g. POST /domestic-payment-consents)
- Field allows for only 2 values; Yes and No.
- Only the ReadRefundAccount field is passed back in the Consent Response
- No additional fields required from TPPs in Payment Order request(e.g. POST /domestic-payments)
- Customer account details are passed back within the Payment Order response & responses to any GET requests (e.g. POST /domestic-payments & GET /domestic-payments/{DomesticPaymentId})
- Domestic response:
New Refund block within the Data block, containing new Account block. Below data is returned in the Account block:
SchemeName – the name of the identification scheme (e.g. UK.OBIE.IBAN)
Identification – the Customer account details, i.e. the Debit Account number
Name – the name of the account owner on the Debit Account
- International Response:
As Domestic, but with an additional Agent block containing:
SchemeName – the name of the identification scheme (e.g. UK.OBIE.BICFI)
Identification – the AIB BIC (ROI) or Sort Code (UK) for identifying the destination bank for non-SEPA refunds.
P8 SCA Exemptions
- Applies to all PISP endpoints, including File Payments
- Consent requests can include an optional SCASupportData block within the Data block, containing the following fields:
RequestedSCAExemptionType – the SCA Exemption being requested. Values must be as per the OBExternalSCAExemptionType1Code code class.
AppliedAuthenticationApproach – specifies whether the Customer was subject to SCA by the TPP. Values must be as per the OBExternalAppliedAuthenticationApproach1Code code class.
ReferencePaymentOrderId – the payment reference for the last payment where it is a recurring payment.
- This data is accepted on an Accept & Store basis only.
Extended Purpose
- Feature applies to International endpoints only
- The ExtendedPurpose field is a new field in the Initiation block of the Consent request.
- This is a 140 character free text field that is used to define the Purpose if no relevant value is available in the Purpose field.
- This data will be accepted on an Accept & Store basis only.
DestinationCountryCode
- Applies to International endpoints only.
- DestinationCountryCode appears in the Initiation block of the Consent request & is mandatory for all International payments.
- This field replaces CreditorAgent/PostalAddress/Country, which is now optional.
- If the CreditorAgent/PostalAddress/Country is included in the payload, it must match the DestinationCountryCode.
- Enumeration for both fields are now UK.OBIE.NCC enumeration, followed by an ICO country code.Usage example: UK.OBIE.NCC.IN.
Scheduled Payments Cancelled Status
- Applies to Domestic & International Scheduled Payment endpoints
- This value is returned to TPPs in the Status field within the Data block. Value appearing as: Cancelled, will identify a Scheduled Payment that was cancelled by the Customer in channel.
Standing Orders IntrvlDay Frequency
- The IntrvlDay frequency is not supported by AIB.
New Namespaced Enumeration for Country Code
- The IE.AIB.LCC enumeration has been replaced by the UK.OBIE.NCC enumeration. Both use the ICO Country Code values, e.g. UK.OBIE.NCC.IN for India.
- All usage of the old AIB enumeration should be replaced by the new OBIE enumeration.
Requirements to make a CHAPS payment in GPS:
- Submit in GBP
- Set the LocalInstrument field to UK.OBIE.CHAPS
- Populate the EndToEndIdentification with a unique value for the payment
- Include Creditor Name, Account Details & Postal Address
UK CHAPS payments processing times:
10:30am
1:30pm
4:30pm – this is the cut off time
File payments:
We support the following UK file payments in CSV file format.
a) UK.AIB.iBP.Credit
b) UK.AIB.APACS.Credit
c) UK.AIB.Sage.Credit
d) UK.AIB.CSVStandard.Credit
e) UK.AIB.CSVStandard2.Credit
f) UK.AIB.CSVExcel.Credit
Requirements for file uploading:
The File structure must match the File Type mentioned in the metadata payload
- File Type - must be in APACS, CSV (Excel), CSV (Standard 2), CSV (Standard), SAGE, iBP Default format
- File Size Limit - 5 MB
- Hash of the file must match the File Hash in the consent request.
- No Of txns and Control sum if provided should match the actual count with the file.
- If the File fails a validation, the status of consent will appear as "Rejected"
Access token (client credentials grant type) |
60 minutes |
---|---|
Access token (authorisation code grant type) |
5 minutes |
Authorization code | 20 seconds |
SCA reauthorisation | Every 90 days |
Entering user credentials (customer journey) | If the user is idle for 3 minutes and 50 seconds, they are displayed an inactive screen. In addition to the 3m50s if the user remains idle, they will be automatically timed out after 1 minute. |
Timeout values for international payments:
Access token for international payments (authorisation code grant type) |
40 seconds |
---|---|
Authorization code for international payments | 30 seconds |
The following CMA permissions are supported:
- beneficiaries
- standing-orders
- direct-debits
- products
Example scope in the consent setup request:
{
"Data": {
"Permissions": [
"ReadAccountsDetail",
"ReadBalances",
"ReadTransactionsDetail",
"ReadTransactionsCredits",
"ReadTransactionsDebits",
"ReadBeneficiariesDetail",
"ReadDirectDebits",
"ReadStandingOrdersDetail",
"ReadProducts"
],
"ExpirationDateTime": "2020-12-01T00:30:44.954Z",
"TransactionFromDateTime": "2019-11-01T08:59:52.482Z",
"TransactionToDateTime": "2019-12-01T08:59:52.482Z"
},
"Risk": {}
}
These permissions can be included in the scope of the POST /account-access-request API call across the AIB GB and AIB NI (formerly First Trust Bank) regions.
Please note, these permissions are not permitted for the ROI region. Should the scope include these permissions when calling the /account-access-request ROI endpoint the POST request will be immediately rejected, preventing the customer from being taken to the OAuth redirect flow.
Handling Credit Cards:
These permissions are not supported for Credit Cards. Where the scope of the API request includes all or any one of these CMA permissions, the customer will not have the ability to select their credit card(s) within the OAuth redirect. The OAuth redirect will display non-Credit Card accounts only where CMA permissions are included in the scope.
In order to share both credit card data and data on accounts (current and/or deposit) where CMA permissions are included, TPPs will require two apps defined on the AIB gateway within the region they wish to operate in i.e. if working with GB clients and utilising the GB API suite, two apps will be required on the AIB GB environment.
S No | AIB Frequency | Acceptable Codes | Additional Check | RP_FREQ | RP_INTERVAL | RP_DAY_OF_MONTH |
---|---|---|---|---|---|---|
1 | Weekly | IntrvlWkDay:01:01-07 | Day in the week provided must match the day of $.Data.Initiation.FirstPaymentDateTime. | D | 7 | 0 |
2 | Fortnightly | IntrvlWkDay:02:01-07 | Day in the week provided must match the day of $.Data.Initiation.FirstPaymentDateTime. | D | 14 | 0 |
3 | Every 4 weeks | IntrvlWkDay:04:01-07 | Day in the week provided must match the day of $.Data.Initiation.FirstPaymentDateTime.td> | D | 28 | 0 |
4 | Monthly | IntrvlMnthDay:01:01-31 or IntrvlMnthDay:01:-05 | Day in the month provided must match the day of $.Data.Initiation.FirstPaymentDateTime | M | 1 | Date value from FirstPaymentDateTime |
5 | Every 2 Months | ortant;">IntrvlMnthDay:02:01-31 or IntrvlMnthDay:02:-05 | Day in the month provided must match the day of $.Data.Initiation.FirstPaymentDateTime. | M | 2 | Date value from FirstPaymentDateTime |
6 | Quarterly | IntrvlMnthDay:03:01-31 or IntrvlMnthDay:03:-05 | Day in the month provided must match the day of $.Data.Initiation.FirstPaymentDateTime. | M | 3 | Date value from FirstPaymentDateTime |
7 | Every 4 months | IntrvlMnthDay:04:01-31 or IntrvlMnthDay:04:-05 | Day in the month provided must match the day of $.Data.Initiation.FirstPaymentDateTime. | M | 4 | Date value from FirstPaymentDateTime |
8 | Half Yearly | IntrvlMnthDay:06:01-31 or IntrvlMnthDay:06:-05 | Day in the month provided must match the day of $.Data.Initiation.FirstPaymentDateTime | M | 6 | Date value from FirstPaymentDateTime |
9 | Annually | IntrvlMnthDay:12:01-31 or IntrvlMnthDay:12:-05 | Day in the month provided must match the day of $.Data.Initiation.FirstPaymentDateTime | M | 12 | Date value from FirstPaymentDateTime |
- EvryDay or EvryWorkgDay.
- QtrDay (ENGLISH, SCOTTISH or RECEIVED).
- WkInMnthDay
And will reject the consent if AIB receive any of the above values
3rd Attribute in the schedule code should match with value in "FirstPaymentDateTime" field. In case of mismatch, AIB will reject the Consent.