Payment Initiation Service Provider

Here you’ll find all of the information you need to know about how we've implemented the API standards defined by Open Banking for Payment Initiation Service Providers (PISP).

To view the latest version of the Open Banking standards and specifications, visit the Open Banking Developer Zone.


Version Supported

Date

Production

Sandbox

March 2019

N/A

v3.1

July 2019

v3.1.1

v.3.1.1

Our PISP APIs

Here you’ll find all of the available endpoints that we currently support.


Domestic payments

This can be used to initiate a single domestic payment for a Tesco Bank account.

What to know when using this API

  • For Clubcard Pay+ and savings accounts, single domestic payments will typically happen immediately but may take up to 2 hours to fully process (i.e. settlement completed), depending on the Bank.
  • For credit cards, we only support single domestic payments with a LocalInstrument of UK.OBIE.MoneyTransfer or UK.OBIE.BalanceTransfer. These will typically be in the payee's account by the end of the next working day. The payment will have a status of “Pending” during processing and, once fully processed, will change to a status of either “AcceptedSettlementComplete” or “Rejected”.
  • When a request is made with the same idempotency key as a previous request, it’ll receive a cached response if submitted within 24 hours of a successfully executed previous request. Alternatively, it’ll be treated as new if the previous request was not successfully processed.

Payment validation rules

Set Up Payment Order Consent (Faster Payment)

LocalInstrument

When LocalInstrument is blank - the request will be processed as a Faster Payment.

When LocalInstrument is UK.OBIE.FPS - the request will be processed as a Faster Payment. For all payments, Instructed Amount must be specified to no more than two decimal places.

Amount

Lower Limit: For all payments, Instructed Amount/Amount must be greater than or equal £0.01.

Upper Limit: For all payments, Instructed Amount/Amount must be less than or equal £10,000.00.

Note: During consent authorisation and payment submission further payment limit validation will be applied relating to customer daily limits.

Currency

Instructed Amount/Currency must be set to GBP.

Creditor Account

CreditorAccount/SchemeName must be set to UK.OBIE.SortCodeAccountNumber or UK.OBIE.IBAN.

If Scheme Name is set to SortCodeAccountNumber then the Identification must be set as a valid UK sort code and account number.

If Scheme Name is set as IBAN then the Identification must be set as a valid UK IBAN.

Debtor Account

Debtor Account is optional.

If supplied, DebtorAccount/SchemeName must be set to UK.OBIE.SortCodeAccountNumber or UK.OBIE.IBAN.

Mandatory attributes

All mandatory attributes as specified in Open Banking Standards must be supplied.

Format validation

If supplied, the following attributes must conform to the maximum field length validation as below:

Attribute

Maximum Field Length

InstructedAmount/Amount

15

CreditorAccount/Name

35

CreditorAccount/SecondaryIdentification

13

RemittanceInformation/Reference

18

CreditorPostalAddress/StreetName

35

The above attributes must conform to the data format validation specified in the Domestic Payments spec.

All other supplied attributes must conform to the maximum field length and data format validation specified in the Domestic Payments specification.

The single domestic payment consent request must not contain attributes that cannot be mapped to the object OBWriteDomesticConsent2

Set Up Payment Order Consent (Balance Transfer)

LocalInstrument

When LocalInstrument is UK.OBIE.BalanceTransfer the request will be processed as a Balance Transfer.

Amount

InstructedAmount/Amount must be greater than or equal to £1 for all payments, Instructed Amount must be specified to no more than two decimal places.

Currency

Instructed Amount/Currency must be set to GBP.

Creditor Account

CreditorAccount/SchemeName must be set to UK.OBIE.PAN. When a PAN is supplied for a Creditor Account it must be <=18 numeric characters.

Debtor Account

Debtor Account is optional. If supplied, DebtorAccount/SchemeName must be set to UK.OBIE.UK.OBIE.PAN.

Mandatory attributes

All mandatory attributes as specified in Open Banking Standards must be supplied.

Format validation

If supplied, the following attributes must conform to the maximum field length validation as below:

