Dedicated API for TPP Developers

The OpenID Configuration at https://dia.fire.com/.well-known/openid-configuration specifies the various endpoints and algorithms supported by fire.com.

Register applications at https://dia.fire.com/tpp/register.

fire.com accepts SSAs signed by Open Banking or self-signed. If you are providing a self-signed SSA, create it as follows and sign it using your eIDAS QSealC key. All fields are required.

{
"iss": "Must match the organizationIdentifier (OID.2.5.4.97) from your eIDAS QSealC - e.g. PSDIE-CBI-C58301",
"org_jwks_endpoint": "A HTTPS URI pointing to your eIDAS QSealC public key in JWKS format",
"software_client_name": "Provide a name for the client. Will be visible to PSUs.",
"software_logo_uri": "A HTTPS URI to a PNG/JPG formatted logo for this client/company",
"org_id": "Must match the iss field above - e.g. PSDIE-CBI-C58301",
"org_name": "Must match the Organization Name (O) field in the eIDAS QSealC - e.g. Fire Financial Services Limited",
"jti": "Unique JWT ID"
}

The token endpoint at https://dia.fire.com/oauth/token is used to retrieve access tokens.

Access Token for consent request.

Use a client_credentials grant with tls_client_auth to retrieve the access token.

fire.com access tokens are in JWT format, and expire in 600 seconds.

The /accounts endpoint is paginated and will return a max of 25 accounts per page.

The /balances endpoint is paginated and will return a max of 25 accounts per page.

The /transactions and /accounts/{accountId}/transactions endpoints are paginated and will return a max of 25 transactions per page.

The /beneficiaries endpoints are paginated and will return a max of 25 beneficiaries per page.

The /accounts/{accountId}/beneficiaries endpoint will return only beneficiaries of the same currency as the account specified. For example, if {accountId} is a sterling account, only sterling beneficiaries will be returned.

fire.com beneficiaries are not tied to an account, so every account of the same currency will return the same list of beneficiaries.

The /direct-debits and /accounts/{accountId}/direct-debits endpoints are paginated and will return a max of 25 mandates per page.

The /party endpoint will return the details of the user who has signed into fire.com and provided the consent.

The /accounts/{accountId}/party endpoint provides the details of the account name for the specified fire.com account.

fire.com do not provide these endpoints.

All fire.com payments – either in Sterling or Euro – are domestic payments. It is only possible to initiate sterling payments from fire.com sterling accounts, and euro payments from fire.com euro accounts.

fire.com do not currently support standing orders or scheduled payments.

fire.com treats the references and identifiers in the payment request as follows:

• Initiation/EndToEndIdentification – at present it is not possible for the EndToEndIdentification to be passed in the payment. We are working on a fix for this.
• Initiation/InstructionIdentification – ignored.
• Initiation/RemittanceInformation/Unstructured – ignored.
• Initiation/RemittanceInformation/Reference – this will appear on the payer and payee’s statement.
• Initiation/CreditorAccount/Name – will be displayed on the fire.com PSU’s statement as the payee name.