Implementation Guide: HSBC Business


This page has been created and maintained by the relevant ASPSP, and OBIE takes no liability for the completeness nor accuracy of this data.


ASPSPHSBC
BrandHSBC Business 
Date 
Developer portal (s)https://develop.hsbc.com/

Announcements

See https://develop.hsbc.com/

On-boarding

Supports dynamic client registration (Y/N)Y
Instructions for manual onboardingManual onboarding is not supported
OIDC .well-known endpoint


https://api.ob.business.hsbc.co.uk/.well-known/openid-configuration (3.1.6)

Notes on testing
Other on-boarding notes

redirect_uris MUST match or be a subset of the software_redirect_uris claim in the SSA

Authority validation is based around the IANA supported list of Top Level Domains as per https://www.iana.org/domains/root/db;
Documentation URL


https://develop.hsbc.com/sites/default/files/open_banking/HSBC%20Open%20Banking%20TPP%20Implementation%20Guide%20(v3.1).pdf

Account Information API

Swagger version
Base URI


https://api.ob.business.hsbc.co.uk/obie/open-banking/v3.1/aisp/    (3.1.6)

General variances to specification 


For transaction pagination strategy under v3.1.6, please refer to documentation URL

Non-functional limitations
RefAreaFieldAvailable (Y/N)Exception/Notes (inc details on classification codes, field limits, and field formats)





Payment Initiation API

Swagger version
Base URI


https://api.ob.business.hsbc.co.uk/obie/open-banking/v3.1/pisp/     (3.1.6)

General variances to specification

HSBC requires PaymentContextCode to be treated as mandatory- see below.

Non-functional limitations
RefAreaFieldAvailable (Y/N)Exception/Notes (inc details on classification codes, field limits, and field formats)





Card Based Payment Instrument Issuer API

Swagger version
Base URI


https://api.ob.business.hsbc.co.uk/obie/open-banking/v3.1/cbpii/      (3.1.6)

General variances to specification
Non-functional limitations
RefAreaFieldAvailable (Y/N)Exception/Notes (inc details on classification codes, field limits, and field formats)





Open Data API

Swagger version
Base URI
General variances to specification 
Non-functional limitations
RefAreaFieldAvailable (Y/N)Exception/Notes (inc details on classification codes, field limits, and field formats)