Attribute

Maximum Field Length

InstructedAmount/Amount

15

CreditorAccount/Name

35

CreditorAccount/SecondaryIdentification

13

RemittanceInformation/Reference

18

CreditorPostalAddress/StreetName

35

Set Up Payment Order Consent (Money Transfer)

LocalInstrument

When LocalInstrument is UK.OBIE.MoneyTransfer the request will be processed as a Money Transfer.

Amount

InstructedAmount/Amount must be greater than or equal to £1 for all payments, Instructed Amount must be specified to no more than two decimal places.

Currency

Instructed Amount/Currency must be set to GBP.

Creditor Account

CreditorAccount/SchemeName must be set to UK.OBIE.SortCodeAccountNumber or UK.OBIE.IBAN. If Scheme Name is set to SortCodeAccountNumber then the Identification must be set as a valid UK sort code and account number. If Scheme Name is set as IBAN then the Identification must be set as a valid UK IBAN.

Debtor Account

Debtor Account is optional. If supplied, DebtorAccount/SchemeName must be set to UK.OBIE.UK.OBIE.PAN.

Reference

Reference must be blank.

Secondary Identification Reference must be blank.

Mandatory attributes

All mandatory attributes as specified in Open Banking Standards must be supplied.

Format validation

If supplied, the following attributes must conform to the maximum field length validation as below:

Attribute

Maximum Field Length

InstructedAmount/Amount

15

CreditorAccount/Name

35

CreditorPostalAddress/StreetName

35


Domestic Scheduled Payments

This API can be used to schedule a one-off payment from a Tesco Bank account.

What to know when using this API

Products supported:

  • Savings Accounts
  • Clubcard Pay+
  • Round Up

When a request is made with the same idempotency key as a previous request, it’ll receive a cached response if submitted within 24 hours of a successfully executed previous request. Alternatively, it’ll be treated as new if the previous request was not successfully processed.

For both POST/domestic-scheduled-payments & GET/domestic-scheduled-payments, the status returned will always either be “InitiationCompleted” or “InitiationFailed” upon set up.

Rules

LocalInstrument

When LocalInstrument is blank or set as UK.OBIE.FPS the request will be processed as a Faster Payment.

All other values will be rejected.

Amount

Lower Limit: For all payments, Instructed Amount/Amount must be greater than or equal £0.01.

Upper Limit: For all payments, Instructed Amount/Amount must be less than or equal £10,000.00.

Currency

Instructed Amount/Currency must be set to GBP.

Creditor Account

CreditorAccount/SchemeName must be set to UK.OBIE.SortCodeAccountNumber or UK.OBIE.IBAN.

If Scheme Name is set to SortCodeAccountNumber then the Identification must be set as a valid UK sort code and account number.

If Scheme Name is set as IBAN then the Identification must be set as a valid UK IBAN.

Debtor Account

Debtor Account is optional.

If supplied, DebtorAccount/SchemeName must be set to UK.OBIE.SortCodeAccountNumber or UK.OBIE.IBAN.

If supplied, the sort code must be a Tesco Bank sort code (range 40-64-00 to 40-64-22).

Request Execution Date Time

Time is ignored, only date portion is respected

Requested execution date must be after today, and <= (today + 1 year)

Mandatory attributes

All mandatory attributes must be supplied

Format validation

If supplied, the following attributes must conform to the maximum field length validation as below

Attribute

Maximum Field Length

InstructedAmount/Amount

15

CreditorAccount/Name

35

CreditorAccount/SecondaryIdentification

13

RemittanceInformation/Reference

18

CreditorPostalAddress/StreetName

35


Confirmation of funds

This API can be used to confirm that a specific amount is available from a Tesco Bank account.

What to know when using this API

Validate Scheme Name and Identification

If Scheme Name is set to SortCodeAccountNumber then the Identification must be set as a valid UK sort code and account number. If Scheme Name is set as IBAN then the Identification must be set as a valid UK IBAN.

Post / Funds-Confirmations

Currency field must contain value GBP or the confirmation of funds request will be rejected.