{"Data":{"Authorisation":{"AuthorisationType":"Auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"156452","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}}}
{"Data":{"Authorisation":{"AuthorisationType":"Auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"156452","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}}}
{"Data":{"Permission":"Create","Authorisation":{"AuthorisationType":"Auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"156452","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}}}
{"Data":{"Permission":"Create","Authorisation":{"AuthorisationType":"Auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"156452","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}}}
{"Data":{"Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"TBD","ChargeBearer":"TBD","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}}}
{"Data":{"Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"TBD","ChargeBearer":"TBD","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}}}
{"Data":{"Permission":"Create","ReadRefundAccount":"Yes","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"ABCD","ExtendedPurpose":"ExtendedPurpose","DestinationCountryCode":"RO","ChargeBearer":"TBD","CurrencyOfTransfer":"GBP","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}}}
{"Data":{"Permission":"Create","ReadRefundAccount":"Yes","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"ABCD","ExtendedPurpose":"ExtendedPurpose","DestinationCountryCode":"RO","ChargeBearer":"TBD","CurrencyOfTransfer":"GBP","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}}}
Example of response
{"Data":{"ConsentId":"18463","Status":"AwaitingAuthorisation","CreationDateTime":"2017-06-05T15:15:13+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","ReadRefundAccount":"Yes","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"21342","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-payment-consents/58923","First":"/open-banking/v3.1/pisp/domestic-payment-consents/58923","Last":"/open-banking/v3.1/pisp/domestic-payment-consents/58925","Next":"/open-banking/v3.1/pisp/domestic-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/domestic-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"18463","Status":"AwaitingAuthorisation","CreationDateTime":"2017-06-05T15:15:13+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","ReadRefundAccount":"Yes","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"21342","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-payment-consents/58923","First":"/open-banking/v3.1/pisp/domestic-payment-consents/58923","Last":"/open-banking/v3.1/pisp/domestic-payment-consents/58925","Next":"/open-banking/v3.1/pisp/domestic-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/domestic-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"18463","Status":"AwaitingAuthorisation","CreationDateTime":"2017-06-05T15:15:13+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","ReadRefundAccount":"Yes","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Permission":"Create","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"21342","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"New Test","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58923","First":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58923","Last":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58925","Next":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"18463","Status":"AwaitingAuthorisation","CreationDateTime":"2017-06-05T15:15:13+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","ReadRefundAccount":"Yes","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Permission":"Create","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"21342","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"New Test","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58923","First":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58923","Last":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58925","Next":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"58923","CreationDateTime":"2017-06-05T15:15:13+00:00","Status":"AwaitingAuthorisation","ReadRefundAccount":"Yes","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"},"Charges":[{"ChargeBearer":"TBD","Type":"TBD","Amount":{"Amount":123,"Currency":"GBP"}}],"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","ContractIdentification":"TBD","RateType":"TBD","ExpirationDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"TBD","ChargeBearer":"TBD","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/international-payment-consents/58923","First":"/open-banking/v3.1/pisp/international-payment-consents/58923","Last":"/open-banking/v3.1/pisp/international-payment-consents/58925","Next":"/open-banking/v3.1/pisp/international-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/international-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"58923","CreationDateTime":"2017-06-05T15:15:13+00:00","Status":"AwaitingAuthorisation","ReadRefundAccount":"Yes","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"},"Charges":[{"ChargeBearer":"TBD","Type":"TBD","Amount":{"Amount":123,"Currency":"GBP"}}],"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","ContractIdentification":"TBD","RateType":"TBD","ExpirationDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"TBD","ChargeBearer":"TBD","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/international-payment-consents/58923","First":"/open-banking/v3.1/pisp/international-payment-consents/58923","Last":"/open-banking/v3.1/pisp/international-payment-consents/58925","Next":"/open-banking/v3.1/pisp/international-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/international-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"58924","CreationDateTime":"2017-06-05T15:15:13+00:00","Status":"AwaitingAuthorisation","Permission":"Create","ReadRefundAccount":"Yes","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"Charges":[{"ChargeBearer":"TBD","Type":"TBD","Amount":{"Amount":123,"Currency":"GBP"}}],"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","ContractIdentification":"TBD","RateType":"TBD","ExpirationDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"ABCD","ExtendedPurpose":"ExtendedPurpose","DestinationCountryCode":"RO","ChargeBearer":"TBD","CurrencyOfTransfer":"GBP","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/international-scheduled-payment-consents/58924"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"58924","CreationDateTime":"2017-06-05T15:15:13+00:00","Status":"AwaitingAuthorisation","Permission":"Create","ReadRefundAccount":"Yes","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"Charges":[{"ChargeBearer":"TBD","Type":"TBD","Amount":{"Amount":123,"Currency":"GBP"}}],"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","ContractIdentification":"TBD","RateType":"TBD","ExpirationDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"ABCD","ExtendedPurpose":"ExtendedPurpose","DestinationCountryCode":"RO","ChargeBearer":"TBD","CurrencyOfTransfer":"GBP","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/international-scheduled-payment-consents/58924"},"Meta":{"TotalPages":1}}
The media type of the body of the request.
Default value:
application/json
Can raise:
FieldInvalid
x-fapi-interaction-id
string, optional
An RFC4122 UID used as a correlation Id.
Can raise:
FieldInvalid
Accept
string, optional
Media type that is acceptable for the response.
Can raise:
FieldInvalid
x-fapi-auth-date
string, optional
The time when the PSU last logged in with the TPP.
Can raise:
FieldInvalid
x-fapi-customer-ip-address
string, optional
The PSU's IP address if the PSU is currently logged in with the TPP.
Can raise:
FieldInvalid
Authorization
string, required
Standard HTTP Header; Allows Credentials to be provided to the Authorisation / Resource Server depending on the type of resource being requested. For OAuth 2.0 / OIDC, this comprises of either the Basic / Bearer Authentication Schemes.
Can raise:
HeaderMissing, HeaderInvalid, ResourceNotFound, Forbidden
x-jws-signature
string, optional
A detached JWS signature of the body of the payload.
Idempotency-Key
string, optional
Unique uuid used to recognize subsequent retries of the same request valid for 24 hours.
Allowed length:
max: 40 characters
Request parameters
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
consent_payment_product(path)
string, required
The addressed consent payment resource.
Allowed values:
domestic-payment-consents, international-payment-consents
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Allowed values:
Yes, No
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid, ResourceInvalidFormat
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor. Should be populated in case “SEPA“ or “SEPA Instant“ local instrument schemes are applied.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
TransferReason
string, required
Transfer reason. Should be provided per each payment.Click here to review codes for all.
Can raise:
FieldInvalid
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
consent_payment_product(path)
string, required
The addressed consent payment resource.
Allowed values:
domestic-payment-consents, international-payment-consents
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Allowed values:
Yes, No
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
consent_payment_product(path)
string, required
The addressed consent payment resource.
Allowed values:
domestic-payment-consents, international-payment-consents
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Allowed values:
Yes, No
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
InvalidFormat
FinalPaymentDateTime
datetime, optional
The date on which the final payment for a Standing Order schedule will be made.
FirstPaymentDateTime
datetime, required
The date on which the first payment for a Standing Order schedule will be made.
RecurringPaymentDateTime
datetime, optional
The date on which the first recurring payment for a Standing Order schedule will be made. Usage: This must be populated only if the first recurring date is different to the first payment date.
Frequency
string, required
This is a specific format of describing the rule for creating the payments of a standing order.
It should comply with one of the permitted patterns. Full pattern represented as a regular expression which can be used for validating the value provided in this field:
^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlWkDay:0[1-9]:0[1-7])$|^(WkInMnthDay:0[1-5]:0[1-7])$|^(IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01]))$|^(QtrDay:(ENGLISH|SCOTTISH|RECEIVED))$
Can raise:
UnsupportedFrequency
NumberOfPayments
string, optional
Number of the payments that will be made in completing this frequency sequence including any executed since the sequence start date.
Can raise:
FieldInvalid
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. Usage: If available, the initiating party should provide this reference in the structured remittance information, to enable reconciliation by the creditor upon receipt of the amount of money. If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
FinalPaymentAmount
hash, optional
The amount of the final Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
FirstPaymentAmount
hash, required
The amount of the first Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
RecurringPaymentAmount
hash, optional
The amount of the recurring Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
consent_payment_product(path)
string, required
The addressed consent payment resource.
Allowed values:
domestic-payment-consents, international-payment-consents
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Allowed values:
Yes, No
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
FieldMissing
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, required
Financial institution servicing an account for the creditor.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list. Scheme name "UK.Silverbird.ABA" to be used only with the "UK.Silverbird.FEDWIRE" local instrument value.
Allowed values:
UK.OBIE.BICFI, UK.Silverbird.ABA
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument. Use UK.Silverbird.FEDWIRE for USA payments only.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid, ResourceInvalidFormat
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
TransferReason
string, required
Transfer reason. Should be provided per each payment.
Click here to review codes for all countries except Bahrain and United Arab Emirates.
Click here to review codes for payments to United Arab Emirates.
Click here to review codes for payment to Bahrain.
Can raise:
FieldInvalid
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
consent_payment_product(path)
string, required
The addressed consent payment resource.
Allowed values:
domestic-payment-consents, international-payment-consents
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Allowed values:
Yes, No
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
FieldMissing
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor.
SchemeName
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Response headers
Header
Type
Description
Content-Type
string, required
The media type of the body of the request.
x-fapi-interaction-id
string, required
An RFC4122 UID used as a correlation Id. If provided, the ASPSP must "play back" this value in the x-fapi-interaction-id response header.
Retry-After
integer, optional
Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request.
Response
Upon successful request, 201 status code will be returned. See ‘Related Errors’ table for other possibilities.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
datetime, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExpectedSettlementDateTime
datetime, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid, ResourceInvalidFormat
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor. Should be populated in case “SEPA“ or “SEPA Instant“ local instrument schemes are applied.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
TransferReason
string, required
Transfer reason. Should be provided per each payment.Click here to review codes for all.
Can raise:
FieldInvalid
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
datetime, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExpectedSettlementDateTime
datetime, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
FinalPaymentDateTime
datetime, optional
The date on which the final payment for a Standing Order schedule will be made.
FirstPaymentDateTime
datetime, required
The date on which the first payment for a Standing Order schedule will be made.
RecurringPaymentDateTime
datetime, optional
The date on which the first recurring payment for a Standing Order schedule will be made. Usage: This must be populated only if the first recurring date is different to the first payment date.
Frequency
string, required
This is a specific format of describing the rule for creating the payments of a standing order.
It should comply with one of the permitted patterns. Full pattern represented as a regular expression which can be used for validating the value provided in this field:
^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlWkDay:0[1-9]:0[1-7])$|^(WkInMnthDay:0[1-5]:0[1-7])$|^(IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01]))$|^(QtrDay:(ENGLISH|SCOTTISH|RECEIVED))$
Can raise:
UnsupportedFrequency
NumberOfPayments
string, optional
Number of the payments that will be made in completing this frequency sequence including any executed since the sequence start date.
Can raise:
FieldInvalid
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. Usage: If available, the initiating party should provide this reference in the structured remittance information, to enable reconciliation by the creditor upon receipt of the amount of money. If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
FinalPaymentAmount
hash, optional
The amount of the final Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
FirstPaymentAmount
hash, required
The amount of the first Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
RecurringPaymentAmount
hash, optional
The amount of the recurring Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
datetime, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExpectedSettlementDateTime
datetime, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, required
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ExpirationDateTime
datetime, optional
Specified date and time the exchange rate agreement will expire.
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, required
Financial institution servicing an account for the creditor.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list. Scheme name "UK.Silverbird.ABA" to be used only with the "UK.Silverbird.FEDWIRE" local instrument value.
Allowed values:
UK.OBIE.BICFI, UK.Silverbird.ABA
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument. Use UK.Silverbird.FEDWIRE for USA payments only.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid, ResourceInvalidFormat
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
TransferReason
string, required
Transfer reason. Should be provided per each payment.
Click here to review codes for all countries except Bahrain and United Arab Emirates.
Click here to review codes for payments to United Arab Emirates.
Click here to review codes for payment to Bahrain.
Can raise:
FieldInvalid
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
datetime, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExpectedSettlementDateTime
datetime, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, required
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ExpirationDateTime
datetime, optional
Specified date and time the exchange rate agreement will expire.
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor.
SchemeName
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Related Errors
Class
Code
Description
FieldInvalid
400
An invalid value is supplied in the field. More details in error_message.
UnsupportedCurrency
400
The currency is not supported.
CountryNameInvalid
400
Country doesn't exist or is invalid. Expected alpha 2 ISO3166 format.
ResourceNotFound
400
Specified resource doesn't exist.
UnsupportedFrequency
400
Specified frequency is unsupported.
HeaderMissing
400
A required HTTP header has not been provided.
HeaderInvalid
400
An invalid value is supplied in the HTTP header.
Forbidden
403
Action is forbidden. More details in error_message.
×
Show
The API allows the TPP to ask an ASPSP to show a payment-access-consent resource.
{"Data":{"ConsentId":"18463","Status":"AwaitingAuthorisation","CreationDateTime":"2017-06-05T15:15:13+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","ReadRefundAccount":"Yes","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"21342","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-payment-consents/58923","First":"/open-banking/v3.1/pisp/domestic-payment-consents/58923","Last":"/open-banking/v3.1/pisp/domestic-payment-consents/58925","Next":"/open-banking/v3.1/pisp/domestic-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/domestic-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"18463","Status":"AwaitingAuthorisation","CreationDateTime":"2017-06-05T15:15:13+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","ReadRefundAccount":"Yes","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"21342","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-payment-consents/58923","First":"/open-banking/v3.1/pisp/domestic-payment-consents/58923","Last":"/open-banking/v3.1/pisp/domestic-payment-consents/58925","Next":"/open-banking/v3.1/pisp/domestic-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/domestic-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"18463","Status":"AwaitingAuthorisation","CreationDateTime":"2017-06-05T15:15:13+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","ReadRefundAccount":"Yes","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Permission":"Create","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"21342","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58923","First":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58923","Last":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58925","Next":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"18463","Status":"AwaitingAuthorisation","CreationDateTime":"2017-06-05T15:15:13+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","ReadRefundAccount":"Yes","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Permission":"Create","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"SCASupportData":{"AppliedAuthenticationApproach":"AppliedAuthenticationApproach","ReferencePaymentOrderId":"21342","RequestedSCAExemptionType":"RequestedSCAExemptionType"},"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58923","First":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58923","Last":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58925","Next":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/domestic-scheduled-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"58923","CreationDateTime":"2017-06-05T15:15:13+00:00","Status":"AwaitingAuthorisation","ReadRefundAccount":"Yes","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"},"Charges":[{"ChargeBearer":"TBD","Type":"TBD","Amount":{"Amount":123,"Currency":"GBP"}}],"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","ContractIdentification":"TBD","RateType":"TBD","ExpirationDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Normal","Purpose":"TBD","ChargeBearer":"TBD","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/international-payment-consents/58923","First":"/open-banking/v3.1/pisp/international-payment-consents/58923","Last":"/open-banking/v3.1/pisp/international-payment-consents/58925","Next":"/open-banking/v3.1/pisp/international-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/international-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"58923","CreationDateTime":"2017-06-05T15:15:13+00:00","Status":"AwaitingAuthorisation","ReadRefundAccount":"Yes","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"},"Charges":[{"ChargeBearer":"TBD","Type":"TBD","Amount":{"Amount":123,"Currency":"GBP"}}],"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","ContractIdentification":"TBD","RateType":"TBD","ExpirationDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Normal","Purpose":"TBD","ChargeBearer":"TBD","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/international-payment-consents/58923","First":"/open-banking/v3.1/pisp/international-payment-consents/58923","Last":"/open-banking/v3.1/pisp/international-payment-consents/58925","Next":"/open-banking/v3.1/pisp/international-payment-consents/58924","Prev":"/open-banking/v3.1/pisp/international-payment-consents/58922"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"58924","CreationDateTime":"2017-06-05T15:15:13+00:00","Status":"AwaitingAuthorisation","Permission":"Create","ReadRefundAccount":"Yes","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"Charges":[{"ChargeBearer":"TBD","Type":"TBD","Amount":{"Amount":123,"Currency":"GBP"}}],"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","ContractIdentification":"TBD","RateType":"TBD","ExpirationDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"ABCD","ExtendedPurpose":"ExtendedPurpose","DestinationCountryCode":"RO","ChargeBearer":"TBD","CurrencyOfTransfer":"GBP","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/international-scheduled-payment-consents/58924"},"Meta":{"TotalPages":1}}
{"Data":{"ConsentId":"58924","CreationDateTime":"2017-06-05T15:15:13+00:00","Status":"AwaitingAuthorisation","Permission":"Create","ReadRefundAccount":"Yes","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CutOffDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"TBD","CompletionDateTime":"TBD"},"Charges":[{"ChargeBearer":"TBD","Type":"TBD","Amount":{"Amount":123,"Currency":"GBP"}}],"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","ContractIdentification":"TBD","RateType":"TBD","ExpirationDateTime":"TBD"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"ABCD","ExtendedPurpose":"ExtendedPurpose","DestinationCountryCode":"RO","ChargeBearer":"TBD","CurrencyOfTransfer":"GBP","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}},"SCASupportData":{"AppliedAuthenticationApproach":"TBD","ReferencePaymentOrderId":"TBD","RequestedSCAExemptionType":"TBD"}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}},"Links":{"Self":"/open-banking/v3.1/pisp/international-scheduled-payment-consents/58924"},"Meta":{"TotalPages":1}}
The media type of the body of the request.
Default value:
application/json
Can raise:
FieldInvalid
x-fapi-interaction-id
string, optional
An RFC4122 UID used as a correlation Id.
Can raise:
FieldInvalid
Accept
string, optional
Media type that is acceptable for the response.
Can raise:
FieldInvalid
x-fapi-auth-date
string, optional
The time when the PSU last logged in with the TPP.
Can raise:
FieldInvalid
x-fapi-customer-ip-address
string, optional
The PSU's IP address if the PSU is currently logged in with the TPP.
Can raise:
FieldInvalid
Authorization
string, required
Standard HTTP Header; Allows Credentials to be provided to the Authorisation / Resource Server depending on the type of resource being requested. For OAuth 2.0 / OIDC, this comprises of either the Basic / Bearer Authentication Schemes.
Can raise:
HeaderMissing, HeaderInvalid, ResourceNotFound, Forbidden
Request parameters
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
consent_payment_product(path)
string, required
The addressed consent payment resource.
Allowed values:
domestic-payment-consents, international-payment-consents
Can raise:
FieldInvalid, ResourceNotFound
consent_id(path)
string, required
The consent identifier assigned to the created resource.
Can raise:
FieldInvalid, ResourceNotFound
Response headers
Header
Type
Description
Content-Type
string, required
The media type of the body of the request.
x-fapi-interaction-id
string, required
An RFC4122 UID used as a correlation Id. If provided, the ASPSP must "play back" this value in the x-fapi-interaction-id response header.
Retry-After
integer, optional
Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request.
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
datetime, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExpectedSettlementDateTime
datetime, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid, ResourceInvalidFormat
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor. Should be populated in case “SEPA“ or “SEPA Instant“ local instrument schemes are applied.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
TransferReason
string, required
Transfer reason. Should be provided per each payment.Click here to review codes for all.
Can raise:
FieldInvalid
Risk
hash, optional
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
datetime, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExpectedSettlementDateTime
datetime, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Risk
hash, optional
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
FinalPaymentDateTime
datetime, optional
The date on which the final payment for a Standing Order schedule will be made.
FirstPaymentDateTime
datetime, required
The date on which the first payment for a Standing Order schedule will be made.
RecurringPaymentDateTime
datetime, optional
The date on which the first recurring payment for a Standing Order schedule will be made. Usage: This must be populated only if the first recurring date is different to the first payment date.
Frequency
string, required
This is a specific format of describing the rule for creating the payments of a standing order.
It should comply with one of the permitted patterns. Full pattern represented as a regular expression which can be used for validating the value provided in this field:
^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlWkDay:0[1-9]:0[1-7])$|^(WkInMnthDay:0[1-5]:0[1-7])$|^(IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01]))$|^(QtrDay:(ENGLISH|SCOTTISH|RECEIVED))$
Can raise:
UnsupportedFrequency
NumberOfPayments
string, optional
Number of the payments that will be made in completing this frequency sequence including any executed since the sequence start date.
Can raise:
FieldInvalid
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. Usage: If available, the initiating party should provide this reference in the structured remittance information, to enable reconciliation by the creditor upon receipt of the amount of money. If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
FinalPaymentAmount
hash, optional
The amount of the final Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
FirstPaymentAmount
hash, required
The amount of the first Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
RecurringPaymentAmount
hash, optional
The amount of the recurring Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Risk
hash, optional
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
datetime, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExpectedSettlementDateTime
datetime, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, required
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ExpirationDateTime
datetime, optional
Specified date and time the exchange rate agreement will expire.
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, required
Financial institution servicing an account for the creditor.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list. Scheme name "UK.Silverbird.ABA" to be used only with the "UK.Silverbird.FEDWIRE" local instrument value.
Allowed values:
UK.OBIE.BICFI, UK.Silverbird.ABA
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument. Use UK.Silverbird.FEDWIRE for USA payments only.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid, ResourceInvalidFormat
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
TransferReason
string, required
Transfer reason. Should be provided per each payment.
Click here to review codes for all countries except Bahrain and United Arab Emirates.
Click here to review codes for payments to United Arab Emirates.
Click here to review codes for payment to Bahrain.
Can raise:
FieldInvalid
Risk
hash, optional
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, AwaitingAuthorisation, Authorised, Rejected, Consumed
Can raise:
FieldInvalid
CreationDateTime
datetime, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
StatusUpdateDateTime
datetime, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
CutOffDateTime
datetime, optional
Specified cut-off date and time for the payment consent.All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ReadRefundAccount
string, optional
Specifies to share the refund account details with PISP
Can raise:
FieldInvalid
Authorisation
hash, optional
The authorisation type request from the TPP.
Default value:
{}
AuthorisationType
string, optional
Type of authorisation flow requested.
Can raise:
FieldInvalid
CompletionDateTime
string, optional
Date and time at which the requested authorisation flow must be completed.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SCASupportData
hash, optional
Supporting Data provided by TPP, when requesting SCA Exemption.
AppliedAuthenticationApproach
string, optional
This field indicates whether the PSU was subject to SCA performed by the TPP.
Can raise:
FieldInvalid
ReferencePaymentOrderId
string, optional
If the payment is recurring then the transaction identifier of the previous payment occurrence so that the ASPSP can verify that the PISP, amount and the payee are the same as the previous occurrence.
Allowed length:
max: 128 characters
Can raise:
FieldInvalid
RequestedSCAExemptionType
string, optional
This field allows a PISP to request specific SCA Exemption for a Payment Initiation.
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
datetime, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
ExpectedSettlementDateTime
datetime, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Permission
string, required
Specifies the Open Banking service request types.
Allowed values:
Create
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, required
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ExpirationDateTime
datetime, optional
Specified date and time the exchange rate agreement will expire.
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor.
SchemeName
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Risk
hash, optional
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Related Errors
Class
Code
Description
FieldInvalid
400
An invalid value is supplied in the field. More details in error_message.
ResourceNotFound
400
Specified resource doesn't exist.
HeaderMissing
400
A required HTTP header has not been provided.
HeaderInvalid
400
An invalid value is supplied in the HTTP header.
Forbidden
403
Action is forbidden. More details in error_message.
×
Funds Confirmation
The API allows the TPP to ask an ASPSP to check funds on a payment-access-consent resource.
The media type of the body of the request.
Default value:
application/json
Can raise:
FieldInvalid
x-fapi-interaction-id
string, optional
An RFC4122 UID used as a correlation Id.
Can raise:
FieldInvalid
Accept
string, optional
Media type that is acceptable for the response.
Can raise:
FieldInvalid
x-fapi-auth-date
string, optional
The time when the PSU last logged in with the TPP.
Can raise:
FieldInvalid
x-fapi-customer-ip-address
string, optional
The PSU's IP address if the PSU is currently logged in with the TPP.
Can raise:
FieldInvalid
Authorization
string, required
Standard HTTP Header; Allows Credentials to be provided to the Authorisation / Resource Server depending on the type of resource being requested. For OAuth 2.0 / OIDC, this comprises of either the Basic / Bearer Authentication Schemes.
Can raise:
HeaderMissing, HeaderInvalid, ResourceNotFound, Forbidden
Request parameters
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
consent_payment_product(path)
string, required
The addressed consent payment resource.
Allowed values:
domestic-payment-consents, international-payment-consents
Can raise:
FieldInvalid, ResourceNotFound
consent_id(path)
string, required
The consent identifier assigned to the created resource.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus
Response headers
Header
Type
Description
Content-Type
string, required
The media type of the body of the request.
x-fapi-interaction-id
string, required
An RFC4122 UID used as a correlation Id. If provided, the ASPSP must "play back" this value in the x-fapi-interaction-id response header.
Retry-After
integer, optional
Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request.
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
Data
hash, required
Wrapper for the data.
FundsAvailableResult
hash, optional
Result of a funds availability check.
FundsAvailableDateTime
datetime, required
Date and time at which the funds availability check was generated.
FundsAvailable
boolean, required
Flag to indicate the availability of funds given the Amount in the consent request.
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Default value:
{}
Related Errors
Class
Code
Description
FieldInvalid
400
An invalid value is supplied in the field. More details in error_message.
ResourceNotFound
400
Specified resource doesn't exist.
ResourceInvalidConsentStatus
400
The action can't be performed with current status of consent.
HeaderMissing
400
A required HTTP header has not been provided.
HeaderInvalid
400
An invalid value is supplied in the HTTP header.
Unauthorized
401
Unauthorized access.
Forbidden
403
Action is forbidden. More details in error_message.
×
Payments
Create
The API allows the TPP to ask an ASPSP to create a new payment.
{"Data":{"ConsentId":"string","Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"string","MerchantCategoryCode":"string","MerchantCustomerIdentification":"string","DeliveryAddress":{"AddressLine":"string","StreetName":"string","BuildingNumber":"string","PostCode":"string","TownName":"string","CountrySubDivision":"string","Country":"GB"}}}
{"Data":{"ConsentId":"string","Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"string","MerchantCategoryCode":"string","MerchantCustomerIdentification":"string","DeliveryAddress":{"AddressLine":"string","StreetName":"string","BuildingNumber":"string","PostCode":"string","TownName":"string","CountrySubDivision":"string","Country":"GB"}}}
{"Data":{"ConsentId":"string","Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"string","MerchantCategoryCode":"string","MerchantCustomerIdentification":"string","DeliveryAddress":{"AddressLine":"string","StreetName":"string","BuildingNumber":"string","PostCode":"string","TownName":"string","CountrySubDivision":"string","Country":"GB"}}}
{"Data":{"ConsentId":"string","Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"string","MerchantCategoryCode":"string","MerchantCustomerIdentification":"string","DeliveryAddress":{"AddressLine":"string","StreetName":"string","BuildingNumber":"string","PostCode":"string","TownName":"string","CountrySubDivision":"string","Country":"GB"}}}
{"Data":{"ConsentId":"string","Initiation":{"Frequency":"EvryDay:02:03","FirstPaymentDateTime":"2017-06-05T15:15:13+00:00","FirstPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"FinalPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"RecurringPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}}}
{"Data":{"ConsentId":"string","Initiation":{"Frequency":"EvryDay:02:03","FirstPaymentDateTime":"2017-06-05T15:15:13+00:00","FirstPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"FinalPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"RecurringPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"EcommerceGoods","MerchantCategoryCode":"5967","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["Flat 7","Acacia Lodge"],"StreetName":"Acacia Avenue","BuildingNumber":"27","PostCode":"GU31 2ZZ","TownName":"Sparsholt","CountrySubDivision":"Wessex","Country":"GB"}}}
{"Data":{"ConsentId":"58923","Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Normal","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"string","MerchantCategoryCode":"string","MerchantCustomerIdentification":"string","DeliveryAddress":{"AddressLine":"string","StreetName":"string","BuildingNumber":"string","PostCode":"string","TownName":"string","CountrySubDivision":"string","Country":"GB"}}}
{"Data":{"ConsentId":"58923","Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Normal","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"string","MerchantCategoryCode":"string","MerchantCustomerIdentification":"string","DeliveryAddress":{"AddressLine":"string","StreetName":"string","BuildingNumber":"string","PostCode":"string","TownName":"string","CountrySubDivision":"string","Country":"GB"}}}
{"Data":{"ConsentId":"58924","Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"ABCD","ExtendedPurpose":"ExtendedPurpose","DestinationCountryCode":"RO","ChargeBearer":"TBD","CurrencyOfTransfer":"GBP","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}}}
{"Data":{"ConsentId":"58924","Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"ABCD","ExtendedPurpose":"ExtendedPurpose","DestinationCountryCode":"RO","ChargeBearer":"TBD","CurrencyOfTransfer":"GBP","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"TBD","ContractIdentification":"TBD"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Risk":{"PaymentContextCode":"PartyToParty","MerchantCategoryCode":"TBD","MerchantCustomerIdentification":"053598653254","DeliveryAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB"}}}
Example of response
{"Data":{"DomesticPaymentId":"string","ConsentId":"string","Status":"string","ReadRefundAccount":"string","CreationDateTime":"string","StatusUpdateDateTime":"string","CutOffDateTime":"string","ExpectedExecutionDateTime":"string","ExpectedSettlementDateTime":"string","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"DomesticPaymentId":"string","ConsentId":"string","Status":"string","ReadRefundAccount":"string","CreationDateTime":"string","StatusUpdateDateTime":"string","CutOffDateTime":"string","ExpectedExecutionDateTime":"string","ExpectedSettlementDateTime":"string","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"DomesticStandingOrderId":"58923","ConsentId":"18463","Status":"InitiationPending","CreationDateTime":"string","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"Initiation":{"Frequency":"EvryDay:02:03","FirstPaymentDateTime":"2017-06-05T15:15:13+00:00","FirstPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"FinalPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"RecurringPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-standing-order/58923","First":"/open-banking/v3.1/pisp/domestic-standing-order/58923","Last":"/open-banking/v3.1/pisp/domestic-standing-order/58925","Next":"/open-banking/v3.1/pisp/domestic-standing-order/58924","Prev":"/open-banking/v3.1/pisp/domestic-standing-order/58922"},"Meta":{"TotalPages":1}}
{"Data":{"DomesticStandingOrderId":"58923","ConsentId":"18463","Status":"InitiationPending","CreationDateTime":"string","Authorisation":{"AuthorisationType":"auth","CompletionDateTime":"2017-06-05T15:15:13+00:00"},"Charges":[{"ChargeBearer":"ChargeBearer","Type":"Type","Amount":{"Amount":"123","Currency":"GBP"}}],"Initiation":{"Frequency":"EvryDay:02:03","FirstPaymentDateTime":"2017-06-05T15:15:13+00:00","FirstPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"FinalPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"RecurringPaymentAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Links":{"Self":"/open-banking/v3.1/pisp/domestic-standing-order/58923","First":"/open-banking/v3.1/pisp/domestic-standing-order/58923","Last":"/open-banking/v3.1/pisp/domestic-standing-order/58925","Next":"/open-banking/v3.1/pisp/domestic-standing-order/58924","Prev":"/open-banking/v3.1/pisp/domestic-standing-order/58922"},"Meta":{"TotalPages":1}}
{"Data":{"InternationalPaymentId":"58923-001","ConsentId":"58923","Status":"AcceptedSettlementInProcess","ReadRefundAccount":"Yes","CreationDateTime":"2017-06-05T15:15:22+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CompletionDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":123,"Currency":"GBP"}}],"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{},"MultiAuthorisation":{"ExpirationDateTime":"2017-06-05T15:15:15+00:00","LastUpdateDateTime":"2017-06-05T15:15:15+00:00","NumberReceived":1,"NumberRequired":2,"Status":"AwaitingFurtherAuthorisation"}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"InternationalPaymentId":"58923-001","ConsentId":"58923","Status":"AcceptedSettlementInProcess","ReadRefundAccount":"Yes","CreationDateTime":"2017-06-05T15:15:22+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CompletionDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":123,"Currency":"GBP"}}],"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{},"MultiAuthorisation":{"ExpirationDateTime":"2017-06-05T15:15:15+00:00","LastUpdateDateTime":"2017-06-05T15:15:15+00:00","NumberReceived":1,"NumberRequired":2,"Status":"AwaitingFurtherAuthorisation"}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"InternationalScheduledPaymentId":"58924-001","ConsentId":"58924","Status":"AcceptedSettlementInProcess","ReadRefundAccount":"Yes","CreationDateTime":"2023-06-05T15:15:22+00:00","StatusUpdateDateTime":"2023-06-05T15:15:13+00:00","CompletionDateTime":"2023-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2023-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2023-06-05T15:15:13+00:00","Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":123,"Currency":"GBP"}}],"Debtor":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{},"MultiAuthorisation":{"ExpirationDateTime":"2017-06-05T15:15:15+00:00","LastUpdateDateTime":"2017-06-05T15:15:15+00:00","NumberReceived":1,"NumberRequired":2,"Status":"AwaitingFurtherAuthorisation"}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"InternationalScheduledPaymentId":"58924-001","ConsentId":"58924","Status":"AcceptedSettlementInProcess","ReadRefundAccount":"Yes","CreationDateTime":"2023-06-05T15:15:22+00:00","StatusUpdateDateTime":"2023-06-05T15:15:13+00:00","CompletionDateTime":"2023-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2023-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2023-06-05T15:15:13+00:00","Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":123,"Currency":"GBP"}}],"Debtor":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{},"MultiAuthorisation":{"ExpirationDateTime":"2017-06-05T15:15:15+00:00","LastUpdateDateTime":"2017-06-05T15:15:15+00:00","NumberReceived":1,"NumberRequired":2,"Status":"AwaitingFurtherAuthorisation"}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
The media type of the body of the request.
Default value:
application/json
Can raise:
FieldInvalid
x-fapi-interaction-id
string, optional
An RFC4122 UID used as a correlation Id.
Accept
string, optional
Media type that is acceptable for the response.
x-fapi-auth-date
string, optional
The time when the PSU last logged in with the TPP.
x-fapi-customer-ip-address
string, optional
The PSU's IP address if the PSU is currently logged in with the TPP.
Authorization
string, required
Standard HTTP Header; Allows Credentials to be provided to the Authorisation / Resource Server depending on the type of resource being requested. For OAuth 2.0 / OIDC, this comprises of either the Basic / Bearer Authentication Schemes.
Can raise:
HeaderMissing, HeaderInvalid, ResourceNotFound, Forbidden
x-jws-signature
string, optional
A detached JWS signature of the body of the payload.
Idempotency-Key
string, optional
Unique uuid used to recognize subsequent retries of the same request valid for 24 hours.
Allowed length:
max: 40 characters
Request parameters
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
payment_product(path)
string, required
The addressed payment resource.
Allowed values:
domestic-payments, international-payments
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
Can raise:
ResourceConsentMismatch
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
ResourceConsentMismatch
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid, ResourceInvalidFormat
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor. Should be populated in case “SEPA“ or “SEPA Instant“ local instrument schemes are applied.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
TransferReason
string, required
Transfer reason. Should be provided per each payment.Click here to review codes for all.
Can raise:
FieldInvalid
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
payment_product(path)
string, required
The addressed payment resource.
Allowed values:
domestic-payments, international-payments
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
Can raise:
ResourceConsentMismatch
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
ResourceConsentMismatch
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
payment_product(path)
string, required
The addressed payment resource.
Allowed values:
domestic-payments, international-payments
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
Can raise:
ResourceConsentMismatch
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
ResourceConsentMismatch
FinalPaymentDateTime
datetime, optional
The date on which the final payment for a Standing Order schedule will be made.
FirstPaymentDateTime
datetime, required
The date on which the first payment for a Standing Order schedule will be made.
RecurringPaymentDateTime
datetime, optional
The date on which the first recurring payment for a Standing Order schedule will be made. Usage: This must be populated only if the first recurring date is different to the first payment date.
Frequency
string, required
This is a specific format of describing the rule for creating the payments of a standing order.
It should comply with one of the permitted patterns. Full pattern represented as a regular expression which can be used for validating the value provided in this field:
^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlWkDay:0[1-9]:0[1-7])$|^(WkInMnthDay:0[1-5]:0[1-7])$|^(IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01]))$|^(QtrDay:(ENGLISH|SCOTTISH|RECEIVED))$
Can raise:
UnsupportedFrequency
NumberOfPayments
string, optional
Number of the payments that will be made in completing this frequency sequence including any executed since the sequence start date.
Can raise:
FieldInvalid
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. Usage: If available, the initiating party should provide this reference in the structured remittance information, to enable reconciliation by the creditor upon receipt of the amount of money. If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
FinalPaymentAmount
hash, optional
The amount of the final Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
FirstPaymentAmount
hash, required
The amount of the first Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
RecurringPaymentAmount
hash, optional
The amount of the recurring Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
payment_product(path)
string, required
The addressed payment resource.
Allowed values:
domestic-payments, international-payments
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
Can raise:
ResourceConsentMismatch
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
ResourceConsentMismatch
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, required
Financial institution servicing an account for the creditor.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list. Scheme name "UK.Silverbird.ABA" to be used only with the "UK.Silverbird.FEDWIRE" local instrument value.
Allowed values:
UK.OBIE.BICFI, UK.Silverbird.ABA
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument. Use UK.Silverbird.FEDWIRE for USA payments only.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid, ResourceInvalidFormat
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
TransferReason
string, required
Transfer reason. Should be provided per each payment.
Click here to review codes for all countries except Bahrain and United Arab Emirates.
Click here to review codes for payments to United Arab Emirates.
Click here to review codes for payment to Bahrain.
Can raise:
FieldInvalid
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
payment_product(path)
string, required
The addressed payment resource.
Allowed values:
domestic-payments, international-payments
Can raise:
FieldInvalid, ResourceNotFound
Risk
hash, required
The Risk section is sent by the initiating party to the ASPSP. It is used to specify additional details for risk scoring for Payments.
Default value:
{}
Can raise:
ResourceConsentMismatch
MerchantCategoryCode
string, optional
Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.
Allowed length:
min: 3, max: 4 characters
Can raise:
FieldInvalid
MerchantCustomerIdentification
string, optional
The unique customer identifier of the PSU with the merchant.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
PaymentContextCode
string, optional
Specifies the payment context
Can raise:
FieldInvalid
DeliveryAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services or in free format text.
AddressLine
array, optional
Identifies the lines of the postal address.
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government, occupying a particular territory (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid, ResourceNotFound, Unauthorized, ResourceInvalidConsentStatus
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
ResourceConsentMismatch
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor.
SchemeName
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Response headers
Header
Type
Description
Content-Type
string, required
The media type of the body of the request.
x-fapi-interaction-id
string, optional
An RFC4122 UID used as a correlation Id. If provided, the ASPSP must "play back" this value in the x-fapi-interaction-id response header.
Retry-After
integer, optional
Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request.
x-jws-signature
string, optional
A detached JWS signature of the body of the payload.
Response
Upon successful request, 201 status code will be returned. See ‘Related Errors’ table for other possibilities.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, Rejected, AcceptedSettlementInProcess, AcceptedSettlementCompleted, AcceptedWithoutPosting, AcceptedCreditSettlementCompleted
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
DomesticPaymentId
string, required
Unique identification as assigned by the ASPSP to identify the domestic payment resource.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
string, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExpectedSettlementDateTime
string, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid, ResourceInvalidFormat
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor. Should be populated in case “SEPA“ or “SEPA Instant“ local instrument schemes are applied.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
TransferReason
string, required
Transfer reason. Should be provided per each payment.Click here to review codes for all.
Can raise:
FieldInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
InitiationPending, InitiationFailed, InitiationCompleted, Cancelled
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
DomesticScheduledPaymentId
string, required
Unique identification as assigned by the ASPSP to identify the domestic scheduled payment resource.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
string, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExpectedSettlementDateTime
string, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
InitiationPending, InitiationFailed, InitiationCompleted, Cancelled
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
DomesticStandingOrderId
string, required
Unique identification as assigned by the ASPSP to identify the domestic standing order payment resource.
Can raise:
FieldInvalid
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
Can raise:
InvalidFormat
FinalPaymentDateTime
datetime, optional
The date on which the final payment for a Standing Order schedule will be made.
FirstPaymentDateTime
datetime, required
The date on which the first payment for a Standing Order schedule will be made.
RecurringPaymentDateTime
datetime, optional
The date on which the first recurring payment for a Standing Order schedule will be made. Usage: This must be populated only if the first recurring date is different to the first payment date.
Frequency
string, required
This is a specific format of describing the rule for creating the payments of a standing order.
It should comply with one of the permitted patterns. Full pattern represented as a regular expression which can be used for validating the value provided in this field:
^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlWkDay:0[1-9]:0[1-7])$|^(WkInMnthDay:0[1-5]:0[1-7])$|^(IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01]))$|^(QtrDay:(ENGLISH|SCOTTISH|RECEIVED))$
Can raise:
UnsupportedFrequency
NumberOfPayments
string, optional
Number of the payments that will be made in completing this frequency sequence including any executed since the sequence start date.
Can raise:
FieldInvalid
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. Usage: If available, the initiating party should provide this reference in the structured remittance information, to enable reconciliation by the creditor upon receipt of the amount of money. If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
FinalPaymentAmount
hash, optional
The amount of the final Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
FirstPaymentAmount
hash, required
The amount of the first Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
RecurringPaymentAmount
hash, optional
The amount of the recurring Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, Rejected, AcceptedSettlementInProcess, AcceptedSettlementCompleted, AcceptedWithoutPosting, AcceptedCreditSettlementCompleted
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
InternationalPaymentId
string, required
Unique identification as assigned by the ASPSP to identify the international payment resource.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
string, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExpectedSettlementDateTime
string, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, required
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ExpirationDateTime
datetime, optional
Specified date and time the exchange rate agreement will expire.
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, required
Financial institution servicing an account for the creditor.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list. Scheme name "UK.Silverbird.ABA" to be used only with the "UK.Silverbird.FEDWIRE" local instrument value.
Allowed values:
UK.OBIE.BICFI, UK.Silverbird.ABA
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument. Use UK.Silverbird.FEDWIRE for USA payments only.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid, ResourceInvalidFormat
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
TransferReason
string, required
Transfer reason. Should be provided per each payment.
Click here to review codes for all countries except Bahrain and United Arab Emirates.
Click here to review codes for payments to United Arab Emirates.
Click here to review codes for payment to Bahrain.
Can raise:
FieldInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, Rejected, AcceptedSettlementInProcess, AcceptedSettlementCompleted, AcceptedWithoutPosting, AcceptedCreditSettlementCompleted
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
InternationalScheduledPaymentId
string, required
Unique identification as assigned by the ASPSP to identify the international scheduled payment resource.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
string, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExpectedSettlementDateTime
string, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, required
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ExpirationDateTime
datetime, optional
Specified date and time the exchange rate agreement will expire.
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor.
SchemeName
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Related Errors
Class
Code
Description
FieldInvalid
400
An invalid value is supplied in the field. More details in error_message.
ResourceNotFound
400
Specified resource doesn't exist.
ResourceInvalidConsentStatus
400
The action can't be performed with current status of consent.
UnsupportedCurrency
400
The currency is not supported.
CountryNameInvalid
400
Country doesn't exist or is invalid. Expected alpha 2 ISO3166 format.
UnsupportedFrequency
400
Specified frequency is unsupported.
HeaderMissing
400
A required HTTP header has not been provided.
HeaderInvalid
400
An invalid value is supplied in the HTTP header.
Unauthorized
401
Unauthorized access.
Forbidden
403
Action is forbidden. More details in error_message.
×
Show
The API allows the TPP to ask an ASPSP to show a payment.
{"Data":{"DomesticPaymentId":"string","ConsentId":"string","Status":"string","CreationDateTime":"string","StatusUpdateDateTime":"string","ReadRefundAccount":"string","CutOffDateTime":"string","ExpectedExecutionDateTime":"string","ExpectedSettlementDateTime":"string","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":"string","Currency":"string"}}],"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"DomesticPaymentId":"string","ConsentId":"string","Status":"string","CreationDateTime":"string","StatusUpdateDateTime":"string","ReadRefundAccount":"string","CutOffDateTime":"string","ExpectedExecutionDateTime":"string","ExpectedSettlementDateTime":"string","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":"string","Currency":"string"}}],"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"DomesticPaymentId":"string","ConsentId":"string","Status":"string","CreationDateTime":"string","StatusUpdateDateTime":"string","ReadRefundAccount":"string","CutOffDateTime":"string","ExpectedExecutionDateTime":"string","ExpectedSettlementDateTime":"string","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":"string","Currency":"string"}}],"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"DomesticPaymentId":"string","ConsentId":"string","Status":"string","CreationDateTime":"string","StatusUpdateDateTime":"string","ReadRefundAccount":"string","CutOffDateTime":"string","ExpectedExecutionDateTime":"string","ExpectedSettlementDateTime":"string","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":"string","Currency":"string"}}],"Initiation":{"InstructionIdentification":"ANSM023","EndToEndIdentification":"FRESCO.21302.GFX.37","RequestedExecutionDateTime":"2033-08-06T00:00:00+00:00","LocalInstrument":"UK.OBIE.FPS","InstructedAmount":{"Amount":"20.00","Currency":"GBP"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"11280001234567","Name":"Andrea Smith","SecondaryIdentification":"0002"},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"Bob Clements","SecondaryIdentification":"0003"},"CreditorPostalAddress":{"AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"],"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB"},"RemittanceInformation":{"Reference":"FRESCO-037","Unstructured":"Internal ops code 5120103"},"SupplementaryData":{}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"InternationalPaymentId":"58923-001","ConsentId":"58923","Status":"AcceptedSettlementInProcess","ReadRefundAccount":"Yes","CreationDateTime":"2017-06-05T15:15:22+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CompletionDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":123,"Currency":"GBP"}}],"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Normal","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{},"MultiAuthorisation":{"ExpirationDateTime":"2017-06-05T15:15:15+00:00","LastUpdateDateTime":"2017-06-05T15:15:15+00:00","NumberReceived":1,"NumberRequired":2,"Status":"AwaitingFurtherAuthorisation"}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"InternationalPaymentId":"58923-001","ConsentId":"58923","Status":"AcceptedSettlementInProcess","ReadRefundAccount":"Yes","CreationDateTime":"2017-06-05T15:15:22+00:00","StatusUpdateDateTime":"2017-06-05T15:15:13+00:00","CompletionDateTime":"2017-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2017-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2017-06-05T15:15:13+00:00","Authorisation":{"AuthorisationType":"string","CompletionDateTime":"string"},"Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":123,"Currency":"GBP"}}],"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Normal","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{},"MultiAuthorisation":{"ExpirationDateTime":"2017-06-05T15:15:15+00:00","LastUpdateDateTime":"2017-06-05T15:15:15+00:00","NumberReceived":1,"NumberRequired":2,"Status":"AwaitingFurtherAuthorisation"}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"InternationalScheduledPaymentId":"58924-001","ConsentId":"58924","Status":"AcceptedSettlementInProcess","ReadRefundAccount":"Yes","CreationDateTime":"2023-06-05T15:15:22+00:00","StatusUpdateDateTime":"2023-06-05T15:15:13+00:00","CompletionDateTime":"2023-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2023-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2023-06-05T15:15:13+00:00","Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":123,"Currency":"GBP"}}],"Debtor":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{},"MultiAuthorisation":{"ExpirationDateTime":"2017-06-05T15:15:15+00:00","LastUpdateDateTime":"2017-06-05T15:15:15+00:00","NumberReceived":1,"NumberRequired":2,"Status":"AwaitingFurtherAuthorisation"}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
{"Data":{"InternationalScheduledPaymentId":"58924-001","ConsentId":"58924","Status":"AcceptedSettlementInProcess","ReadRefundAccount":"Yes","CreationDateTime":"2023-06-05T15:15:22+00:00","StatusUpdateDateTime":"2023-06-05T15:15:13+00:00","CompletionDateTime":"2023-06-05T15:15:13+00:00","ExpectedExecutionDateTime":"2023-06-05T15:15:13+00:00","ExpectedSettlementDateTime":"2023-06-05T15:15:13+00:00","Charges":[{"ChargeBearer":"string","Type":"string","Amount":{"Amount":123,"Currency":"GBP"}}],"Debtor":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Initiation":{"InstructionIdentification":"ACME412","EndToEndIdentification":"FRESCO.21302.GFX.20","LocalInstrument":"UK.OBIE.SWIFT","InstructionPriority":"Urgent","Purpose":"string","ChargeBearer":"string","CurrencyOfTransfer":"EUR","InstructedAmount":{"Amount":"165.88","Currency":"GBP"},"ExchangeRateInformation":{"UnitCurrency":"EUR","ExchangeRate":"0.99","RateType":"string","ContractIdentification":"string"},"DebtorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"Creditor":{"Name":"John Smith","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":"London","Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAgent":{"Name":"John Smith","SchemeName":"UK.OBIE.BICFI","Identification":"08080021325698","PostalAddress":{"AddressType":"Address with house number and street","Department":"Prime Minister's Office","SubDepartment":"Cabinet Office","StreetName":"Sir George Downing","BuildingNumber":"10","PostCode":"SW1A 2AA","TownName":"City of Westminster London,","CountrySubDivision":["London"],"Country":"GB","AddressLine":["10 Downing St, Westminster, London SW1A 2AA, United Kingdom"]}},"CreditorAccount":{"SchemeName":"UK.OBIE.SortCodeAccountNumber","Identification":"08080021325698","Name":"ACME Inc","SecondaryIdentification":"0002"},"RemittanceInformation":{"Reference":"FRESCO-101","Unstructured":"Internal ops code 5120101"},"SupplementaryData":{},"MultiAuthorisation":{"ExpirationDateTime":"2017-06-05T15:15:15+00:00","LastUpdateDateTime":"2017-06-05T15:15:15+00:00","NumberReceived":1,"NumberRequired":2,"Status":"AwaitingFurtherAuthorisation"}}},"Links":{"Self":"string","First":"string","Last":"string","Next":"string","Prev":"string"},"Meta":{"TotalPages":1}}
The media type of the body of the request.
Default value:
application/json
Can raise:
FieldInvalid
x-fapi-interaction-id
string, optional
An RFC4122 UID used as a correlation Id.
Can raise:
FieldInvalid
Accept
string, optional
Media type that is acceptable for the response.
Can raise:
FieldInvalid
x-fapi-auth-date
string, optional
The time when the PSU last logged in with the TPP.
Can raise:
FieldInvalid
x-fapi-customer-ip-address
string, optional
The PSU's IP address if the PSU is currently logged in with the TPP.
Can raise:
FieldInvalid
Authorization
string, required
Standard HTTP Header; Allows Credentials to be provided to the Authorisation / Resource Server depending on the type of resource being requested. For OAuth 2.0 / OIDC, this comprises of either the Basic / Bearer Authentication Schemes.
Can raise:
HeaderMissing, HeaderInvalid, ResourceNotFound, Forbidden
Request parameters
provider_code(path)
string, required
Human readable Provider identifier.
Can raise:
FieldInvalid, ResourceNotFound
payment_product(path)
string, required
The addressed payment resource.
Allowed values:
domestic-payments, international-payments
Can raise:
FieldInvalid, ResourceNotFound
payment_id(path)
string, required
Unique identification as assigned by the ASPSP to identify the domestic payment resource.
Can raise:
FieldInvalid, ResourceNotFound
Response headers
Header
Type
Description
Content-Type
string, required
The media type of the body of the request.
x-fapi-interaction-id
string, required
An RFC4122 UID used as a correlation Id. If provided, the ASPSP must "play back" this value in the x-fapi-interaction-id response header.
Retry-After
integer, optional
Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request.
Response
Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, Rejected, AcceptedSettlementInProcess, AcceptedSettlementCompleted, AcceptedWithoutPosting, AcceptedCreditSettlementCompleted
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DomesticPaymentId
string, required
Unique identification as assigned by the ASPSP to identify the domestic payment resource.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
string, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExpectedSettlementDateTime
string, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid, ResourceInvalidFormat
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor. Should be populated in case “SEPA“ or “SEPA Instant“ local instrument schemes are applied.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
TransferReason
string, required
Transfer reason. Should be provided per each payment.Click here to review codes for all.
Can raise:
FieldInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
InitiationPending, InitiationFailed, InitiationCompleted, Cancelled
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DomesticScheduledPaymentId
string, required
Unique identification as assigned by the ASPSP to identify the domestic scheduled payment resource.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
string, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExpectedSettlementDateTime
string, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.OBIE.SEPACreditTransfer, UK.OBIE.SEPAInstantCreditTransfer, UK.OBIE.FPS
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
CreditorPostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
InitiationPending, InitiationFailed, InitiationCompleted, Cancelled
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DomesticStandingOrderId
string, required
Unique identification as assigned by the ASPSP to identify the domestic standing order payment resource.
Can raise:
FieldInvalid
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
FinalPaymentDateTime
datetime, optional
The date on which the final payment for a Standing Order schedule will be made.
FirstPaymentDateTime
datetime, required
The date on which the first payment for a Standing Order schedule will be made.
RecurringPaymentDateTime
datetime, optional
The date on which the first recurring payment for a Standing Order schedule will be made. Usage: This must be populated only if the first recurring date is different to the first payment date.
Frequency
string, required
This is a specific format of describing the rule for creating the payments of a standing order.
It should comply with one of the permitted patterns. Full pattern represented as a regular expression which can be used for validating the value provided in this field:
^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlWkDay:0[1-9]:0[1-7])$|^(WkInMnthDay:0[1-5]:0[1-7])$|^(IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01]))$|^(QtrDay:(ENGLISH|SCOTTISH|RECEIVED))$
Can raise:
UnsupportedFrequency
NumberOfPayments
string, optional
Number of the payments that will be made in completing this frequency sequence including any executed since the sequence start date.
Can raise:
FieldInvalid
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction. Usage: If available, the initiating party should provide this reference in the structured remittance information, to enable reconciliation by the creditor upon receipt of the amount of money. If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
FinalPaymentAmount
hash, optional
The amount of the final Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
FirstPaymentAmount
hash, required
The amount of the first Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
RecurringPaymentAmount
hash, optional
The amount of the recurring Standing Order.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, Rejected, AcceptedSettlementInProcess, AcceptedSettlementCompleted, AcceptedWithoutPosting, AcceptedCreditSettlementCompleted
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
InternationalPaymentId
string, required
Unique identification as assigned by the ASPSP to identify the international payment resource.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
string, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExpectedSettlementDateTime
string, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, required
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ExpirationDateTime
datetime, optional
Specified date and time the exchange rate agreement will expire.
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, required
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, required
Financial institution servicing an account for the creditor.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list. Scheme name "UK.Silverbird.ABA" to be used only with the "UK.Silverbird.FEDWIRE" local instrument value.
Allowed values:
UK.OBIE.BICFI, UK.Silverbird.ABA
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, required
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, required
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, required
User community specific instrument. Use UK.Silverbird.FEDWIRE for USA payments only.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid, ResourceInvalidFormat
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, required
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, required
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, required
Additional information that can not be captured in the structured fields and/or any other specific block.
TransferReason
string, required
Transfer reason. Should be provided per each payment.
Click here to review codes for all countries except Bahrain and United Arab Emirates.
Click here to review codes for payments to United Arab Emirates.
Click here to review codes for payment to Bahrain.
Can raise:
FieldInvalid
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Data
hash, required
Wrapper for the data.
ConsentId
string, required
Unique identification as assigned by the ASPSP to identify the consent resource.
Can raise:
FieldInvalid
Status
string, required
Specifies the status of consent resource in code form.
Allowed values:
Pending, Rejected, AcceptedSettlementInProcess, AcceptedSettlementCompleted, AcceptedWithoutPosting, AcceptedCreditSettlementCompleted
Can raise:
FieldInvalid
CreationDateTime
string, required
Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
StatusUpdateDateTime
string, required
Date and time at which the resource status was updated. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
Charges
array, optional
Wrapper for processing of the payment transaction.
ChargeBearer
string, required
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
Type
string, required
Charge type, in a coded form.
Can raise:
FieldInvalid
Amount
hash, required
Amount of money associated with the charge type.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
Debtor
hash, optional
Set of elements used to identify a person or an organisation.
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Can raise:
FieldInvalid
MultiAuthorisation
hash, optional
The multiple authorisation flow response from the ASPSP.
Status
string, required
Specifies the status of the authorisation flow in code form.
Allowed values:
AwaitingFurtherAuthorisation, Authorised, Rejected
Can raise:
FieldInvalid
NumberReceived
integer, optional
Number of authorisations received.
NumberRequired
integer, optional
Number of authorisations required for payment order (total required at the start of the multi authorisation journey).
LastUpdateDateTime
datetime, optional
Last date and time at which the authorisation flow was updated.
ExpirationDateTime
datetime, optional
Date and time at which the requested authorisation flow must be completed.
Refund
hash, optional
Unambiguous identification of the refund account to which a refund will be made as a result of the transaction.
Account
hash, required
Provides the details to identify an account.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
InternationalScheduledPaymentId
string, required
Unique identification as assigned by the ASPSP to identify the international scheduled payment resource.
Can raise:
FieldInvalid
ExpectedExecutionDateTime
string, optional
Expected execution date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExpectedSettlementDateTime
string, optional
Expected settlement date and time for the payment resource. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
Can raise:
FieldInvalid
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, required
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ExpirationDateTime
datetime, optional
Specified date and time the exchange rate agreement will expire.
Initiation
hash, required
The Initiation payload is sent by the initiating party to the ASPSP. It is used to request movement of funds from the debtor account to a creditor for a single domestic payment.
InstructionIdentification
string, required
Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
EndToEndIdentification
string, optional
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.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
CreditorAgent
hash, optional
Financial institution servicing an account for the creditor.
SchemeName
string, optional
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.BICFI
Can raise:
FieldInvalid
Identification
string, optional
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
RequestedExecutionDateTime
datetime, required
Date at which the initiating party requests the clearing agent to process the payment.
InstructionPriority
string, optional
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.
Allowed values:
Normal, Urgent
Can raise:
FieldInvalid
DestinationCountryCode
string, optional
Country in which Credit Account is domiciled. Nation with its own government. Should be in form of 2 character code.
Can raise:
FieldInvalid, CountryNameInvalid
Purpose
string, optional
Specifies the external purpose code in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.
Can raise:
FieldInvalid
ExtendedPurpose
string, optional
Specifies the purpose of an international payment, when there is no corresponding 4 character code available in the ISO20022 list of Purpose Codes.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
ChargeBearer
string, optional
Specifies which party/parties will bear the charges associated with the processing of the payment transaction.
Allowed values:
BorneByCreditor, BorneByDebtor, FollowingServiceLevel, Shared
Can raise:
FieldInvalid
CurrencyOfTransfer
string, required
Specifies the currency of the to be transferred amount, which is different from the currency of the debtor's account.
Can raise:
FieldInvalid
InstructedAmount
hash, required
Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.
Amount
string, required
A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
Can raise:
FieldInvalid
Currency
string, required
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".
Can raise:
FieldInvalid, UnsupportedCurrency
ExchangeRateInformation
hash, optional
Provides details on the currency exchange rate and contract.
UnitCurrency
string, required
Currency in which the rate of exchange is expressed in a currency exchange. In the example 1GBP = xxxCUR, the unit currency is GBP.
Can raise:
FieldInvalid
ExchangeRate
string, optional
The factor used for conversion of an amount from one currency to another. This reflects the price at which one currency was bought with another currency.
Can raise:
FieldInvalid
RateType
string, required
Specifies the type used to complete the currency exchange.
Allowed values:
Actual, Agreed, Indicative
Can raise:
FieldInvalid
ContractIdentification
string, optional
Unique and unambiguous reference to the foreign exchange contract agreed between the initiating party/creditor and the debtor agent.
Can raise:
FieldInvalid
DebtorAccount
hash, optional
Unambiguous identification of the account of the debtor to which a debit entry will be made as a result of the transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, optional
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
RemittanceInformation
hash, optional
Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts' receivable system.
Reference
string, optional
Unique reference, as assigned by the creditor, to unambiguously refer to the payment transaction.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Unstructured
string, optional
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.
Allowed length:
max: 140 characters
Can raise:
FieldInvalid
LocalInstrument
string, optional
User community specific instrument.
Allowed values:
UK.Silverbird.FEDWIRE, UK.OBIE.SWIFT
Can raise:
FieldInvalid
CreditorAccount
hash, required
Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction.
SchemeName
string, required
Name of the identification scheme, in a coded form as published in an external list.
Allowed values:
UK.OBIE.SortCodeAccountNumber, UK.OBIE.IBAN, UK.OBIE.BBAN
Can raise:
FieldInvalid
Identification
string, required
Identification assigned by an institution to identify an account. This identification is known by the account owner.
Allowed length:
max: 256 characters
Can raise:
FieldInvalid
Name
string, required
The account name is the name or names of the account owner(s) represented at an account level, as displayed by the ASPSP's online channels.
Allowed length:
max: 350 characters
Can raise:
FieldInvalid
SecondaryIdentification
string, optional
This is secondary identification of the account, as assigned by the account servicing institution.
Allowed length:
max: 34 characters
Can raise:
FieldInvalid
Creditor
hash, optional
Party to which an amount of money is due.
Name
string, optional
Creditor name
Can raise:
FieldInvalid
PostalAddress
hash, optional
Information that locates and identifies a specific address, as defined by postal services.
AddressLine
array, optional
Identifies the lines of the postal address.
AddressType
string, optional
Identifies the nature of the postal address.
Can raise:
FieldInvalid
Department
string, optional
Identification of a division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
SubDepartment
string, optional
Identification of a sub-division of a large organisation or building.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
StreetName
string, optional
Name of a street or thoroughfare.
Allowed length:
max: 70 characters
Can raise:
FieldInvalid
BuildingNumber
string, optional
Number that identifies the position of a building on a street.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
PostCode
string, optional
Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.
Allowed length:
max: 16 characters
Can raise:
FieldInvalid
CountrySubDivision
string, optional
Identifies a subdivision of a country such as state, region, county.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
TownName
string, optional
Name of a built-up area, with defined boundaries, and a local government.
Allowed length:
max: 35 characters
Can raise:
FieldInvalid
Country
string, optional
Nation with its own government (ISO 3166-1 alpha-2 code).
Can raise:
FieldInvalid, CountryNameInvalid
SupplementaryData
hash, optional
Additional information that can not be captured in the structured fields and/or any other specific block.
Links
hash, required
A list of hyperlinks to be recognized by the TPP.
Self
string, required
The link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
First
string, optional
The first link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Last
string, optional
The last link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Next
string, optional
The next link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Prev
string, optional
The preview link to the resource initiation created by this request. This link can be used to retrieve the resource data.
Can raise:
FieldInvalid
Meta
hash, required
Wrapper for the meta.
Default value:
{}
TotalPages
integer, optional
The total number of pages.
Related Errors
Class
Code
Description
FieldInvalid
400
An invalid value is supplied in the field. More details in error_message.
ResourceNotFound
400
Specified resource doesn't exist.
HeaderMissing
400
A required HTTP header has not been provided.
HeaderInvalid
400
An invalid value is supplied in the HTTP header.
Forbidden
403
Action is forbidden. More details in error_message.
×
Codes
All Payment Purpose Codes
Purpose of Payment Code for all countries except Bahrain and UAE
Values
Payment for goods and services
Direct capital investment
Salary/Payroll
Refund
Loan
Repayment of loan
Merchant Settlement
Intercompany/group transfer
Tax Settlement
Expenses
Other
Property purchase
×
AE Payment Purpose Codes
Purpose of Payment Code for United Arab Emirates
Code
Description
ACM
Agency Commission
AES
Advance payment against EOS
AFA
Receipts or payments from personal residents bank account or deposits abroad
AFL
Receipts or payments from personal non-resident bank account in the UAE
ALW
Allowances
ATS
Air transport
BON
Bonus
CCP
Corporate Card Payment
CEA
Equity and investment fund shares for the establishment of new company from residents abroad, equity of merger or acquisition of companies abroad from residents and participation to capital increase of related companies abroad
CEL
Equity and investment fund shares for the establishment of new company in the UAE from non-residents, equity of merger or acquisition of companies in the UAE from non-residents and participation to capital increase of related companies from non-residents in the UAE
Purchases and sales of securities issued by residents in not related companies – More than a year
DOE
Dividends on equity not intra group
DSA
Purchases and sales of foreign debt securities in not related companies – Less than a year
DSF
Debt instruments intragroup foreign securities
DSL
Purchases and sales of securities issued by residents in not related companies – Less than a year
EDU
Educational Support
EMI
Equated Monthly Instalments
EOS
End of Service
FAM
Family Support
FDA
Financial derivatives foreign
FDL
Financial derivatives in the UAE
FIA
Investment fund shares foreign
FIL
Investment fund shares in the UAE
FIS
Financial services
FSA
Equity other than investment fund shares in not related companies abroad
FSL
Equity other than investment fund shares in not related companies in the UAE
GDE
Goods Sold
GDI
Goods bought
GMS
Processing repair and maintenance services on goods
GOS
Government goods and services embassies etc
GRI
Government related income taxes tariffs capital transfers etc
IFS
Information services
IGD
Intra group dividends
IGT
Inter group transfer
IID
Intra group interest on debt
INS
Insurance services
IOD
Income on deposits
IOL
Income on loans
IPC
Charges for the use of intellectual property royalties
IPO
IPO subscriptions
IRP
Interest rate swap payments
IRW
Interest rate unwind payments
ISH
Income on investment funds share
ISL
Interest on securities more than a year
ISS
Interest on securities less than a year
ITS
Computer services
LAS
Leave salary
LDL
Debt instruments intragroup loans, deposits in the UAE
LDS
Debt instruments intragroup securities in the UAE
LEA
Leasing abroad
LEL
Leasing in the UAE
LIP
Loan interest payments
LLA
Loans – Drawings or Repayments on loans extended to nonresidents – Long-term
LLL
Loans – Drawings or Repayments on foreign loans extended to residents – Long-term
LNC
Loan charges
LND
Loan disbursements
MCR
Monetary Claim Reimbursements Medical Insurance or Auto Insurance etc.
MWI
Mobile wallet cash in
MWO
Mobile wallet cash out
MWP
Mobile wallet payments
OAT
Own account transfer
OTS
Other modes of transport
OVT
Overtime
PEN
Pension
PIN
Personal Investments
PIP
Profits on Islamic products
PMS
Professional and management consulting services
POR
Refunds or Reversals on IPO subscriptions
POS
POS Merchant Settlement
PPA
Purchase of real estate abroad from residents
PPL
Purchase of real estate in the UAE from non-residents
PRP
Profit rate swap payments
PRR
Profits or rents on real estate
PRS
Personal cultural audio visual and recreational services
PRW
Profit rate unwind payments
RDS
Research and development services
RFS
Repos on foreign securities
RLS
Repos on securities issued by residents
RNT
Rent payments
SAA
Salary advance
SAL
Salary
SCO
Construction
SLA
Loans – Drawings or Repayments on loans extended to nonresidents – Short-term
SLL
Loans – Drawings or Repayments on foreign loans extended to residents – Short-term
STR
Travel
STS
Sea transport
SVI
Stored value card cash-in
SVO
Stored value card cash-out
SVP
Stored value card payments
TCP
Trade credits and advances payable
TCR
Trade credits and advances receivable
TCS
Telecommunication services
TKT
Tickets
TOF
Transfer of funds between persons Normal and Juridical
TTS
Technical trade-related and other business services
UTL
Utility Bill Payments
×
BH Payment Purpose Codes
Purpose of Payment Code for Bahrain
Code
Description
GDE
Goods sold (Exports in fob value)
GDI
Goods bought (Imports in cif value)
STS
Sea Transport
ATS
Air transport
OTS
OTS Other methods of transport (including Postal and courier services)
STR
Travel
GMS
Processing repair and maintenance services on goods
SCO
Construction
INS
Insurance Services
FIS
Financial Services
IPC
Charges for the use of intellectual property royalties
TCS
Telecommunications services
ITS
Computer services
IFS
Information services
RDS
Research and development services
PMS
Professional and management consulting services
TTS
Technical, trade- related and other business services
PRS
Personal, cultural, audiovisual and recreational services
IGD
Dividends intragroup
IID
Interest on debt intragroup
PIP
Profits on Islamic products
PRR
Profits or rents on real estate
DOE
Dividends on equity not Intragroup
ISH
Income on investment funds shares
ISL
Interest on securities more than a year
ISS
Interest on securities less than a year
IOL
Income on loans
IOD
Income on deposits
GOS
Government goods and services embassies etc
GRI
Government related income taxes, tariffs, capital transfers, etc
CHC
Charitable Contributions (Charity and Aid)
FAM
Family Support (Workers’ remittances)
SAL
Salary (Compensation of employees)
PPA
Purchase of real estate abroad from residents
PPL
Purchase of real estate in Bahrain from non-residents
CEA
Equity and Investment fund shares for the establishment of new company from residents abroad, equity of merger or acquisition of companies abroad from residents and participation to capital increase of related companies abroad
DSF
Debt instruments Intragroup foreign securities
REL
Reverse equity share in Bahrain
RDL
Reverse debt instruments in Bahrain
FSA
Equity other than investment fund shares in not related companies abroad
FIA
Investment fund shares foreign
DSA
Purchases and sales of foreign debt securities in not related companies- Less than a year
DLA
Purchases and sales of foreign debt securities in not related companies- More than a year
Receipts or payments from personal residents bank account or deposits abroad
SLA
Loans- Drawings or Repayments on loans extended to nonresidents- Short-term
LLA
Loans- Drawings or Repayments on loans extended to nonresidents- Long-term
LEA
Leasing abroad
RFS
Repos on foreign securities
TCR
Trade credits and advances receivable
CEL
Equity and Investment fund shares for the establishment of new company in Bahrain from non-residents, equity of merger or acquisition of companies in Bahrain from non-residents and participation to capital increase of related companies from non-residents in Bahrain
LDS
Debt instruments intragroup securities in Bahrain
REA
Reverse equity share abroad
RDA
Reverse debt instruments abroad
FSL
Equity other than investment fund shares in not related companies in Bahrain
FIL
Investment fund shares in Bahrain
DSL
Purchases and sales of securities issued by residents in not related companies- Less than a year
DLL
Purchases and sales of securities issued by residents in not related companies- More than a year
FDL
Financial derivatives in Bahrain
LDL
Debt Instruments Intragroup loans, deposits in Bahrain (above 10% share)
AFL
Receipts or payments from personal nonresidents bank account in Bahrain
SLL
Loans- Drawings or Repayments on foreign loans extended to residents- Short-term
LLL
Loans- Drawings or Repayments on foreign loans extended to residents- Long-term