API Market documentation

Corporate Payments API - details

The Corporate Payments API facilitates client applications (consumers) to initiate credit transfer payments from any nominated Nordea customer payment account (the debtor account). There are a number of conditions as to who may initiate payment, who is required to authorize payment and what rules need to be followed when formulating a payment instruction. These details are explained within this API specification.
The Corporate Payments API enables initiation (creation and subsequent customer authorization) of credit transfer instructions. The consuming client application can use API requests to:

Create a payment instruction - single credit transfer instructions only
Orchestrate customer authorization of the payment instruction
Track payment execution status
Cancelling the payment

Changes from the previous version

This is the change log of Corporate payments API. The topmost item is the latest version and the changes described in it are relative to the previous version which is listed directly below. The current version of the API documentation is 2.19. It is related to Corporate payments API version 2.

Version 2.21

Changes in templates as mentioned below -

Template	Change
SEPA_INSTANT_CREDIT_TRANSFER_FI	Template is extended to support Creditor’s Address details (Town and Country) and extend maximum length of Creditor’s Name field to 70.
INSTANT_CREDIT_TRANSFER_DK	Template is extended to support Creditor’s Address details (Town and Country) and extend maximum length of Creditor’s Name field to 140.
INTERCOMPANY_INSTANT_CREDIT_TRANSFER_DK	Template is extended to support Creditor’s Address details (Town and Country) and extend maximum length of Creditor’s Name field to 140.
INSTANT_SALARY_PENSION_DK	Template is extended to support Creditor’s Address details (Town and Country) and extend maximum length of Creditor’s Name field to 140.

Version 2.20

QRT (Nordea ID device) authentication method added for REDIRECT flow. Currently only available for Sandbox.

Version 2.19

Nordea has introduced two new payment request templates for Danish instant DKK salary and pension and intercompany Danish instant DKK transfers, as shown below. The templates are currently available in sandbox.

Template	Payment Type
INSTANT_SALARY_PENSION_DK	Initiation of instant salary or pension payments in Denmark. The debtor account is in Nordea DK and creditor account is in Nordea DK or in another Danish bank.
INTERCOMPANY_INSTANT_CREDIT_TRANSFER_DK	Initiation of intercompany instant credit transfers in Denmark. The debtor account is in Nordea DK and creditor account is in Denmark and registered in the same agreement as debtor account.

EXPRESS urgency will be decommissioned for Danish payments from 22nd of April 2024. The functionality will be available under new templates:
- INSTANT_CREDIT_TRANSFER_DK
- INSTANT_SALARY_PENSION_DK
- INTERCOMPANY_INSTANT_CREDIT_TRANSFER_DK

Version 2.18

Nordea has introduced new payment request template for Danish Instant DKK transfers, as shown below. The template is currently available in sandbox.

Template	Payment Type
INSTANT_CREDIT_TRANSFER_DK	Initiation of instant credit transfers in Denmark. The debtor account is in Nordea DK and creditor account is in Nordea DK or in another Danish bank.

Version 2.17

Authentication type MTA_OFF removed from sandbox. It will not be available in production during May’24 (please refer to the official communication).

Version 2.16

Added optional creditor.bank.bic field for INTERCOMPANY_DOMESTIC_PAYMENT_SE template
Changed creditor.bank.bank_code field to optional for SDV_DOMESTIC_PAYMENT_SE and DOMESTIC_CREDIT_TRANSFER_SE templates

Version 2.15

Changes related to the documentation - Removed older (v1.xx) change logs, cosmetic changes with the text, updated the test data

Version 2.14

Change in Swedish BankID authentication method related to QR code (mentioned in section ‘BankID SE (decoupled flow)’)

Version 2.13

Payment response model includes a new field ‘execution_date’ that returns payment’s execution date
Payment list filtering endpoint includes two new parameters: ‘execution_from_date’ and ‘execution_to_date’

Version 2.12

Nordea has introduced new payment request templates for Global Cash Pool transfers, as shown below. The templates are currently available in sandbox.

Template	Payment Type
GLOBAL_CASH_POOL_TRANSFER_FI	Initiation of Global Cash Pool transfers from Finland to the Nordic countries
GLOBAL_CASH_POOL_TRANSFER_SE	Initiation of Global Cash Pool transfers from Sweden to the Nordic countries
GLOBAL_CASH_POOL_TRANSFER_DK	Initiation of Global Cash Pool transfers from Denmark to the Nordic countries
GLOBAL_CASH_POOL_TRANSFER_NO	Initiation of Global Cash Pool transfers from Norway to the Nordic countries

Version 2.11

Changes in templates as mentioned below -

Template	Change
SEPA_INSTANT_CREDIT_TRANSFER_FI	New template is added to Sandbox. Initiation of SEPA Credit Transfer Instant in Euro in the SEPA area from Finland. Creditor bank must be part of the SEPA Instant scheme.
INTERCOMPANY_DOMESTIC_PAYMENT_FI	Template is extended to support local cash pool and external credit accounts.
INTERCOMPANY_CURRENCY_TRANSFER_FI	Template is extended to support external credit accounts.
INTERCOMPANY_CROSS_BORDER_FI	Template is extended to support external credit accounts.
INTERCOMPANY_DOMESTIC_PAYMENT_DK	Template is extended to support external credit accounts.
INTERCOMPANY_CURRENCY_TRANSFER_DK	Template is extended to support external credit accounts.
INTERCOMPANY_CROSS_BORDER_DK	Template is extended to support external credit accounts.
INTERCOMPANY_DOMESTIC_PAYMENT_SE	Template is extended to support external credit accounts.
INTERCOMPANY_CURRENCY_TRANSFER_SE	Template is extended to support external credit accounts.
INTERCOMPANY_CROSS_BORDER_SE	Template is extended to support external credit accounts.
INTERCOMPANY_DOMESTIC_PAYMENT_NO	Template is extended to support external credit accounts.
INTERCOMPANY_CROSS_BORDER_NO	Template is extended to support external credit accounts.

Version 2.10

Changes in templates as mentioned below -

Template	Change
SALARY_PENSION_DK	Template is introduced in production.
INTERCOMPANY_DOMESTIC_PAYMENT_FI	Template is introduced in production.
INTERCOMPANY_CROSS_BORDER_FI	Template is introduced in production.
INTERCOMPANY_CURRENCY_TRANSFER_FI	Template is introduced in production.
SALARY_PAYMENT_NO	Template is introduced in production.
INTERCOMPANY_DOMESTIC_PAYMENT_NO	Template is introduced in production.
INTERCOMPANY_CROSS_BORDER_NO	Template is introduced in production.

Version 2.9

Nordea has introduced recurring payments which will allow customers to set a recurrence for different payment types. This feature has been introduced for only Finland and available for all payments types, except Financial payment template (FINANCIAL_PAYMENT_FI). This is currently available only in Sandbox.
Changes in templates as mentioned below -

Template	Change
SDV_DOMESTIC_PAYMENT_SE	Template is introduced in production.
SALARY_PAYMENT_NO	New template is added to Sandbox. Initiation of salary payments where the debtor and creditor accounts are in NOK. Debtor account is in Nordea Norway. Creditor account is in any bank in Norway (also in Nordea).
SALARY_PENSION_DK	New template is added to Sandbox. Initiation of salary or pension payments where the debtor and creditor account is in DKK and Nordea Denmark.

Version 2.8

Information for licensed third parties (TPPs) accessing Nordea’s PSD2 APIs, mentioned in Payment Flow section.
Nordea has introduced new payment request template to Corporate Payments API for Sweden, as shown below.

Template	Change
SDV_DOMESTIC_PAYMENT_SE	New template is added to Sandbox. Initiation of same day value transfer where the debit account is in Nordea SE and credit account is in other Swedish bank, other than Nordea. Both account and payment currency must be SEK.

Version 2.7

Nordea has introduced new payment request template to Corporate Payments API for Norway, as shown below.

Template	Change
INTERCOMPANY_DOMESTIC_PAYMENT_NO	New template is added to Sandbox. Initiation of transfer where the debit account is in Nordea NO and credit account is in Nordea NO or in another Norwegian bank. Both account and payment currency must be NOK.
INTERCOMPANY_CROSS_BORDER_NO	New template is added to Sandbox. Initiation of a currency transfer where debtor account is in Nordea NO and the creditor account is in Nordea NO, in another Norwegian bank or any bank outside Norway. At least one of the accounts or payment amount is other than NOK.

Version 2.6

Nordea has introduced new payment request template to Corporate Payments API for Finland, as shown below. Currently, this is available in sandbox only.

Template	Change
INTERCOMPANY_DOMESTIC_PAYMENT_FI	Initiation of transfer where the debit account is in Nordea FI and credit account is in Nordea FI or in another Finnish bank. Transfer is accepted for EUR currency only.
INTERCOMPANY_CROSS_BORDER_FI	Initiation of a currency transfer to any bank outside Finland. The debtor account belongs to Nordea Finland and can be in any currency.
INTERCOMPANY_CURRENCY_TRANSFER_FI	Initiation of a currency transfer where the debit and credit accounts are in Nordea FI. At least one of the accounts or payment amount is other than EUR.

Changes in templates as mentioned below -

Template	Change
INTERCOMPANY_DOMESTIC_PAYMENT_DK	Template is introduced in production.
INTERCOMPANY_CROSS_BORDER_DK	Template is introduced in production.
INTERCOMPANY_CURRENCY_TRANSFER_DK	Template is introduced in production.

Version 2.5

Nordea has introduced new payment request template to Corporate Payments API for Denmark, as shown below.

Template	Change
INTERCOMPANY_DOMESTIC_PAYMENT_DK	New template is added to Sandbox. Initiation of transfer where the debit account is in Nordea DK and credit account is in Nordea DK or in another Danish bank. Transfer is allowed between DKK currency, with accounts in Nordea DK. For creditor account in other Danish bank, transfer is accepted only for DKK currency.
INTERCOMPANY_CROSS_BORDER_DK	New template is added to Sandbox. Initiation of a currency transfer to any bank outside Denmark. The debtor account belongs to Nordea Denmark and can be in any currency.
INTERCOMPANY_CURRENCY_TRANSFER_DK	New template is added to Sandbox. Initiation of a currency transfer where the debit and credit accounts are in Nordea DK. At least one of the accounts or payment amount is other than DKK.

Version 2.4

BankID authentication added for Decoupled flow, applicable for SE. Currently only available for Sandbox.
Changes in templates as mentioned below -

Template	Change
INTERCOMPANY_DOMESTIC_PAYMENT_SE	Template is introduced in production.
INTERCOMPANY_CROSS_BORDER_SE	Template is introduced in production.
INTERCOMPANY_CURRENCY_TRANSFER_SE	Template is introduced in production.

Version 2.3

Transfers within own agreement is now enabled for all the templates.
Nordea has introduced new payment request template to Corporate Payments API for Sweden, as shown below.

Template	Change
INTERCOMPANY_DOMESTIC_PAYMENT_SE	Initiation of transfer where the debit account is in Nordea SE and credit account is in Nordea SE or in another Swedish bank. Transfer is allowed between EUR and/or SEK currency, with accounts in Nordea SE. For creditor account in other Swedish bank, transfer is accepted only for SEK currency.
INTERCOMPANY_CROSS_BORDER_SE	Initiation of a currency transfer to any bank outside Sweden. The debtor account in any currency is in Nordea Sweden.
INTERCOMPANY_CURRENCY_TRANSFER_SE	Initiation of a currency transfer where the debit and credit accounts are in Nordea SE. At least one of the accounts or payment amount is other than SEK or EUR.

Version 2.2

Updated “Codes App” application name to “Nordea ID”
Added new header request for Verify endpoint during Payment Initiation (X-Response-Scenarios : paymentVerificationRequired). Currently only available for Sandbox.

Version 2.1

Support for confirmation and cancellation of multiple payments.

Version 2.0

Payments redirect authorization flow introduced for BankID verification in Sweden and CodesApp for all countries.
Authentication type selection added for initiate, confirm and cancel payment requests.
Changed confirmation endpoint uri by appending “/confirm” action.

Payment Flow

The choices available for the scope parameter when seeking Access Authorization via the Corporate Access Authorization endpoint have also been extended to include: "scope": ["PAYMENTS_PSD2"] Client applications must have obtained and present an access token with this scope in order to exercise the Payments endpoint. For more details please see: Corporate Access Authorization API.

In the simplest possible case the flow might be represented diagrammatically thus:

Payment Flow Diagram 1

However, if authorization is required from more than one payment service user, the flow might be extended to appear thus:

Payment Flow Diagram 2

Payment Initiation services are accessed via the following endpoints

Payment initiation

POST /corporate/v2/payments

Initial (POST) request received to initiate payment via the API. The request includes the payment instruction and authorization details with possibility to select preferred authentication option. To read more details about authentication options please see: Corporate Payments API - Authentication Types. Sending different Payment Template Id will result with initiation of different credit transfer type. Each of requests assigned to each template id has its specific validations and fields available.

Nordea’s Open Banking service will verify the payment instruction, return a payment identifier (payment _id) to the client and automatically initiate authentication of the payment service end-user making the request. If only one user is required to authorize the payment then once the user’s authentication has been successfully completed the payment instruction will be passed for processing to Nordea’s payment engine and executed according to the payment scheme rules.

The payment can be also suspended, for example due to security reasons, then the payment will require an additional verification through strong customer authentication. Those cases can be identified by two fields in the response: “payment_status” with value “AUTHORIZATION_PARTIAL” and “payment_status_reason” with value “info.payment.verification_required”. In such case, please follow the Confirm payment execution scenario.

If the error occurs during payment initiation, the payment can change the status to “PAYMENT_REJECTED”, in such case the payment can’t be processed any more and new one needs to be initiated if needed.

Confirm payment execution

PUT /corporate/v2/payments/<payment_id>/confirm

If the confirmation fails for any reason, the status will change to “AUTHORIZATION_FAILED”. The reason for failure should be found and resolved, then the confirmation request can be sent again with same or different authorization details.

All payments apart from SEPA_INSTANT_CREDIT_TRANSFER_FI needs to be confirmed before the end of its requested execution date, or they will be rejected.

Confirm multiple payment execution

POST /corporate/v2/payments/confirm

Should further authorization be required before the payment can be executed (payments which need to be authorized by 2, 3 or even 4 independent users), then payment status records a state of AUTHORIZATION_PARTIAL, inviting the client to nominate an additional user to authenticate and advance the payment authorization process. The request accepts the list of payment ids which must contain the payment ids originally returned from the initiation of a credit transfer payment and authorization details with possibility to select preferred authentication option. All payments will be signed with a single SCA. Upon success, status of each payment object will be updated to AUTHORIZATION_PENDING. Current maximum number of the payments that can be confirmed at once is 20.

All payments apart from SEPA_INSTANT_CREDIT_TRANSFER_FI needs to be confirmed before the end of its requested execution date, or they will be rejected.

Information for licensed third parties (TPPs) accessing Nordea’s PSD2 APIs : Users are able to confirm multiple payments. When using the signing functionality for multiple payments, the PISP (Payment Initiation Service Provider) needs to ensure that the payer can view a list of the payees during the authentication.

Get payment details

GET /corporate/v2/payments/<payment_id>

At any stage of the process the client application can obtain status of the payment instruction’s progress by making a GET request which returns full details of the instruction and its current state.

Fetching list of payments

GET /corporate/premium/v2/payments

Request list of the payment instructions with details and status. The response delivers the current status and all details of the payment instructions matching the search criteria. The response is paginated with the maximum number of payment instructions per page is 20.

Cancel a Payment

PATCH /corporate/premium/v2/payments/<payment_id>

Used for payments cancellation. The “payment_id” in the request must be the payment id (_id) originally returned from the initiation of a credit transfer payment. Upon success, the status of the payment object will be updated to “AUTHORIZATION_PENDING” together with the status reason “info.payment.cancellation_in_progress”

Cancelled payments will be still available to see but their “payment_status” will be visible as “PAYMENT_CANCELLED” which is the final status, therefore those payments cannot be changed anymore. Not all statuses can be cancelled, for example, payments with status “PAYMENT_REJECTED”, “AUTHORIZATION_PENDING” or “PAYMENT_EXECUTED” cannot be cancelled.

Cancel multiple payments

POST /corporate/premium/v2/payments/cancel

Request to authorize the payment cancellation instructions. Request accepts the list of payment ids which must contain the payment ids originally returned from the initiation of a credit transfer payment and authorization details with possibility to select preferred authentication option. All payments will be signed with a single SCA. Upon success, status of each payment object will be updated to “AUTHORIZATION_PENDING” together with the status reason “info.payment.cancellation_in_progress”. Current maximum number of the payments that can be confirmed at once is 20.

Payment templates

The following templates are available when requesting initiation of a credit transfer.

Template id	Description of the payment	Available in Sandbox	Available in production
DENMARK
Domestic templates
DOMESTIC_CREDIT_TRANSFER_DK	Initiation of Danish Domestic Bank Transfer in DKK.	Yes	Yes
DOMESTIC_TRANSFER_FORM_WITH_OCR_DK	Initiation of Danish Transfer Form with reference in DKK.	Yes	Yes
DOMESTIC_TRANSFER_FORM_DK	Initiation of Danish Transfer Form without reference in DKK.	Yes	Yes
SALARY_PENSION_DK	Initiation of salary or pension payments where the debtor and creditor account is in DKK and Nordea Denmark.	Yes	Yes
INSTANT_CREDIT_TRANSFER_DK	Initiation of instant credit transfers in Denmark. The debtor account is in Nordea DK and creditor account is in Nordea DK or in another Danish bank.	Yes	No
INSTANT_SALARY_PENSION_DK	Initiation of instant salary or pension payments in Denmark. The debtor account is in Nordea DK and creditor account is in Nordea DK or in another Danish bank.	Yes	No
Cross currency templates
CROSS_BORDER_DK	Initiation of a currency transfer where the debtor account in any currency is in Nordea Denmark. Creditor account can be in any currency and in any bank. Template also covers SEPA Credit Transfers from Denmark to the banks in SEPA area.	Yes	Yes
CURRENCY_TRANSFER_NORDEA_DK	Initiation of a currency transfer where both accounts are in Nordea Denmark. At least one of the accounts or payment amount is other than DKK.	Yes	Yes
FINANCIAL_PAYMENT_DK	Initiation of a currency transfer to any bank where the debtor account is in any currency, in Nordea Denmark. Creditor account is in another bank. Either the creditor or the debtor is a financial institution.	Yes	Yes
Intercompany templates
INTERCOMPANY_DOMESTIC_PAYMENT_DK	Initiation of transfer where the debit account is in Nordea DK and credit account is in Nordea DK or in another Danish bank. Transfer is allowed between DKK currency, with accounts in Nordea DK. For creditor account in other Danish bank, transfer is accepted only for DKK currency.	Yes	Yes
INTERCOMPANY_CROSS_BORDER_DK	Initiation of a currency transfer to any bank outside Denmark. The debtor account belongs to Nordea Denmark and can be in any currency.	Yes	Yes
INTERCOMPANY_CURRENCY_TRANSFER_DK	Initiation of a currency transfer where the debit and credit accounts are in Nordea DK. At least one of the accounts or payment amount is other than DKK.	Yes	Yes
INTERCOMPANY_INSTANT_CREDIT_TRANSFER_DK	Initiation of intercompany instant credit transfers in Denmark. The debtor account is in Nordea DK and creditor account is in Denmark and registered in the same agreement as debtor account.	Yes	No
Global Cash Pool transfer template
GLOBAL_CASH_POOL_TRANSFER_DK	Initiation of a global cash pool transfer in Nordea between transaction accounts in the same cash pool structure. The accounts need to be in the same currency. This template covers both domestic and cross-border.	Yes	Yes
FINLAND
Domestic templates
SEPA_CREDIT_TRANSFER_FI	Initiation of Finnish SEPA Credit Transfer in EUR. The creditor account can be in any bank in SEPA area.	Yes	Yes
SEPA_INSTANT_CREDIT_TRANSFER_FI	Initiation of SEPA Credit Transfer Instant in Euro in the SEPA area from Finland. Creditor bank must be part of the SEPA Instant scheme.	Yes	Yes
Cross currency templates
CROSS_BORDER_FI	Initiation of a currency transfer where the debtor account in any currency is in Nordea Finland. Creditor account can be in any currency and in any bank.	Yes	Yes
FINANCIAL_PAYMENT_FI	Initiation of a currency transfer to any bank where the debtor account is in any currency, in Nordea Finland. Creditor account is in another bank. Either the creditor or the debtor is a financial institution.	Yes	Yes
CURRENCY_TRANSFER_NORDEA_FI	Initiation of a currency transfer where both accounts are in Nordea Finland. At least one of the accounts or payment amount is other than EUR.	Yes	Yes
Intercompany templates
INTERCOMPANY_DOMESTIC_PAYMENT_FI	Initiation of transfer where the debit account is in Nordea FI and credit account is in Nordea FI or in another Finnish bank. Transfer is accepted for EUR currency only.	Yes	Yes
INTERCOMPANY_CROSS_BORDER_FI	Initiation of a currency transfer to any bank outside Finland. The debtor account belongs to Nordea Finland and can be in any currency.	Yes	Yes
INTERCOMPANY_CURRENCY_TRANSFER_FI	Initiation of a currency transfer where the debit and credit accounts are in Nordea FI. At least one of the accounts or payment amount is other than EUR.	Yes	Yes
Global Cash Pool transfer template
GLOBAL_CASH_POOL_TRANSFER_FI	Initiation of a global cash pool transfer in Nordea between transaction accounts in the same cash pool structure. The accounts need to be in the same currency. This template covers both domestic and cross-border.	Yes	Yes
NORWAY
Domestic templates
DOMESTIC_CREDIT_TRANSFER_NO	Initiation of Norwegian Domestic Payment in NOK.	Yes	Yes
DOMESTIC_KID_TRANSFER_NO	Initiation of Norwegian KID Payment in NOK.	Yes	Yes
SALARY_PAYMENT_NO	Initiation of salary payments where the debtor and creditor accounts are in NOK. Debtor account is in Nordea Norway. Creditor account is in any bank in Norway (also in Nordea).	Yes	Yes
Cross currency templates
CROSS_BORDER_NO	Initiation of a currency transfer where debtor account is in Nordea NO and the creditor account is in Nordea NO, in another Norwegian bank or any bank outside Norway. At least one of the accounts or payment amount is other than NOK. This template should also be used for SEPA Credit Transfers in Euro to the banks in SEPA area and express-payment.	Yes	Yes
FINANCIAL_PAYMENT_NO	Initiation of a currency transfer to any bank where the debtor account in any currency is in Nordea Norway. Creditor account can be in any currency and in any bank. Either the creditor or the debtor is a financial institution.	Yes	Yes
Intercompany templates
INTERCOMPANY_DOMESTIC_PAYMENT_NO	Initiation of transfer where the debit account is in Nordea NO and credit account is in Nordea NO or in another Norwegian bank. Both account and payment currency must be NOK.	Yes	Yes
INTERCOMPANY_CROSS_BORDER_NO	Initiation of a currency transfer where debtor account is in Nordea NO and the creditor account is in Nordea NO, in another Norwegian bank or any bank outside Norway. At least one of the accounts or payment amount is other than NOK.	Yes	Yes
Global Cash Pool transfer template
GLOBAL_CASH_POOL_TRANSFER_NO	Initiation of a global cash pool transfer in Nordea between transaction accounts in the same cash pool structure. The accounts need to be in the same currency. This template covers both domestic and cross-border.	Yes	Yes
SWEDEN
Domestic templates
DOMESTIC_CREDIT_TRANSFER_SE	Initiation of Swedish Domestic Bank Transfer in SEK.	Yes	Yes
SDV_DOMESTIC_PAYMENT_SE	Initiation of transfer where the debtor account is in Nordea Sweden. Creditor account is in any other bank in Sweden, other than Nordea. Both account and payment currency must be SEK. Payment urgency is always same-day-value (SDV).	Yes	Yes
Cross currency templates
CROSS_BORDER_SE	Initiation of a currency transfer to any bank outside Sweden. The debtor account in any currency is in Nordea Sweden. Template also covers SEPA Credit Transfers from Sweden to the banks in SEPA area. Please note that for payments above 150,000 SEK, field regulatory_reporting.purpose_code is required in Sweden.	Yes	Yes
CURRENCY_TRANSFER_SE	Initiation of a transfer where debtor account is in Nordea SE and creditor account is in Nordea SE or in another Swedish bank. At least one of the accounts or payment amount is other than SEK.	Yes	Yes
FINANCIAL_PAYMENT_SE	Initiation of a currency transfer to any bank where the debtor account is in any currency, in Nordea Sweden. Creditor account is in another bank. Either the creditor or the debtor is a financial institution.	Yes	Yes
Intercompany templates
INTERCOMPANY_DOMESTIC_PAYMENT_SE	Initiation of transfer where the debit account is in Nordea SE and credit account is in Nordea SE or in another Swedish bank. Transfer is allowed between EUR and/or SEK currency, with accounts in Nordea SE. For creditor account in other Swedish bank, transfer is accepted only for SEK currency.	Yes	Yes
INTERCOMPANY_CROSS_BORDER_SE	Initiation of a currency transfer to any bank outside Sweden. The debtor account belongs to Nordea Sweden and can be in any currency.	Yes	Yes
INTERCOMPANY_CURRENCY_TRANSFER_SE	Initiation of a currency transfer where the debit and credit accounts are in Nordea SE. At least one of the accounts or payment amount is other than SEK or EUR.	Yes	Yes
Global Cash Pool transfer template
GLOBAL_CASH_POOL_TRANSFER_SE	Initiation of a global cash pool transfer in Nordea between transaction accounts in the same cash pool structure. The accounts need to be in the same currency. This template covers both domestic and cross-border.	Yes	Yes

Intercompany templates - Used for payments between companies belonging to the same group, to move funds between companies’ own accounts within the Nordea Group (domestic and cross-border) or outside the Nordea Group if the accounts are included in the Corporate Netbank agreement. The funds will be available on the same day, if payments are within Nordea. For payments outside the Nordea Group, Nordea can never guarantee that the funds will be available on the same day in the beneficiary account.

Future dated payments - The user should use the field “requested_execution_date” with future-date in the Payment Initiation request.

Recurring payments - This feature is currently available only in Finland. Customers will be able to set a recurrence for the payment. The frequency options are weekly or monthly, and the payment can be repeated continuously or until a certain date. This feature is currently available for all the payments types available in Finland, except for Financial payment template (FINANCIAL_PAYMENT_FI).

NemKonto payments - This feature is currently available only in Denmark for DOMESTIC_CREDIT_TRANSFER_DK and SALARY_PENSION_DK. The product can be compared to a regular account-to-account payment, where the credit account number is replaced by a CPR/CVR/SE number. The customer can make these payments with URGENCY_NORMAL or URGENCY_SAMEDAY. The customer should have a NemKonto payment agreement.

Payment status

The reported state of a client’s payment instruction can be any of the following…

Payment Status	Explanation
AUTHORIZATION_PENDING	The payment instruction has been successfully received and authentication of a nominated user is currently in progress as part of the payment authorization process.
AUTHORIZATION_PARTIAL	Payment instruction is only partially authorized and one or more further users are required to authorize the payment in order to complete the payment authorization process. Client must nominate a further user.
AUTHORIZATION_FAILED	The last nominated user failed to authorize the payment. Either they failed to authenticate or do not have authorization rights on the specified debtor account. Client must nominate a further user. There can also be system failure and then customer could retry with same user.
PAYMENT_ACCEPTED	The payment instruction has been fully authorized and passed to Nordea’s payments engine for processing as per the payment scheme rules.
PAYMENT_EXECUTED	Payment has been executed and booked on the remitter’s account. The timing of clearing on the creditor’s account will be dependent on payment scheme and processing by the creditor’s bank.
PAYMENT_REJECTED	Payment instruction has been rejected. Reason is provided within the payment_status_reason code in response.
PAYMENT_CANCELLED	Payment instruction has been cancelled.
NOT_FOUND	Payment id was not found. Only applicable for confirmation and cancellation of multiple payments.

Real-world cases where a payment might be rejected because for example the creditor account is unreachable or the debtor account has insufficient funds are not modeled in the sandbox environment.

Cut-off times

The cut-off time is the latest time when Nordea accepts and effects payment orders to and from customers. The cut-off time varies depending on country, payment type and currency involved.

If you want the payment to be executed within the same day, please remember to finally confirm it before its cut-off time. To check the cut-off times for specific payment types and countries, please visit https://www.nordea.com/en/our-services/cash-management/cut-off-times

Authentication Flow

Authentication Types

Authentication Type	Description	Available in Sandbox	Available in production
REDIRECT	Initiation of redirect OAuth flow where Corporate Netbank user requesting the authorization will be able to confirm the instruction using one of supported authentication methods via Nordea page.	Yes	Yes
Authentication Methods:
- BANKID_SE	Authentication using BankID. Only available for Swedish users.	Yes	Yes
- MTA	Authentication using Nordea ID mobile application. Available for all Corporate Netbank users.	Yes	Yes
- QRT	Authentication using Nordea ID device. Available for all Corporate Netbank users.	Yes	No
DECOUPLED	Immediate initiation of authentication session on Corporate Netbank user device. User will be able to confirm the instruction by selected authentication method.	Yes	Yes
Authentication Methods:
- MTA	Authentication using Nordea ID mobile application. Available for all Corporate Netbank users.	Yes	Yes
- BANKID_SE	Authentication using BankID. Only available for Swedish users.	Yes	Yes

Whilst operating the Payments API in our sandbox environment authentication types behavior is adjusted.

When using REDIRECT authentication type, execution of redirect link will automatically progress to the next stage in the authorization process. Ordinarily in real-world use, at this point the user would be redirected to Nordea page where they would be invited to securely authenticate themselves.

Get BankId Se authentication details (Decoupled Flow)

GET /corporate/premium/v1/authentications/bankid_se/{authentication_id}

When “authentication_type” = “DECOUPLED” and “authentication_method” = “BANKID_SE” values are selected, in the response “authentication_id” field is provided. Authentication ID is to be used in the below endpoint.

In the response, when applicable, qr_data and auto_start_token values are returned. Qr_data is converted to QR code and scanned by end user BankId SE mobile application.

If, BankId application on customer mobile application needs to be used directly, “auto_start_token” has to be used.

As long as the status is WAITING_FOR_USER, new qr_data is generated in small intervals, so it’s advised to poll for the endpoint approximately every second until SUCCESS or FAILED status appears. Access token is not required to use authentications endpoints. Please see the examples section for better understanding.

The status will give the state of signing as below.

Status	Description
WAITING_FOR_USER	Awaiting end user signing assignment.
IN_PROGRESS	End user signing process is in progress.
SUCCESS	Signing process has completed successfully.
FAILED	Signing was not completed by end user and needs to be started again.

Corporate payments API examples

Here you can find examples how to use the Corporate Payments API endpoints.

Create a payment Instruction

This endpoint URL has the following form:

POST /corporate/v2/payments

This endpoint supports POST HTTP method.
The following headers must be used:

Content-Type: application/json 
Authorization: Bearer {access_token}   
X-IBM-Client: {client_id}   
X-IBM-Client-Secret: {client_secret}   
Digest: {digest}   
Signature: {signature}   
X-Nordea-Originating-Date: {date}   
X-Nordea-Originating-Host: {host}

SANDBOX ONLY

When using REDIRECT authentication_type please add:X-Nordea-Mock-Authorizer-Id:{authorizer_id}

To make a payment in need of additional verification, please add:X-Response-Scenarios:paymentVerificationRequired

The body of the request will vary, determined by the type of payment requested and the payment template that is applied as well as authentication type chosen. The following example is provided for a Finnish SEPA Credit Transfer instruction with redirect way of authentication selected:

Example of DECOUPLED authentication type with MTA authentication method

{
  "payment_instruction": {
    "template_id": "SEPA_CREDIT_TRANSFER_FI",
    "authorizer_id": "70311198",
    "amount": 123.45,
    "currency": "EUR",
    "debtor": {
      "account": {
        "value": "FI4116603500005114",
        "type": "IBAN",
        "currency": "EUR"
      },
      "own_reference": "Own notes"
    },
    "creditor": {
      "account": {
        "value": "FI1350001520000081",
        "type": "IBAN"
      },
      "name": "Finnish Supplier Inc",
      "reference": {
        "value": "RF18539007547034",
        "type": "RF"
      }
    },
    "external_id": "32rr98-fhff289-328f92-dd29",
    "end_to_end_id": "2019-07-31 0001"
  },
  "authorization_details": {
    "authentication_type": "DECOUPLED",
    "authentication_method": "MTA",
    "authorizer_id": "70311198"
  }
}

Example of DECOUPLED authentication type with BANKID_SE authentication method

{
  "payment_instruction": {
    "template_id": "SEPA_CREDIT_TRANSFER_FI",
    "authorizer_id": "70311198",
    "amount": 123.45,
    "currency": "EUR",
    "debtor": {
      "account": {
        "value": "FI4116603500005114",
        "type": "IBAN",
        "currency": "EUR"
      },
      "own_reference": "Own notes"
    },
    "creditor": {
      "account": {
        "value": "FI1350001520000081",
        "type": "IBAN"
      },
      "name": "Finnish Supplier Inc",
      "reference": {
        "value": "RF18539007547034",
        "type": "RF"
      }
    },
    "external_id": "32rr98-fhff289-328f92-dd29",
    "end_to_end_id": "2019-07-31 0001"
  },
  "authorization_details": {
    "authentication_type": "DECOUPLED",
    "authentication_method": "BANKID_SE"
  }
}

Example of REDIRECT authentication type

{
  "payment_instruction": {
    "template_id": "SEPA_CREDIT_TRANSFER_FI",
    "authorizer_id": "70311198",
    "amount": 123.45,
    "currency": "EUR",
    "debtor": {
      "account": {
        "value": "FI4116603500005114",
        "type": "IBAN",
        "currency": "EUR"
      },
      "own_reference": "Own notes"
    },
    "creditor": {
      "account": {
        "value": "FI1350001520000081",
        "type": "IBAN"
      },
      "name": "Finnish Supplier Inc",
      "reference": {
        "value": "RF18539007547034",
        "type": "RF"
      }
    },
    "external_id": "32rr98-fhff289-328f92-dd29",
    "end_to_end_id": "2019-07-31 0001"
  },
  "authorization_details": {
    "authentication_type": "REDIRECT",
    "redirect_uri": "https://example.com",
    "state": "<state>",
    "authentication_method": "BANKID_SE",
    "language": "en"
  }
}

Where the payment request is valid the response will be 201 SUCCESS and formatted like the example below

{
  "group_header": {
    "creation_date_time": "2019-07-31T06:16:25.483Z",
    "http_code": 201,
    "message_identification": "9779hRD-2NKL789v-678gfUI"
  },
  "response": {
    "_id": "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
    "amount": "123.45",
    "currency": "EUR",
    "requested_execution_date": "2019-07-31",
    "debtor": {
      "account": {
        "value": "FI4116603500005114",
        "type": "IBAN",
        "currency": "EUR"
      },
      "own_reference": "Own notes"
    },
    "creditor": {
      "account": {
        "value": "FI1350001520000081",
        "type": "IBAN"
      },
      "name": "Finnish Supplier Inc",
      "reference": {
        "value": "RF18539007547034",
        "type": "RF"
      }
    },
    "external_id": "32rr98-fhff289-328f92-dd29",
    "end_to_end_id": "2019-07-31 0001",
    "create_timestamp": "2019-07-31T06:13:09.784",
    "status_timestamp": "2019-07-31T06:16:25.483",
    "payment_status": "AUTHORIZATION_PENDING",
    "auto_start_token": "8441d326-2d6e-4e4f-9412-303ec3d0931c",
    "authentication_id": "4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8",
    "_links": [
      {
        "rel": "self",
        "href": "/v2/payments"
      },
      {
        "rel": "confirm",
        "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024/confirm"
      },
      {
        "rel": "details",
        "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024"
      },
      {
        "rel": "redirect",
        "href": "https://api.nordeaopenbanking.com/corporate/payments/identify?client_id=Psf34PDHxdLy2Sfyr4UF&code_challenge_method=S256&redirect_uri=https%3A%2F%2Fapi.nordeaopenbanking.com%2Fcorporate%2Fpayments%2Foauth&response_type=code&code_challenge=w-LCXdhAlI8FGIXPMy833vWPaPE3XLEN7WWgve7NrSY&scope=openid+agreement&state=57a77285-1965-4329-a895-8fa1cee59bcc&nonce=gZvLWDrACbzLZBgQPr7DkV6g2YuLtdeuPbDi0uiR&login_hint=bankid_se&signing_token=eyJjdHkiOiJKV1QiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.hMT3ZHEcf3TNpnCrYfiisvB08y9C0AtezO9QuGqtR0L0OeLt8HWYN0v3PU8ZF1iu_v_Rh5LA4CjoIOU8lCGLSFmddUEfhl9iqMUeSh5wLizZv4pF6bo_YRnmR9WqLMzZpq_-dB9MB7mMA2KVHX6Jmy3ZWrleFuUabGdgypdyKy1Bi9tFAYFE0tHEAwm_8vPVyppypT6VFaldvRO8kTJrqZVuTFIYLXDKV69D8b40mEkcTRC5CO029UgCyyV8-Ia3vdhjk_0QklszkrAU0KlvIzVYat4GbXzbTC-snHJ_qgutFygtNH2vM1a84rLaYszbRa6dT285WsyCuNjMIHwSnQ.Dn2xpMne03d9EKzd.Sy83KdbkCzsXaSrUASZdWyRGKZ61jErjQLhN31j6ty7R7z81DGcdWUrB9X4DnHmWq2ZbzE2QI7xc3lAAllClrDyB90ZRPK62yLDprU0CHvIGIuLtC-ORqI5NhNtVS1XWkgHT_Th3AgCVZFCmujDlGNvfuoDvDgeesiC5ZQyYZ_uxHNn7IcQolU1LbBDnSry7WaglbhL-DnbnIOq_pQGRhw5zS9yYKyWWrO31XrV-2MA797-FgpCU7N-mzPUC2nUMhHrYt9C0A-h8h7ZtAF4AYl5LS3gZ-SARVp_K5-dpHhPC03Cx5gEkoL7EGsFNiEvvJkRlR_iaAgfRV-FFPbzMzqaKFi3c8GtUruarrhyMBdC-gmrKrTD_gzD_mTUJWRMYfR7W5cLl97vLC40ipUv85IkNP2KVLWi5B-2Kg_Jyhw0yz3X5wwCodG9Mn4rz0J8G-eZvahTaGCoEj0H5Zgyclq4cyESPqnzOqot-kQmG9eYEu9uQ1XSZ8gCEwes1MPTEd6l6v2Hwhw7qL1aj1B3rw-uPb_4mBhwj8BzZ5WRkbVpv0WqQr257Ysi5Hra3QCSdU8W8-58Gt4qQPuBA_khwgL4SjZnuji79NIoy4jQyA05j2WW4QQm6umkS8p4IXY6JkoOEPc1t.uM4OAVUbmD3kICouxGEL8w"
      },
      {
        "rel": "authentication_details",
        "href": "/v1/authentications/bankid_se/4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8"
      }
    ]
  }
}

Please note that “auto_start_token”, “authentication_id” as well as redirect and authentication_details links presence is determined by selected authentication_type and authentication_method

Fetching details of the Payment

This endpoint URL has the following form:

GET /corporate/v2/payments/<payment_id>

This endpoint supports GET HTTP method.
The following headers must be used:

Authorization: Bearer {access_token} 
Signature: {signature}   
X-IBM-Client-Id: {client_id} 
X-IBM-Client-Secret: {client_secret}
X-Nordea-Originating-Date: {date}
X-Nordea-Originating-Host: {host}

Where the request is valid the response will be 200 SUCCESS and formatted like the example below

{
  "group_header": {
    "message_identification": "kG44iARowVH3mS5X",
    "creation_date_time": "2021-03-26T07:07:08.0166465Z",
    "http_code": 200
  },
  "response": {
    "_id": "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
    "amount": "123.45",
    "currency": "EUR",
    "requested_execution_date": "2019-07-31",
    "execution_date": "2019-07-31",
    "debtor": {
      "account": {
        "value": "FI4116603500005114",
        "type": "IBAN",
        "currency": "EUR"
      },
      "own_reference": "Own notes"
    },
    "creditor": {
      "account": {
        "value": "FI1350001520000081",
        "type": "IBAN"
      },
      "name": "Finnish Supplier Inc",
      "reference": {
        "value": "RF18539007547034",
        "type": "RF"
      }
    },
    "external_id": "32rr98-fhff289-328f92-dd29",
    "end_to_end_id": "2019-07-31 0001",
    "create_timestamp": "2019-07-31T06:13:09.784",
    "status_timestamp": "2019-07-31T06:16:25.483",
    "payment_status": "PAYMENT_EXECUTED",
    "_links": [
      {
        "rel": "self",
        "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024"
      }
    ]
  }
}

Fetching list of payments

This endpoint URL has the following form:

GET /corporate/v2/payments

This endpoint supports GET HTTP method.
The following headers must be used:

Authorization: Bearer {access_token} 
Signature: {signature}   
X-IBM-Client-Id: {client_id} 
X-IBM-Client-Secret: {client_secret}
X-Nordea-Originating-Date: {date}
X-Nordea-Originating-Host: {host}

The following query parameters are supported:

creation_from_timestamp: {creation_from_timestamp}
creation_to_timestamp: {creation_to_timestamp}
execution_from_date: {execution_from_date}
execution_to_date: {execution_to_date}
debtor_account: {debtor_account}
min_amount: {min_amount}
max_amount: {max_amount}
payment_status: {payment_status}
created_by: {created_by}
page: {page}
size: {size}

Where the request is valid the response will be 200 SUCCESS and formatted like the example below

{
  "group_header": {
    "message_identification": "kG44iARowVH3mS5X",
    "creation_date_time": "2021-03-26T07:07:08.0166465Z",
    "http_code": 200
  },
  "response": {
    "payments": [
      {
        "_id": "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
        "amount": "123.45",
        "currency": "EUR",
        "requested_execution_date": "2019-07-31",
        "execution_date": "2019-07-31",
        "debtor": {
          "account": {
            "value": "FI4116603500005114",
            "type": "IBAN",
            "currency": "EUR"
          },
          "own_reference": "Own notes"
        },
        "creditor": {
          "account": {
            "value": "FI1350001520000081",
            "type": "IBAN"
          },
          "name": "Finnish Supplier Inc",
          "reference": {
            "value": "RF18539007547034",
            "type": "RF"
          }
        },
        "external_id": "32rr98-fhff289-328f92-dd29",
        "end_to_end_id": "2019-07-31 0001",
        "create_timestamp": "2019-07-31T06:13:09.784",
        "status_timestamp": "2019-07-31T06:16:25.483",
        "payment_status": "PAYMENT_EXECUTED",
        "_links": [
          {
            "rel": "self",
            "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024"
          }
        ]
      },
      {
        "_id": "f59abbab-8df4-49be-b7fe-247f279b5aab",
        "amount": "123.45",
        "currency": "EUR",
        "requested_execution_date": "2019-08-02",
        "execution_date": "2019-08-03",
        "debtor": {
          "account": {
            "value": "FI4116603500005114",
            "type": "IBAN",
            "currency": "EUR"
          },
          "own_reference": "Own notes"
        },
        "creditor": {
          "account": {
            "value": "FI1350001520000081",
            "type": "IBAN"
          },
          "name": "Finnish Supplier Inc",
          "reference": {
            "value": "RF18539007547034",
            "type": "RF"
          }
        },
        "external_id": "0093c3d3-ea30-4288-a7be-6c43c5533241",
        "end_to_end_id": "2019-07-31 0002",
        "create_timestamp": "2019-07-31T08:17:34.213",
        "status_timestamp": "2019-07-31T08:20:02.343",
        "payment_status": "PAYMENT_ACCEPTED",
        "_links": [
          {
            "rel": "details",
            "href": "/v2/payments/f59abbab-8df4-49be-b7fe-247f279b5aab"
          },
          {
            "rel": "cancel",
            "href": "/v2/payments/f59abbab-8df4-49be-b7fe-247f279b5aab/cancel"
          }
        ]
      }
    ],
    "_links": [
      {
        "rel": "first",
        "href": "/v2/payments?page=1&size=20"
      },
      {
        "rel": "self",
        "href": "/v2/payments?page=1&size=20"
      },
      {
        "rel": "last",
        "href": "/v2/payments?page=1&size=20"
      }
    ]
  }
}

Confirming a Payment

This endpoint URL has the following form:

PUT /corporate/v2/payments/<payment_id>/confirm

This endpoint supports PUT HTTP method.
The following headers must be used:

Content-Type: application/json 
Authorization: Bearer {access_token} 
X-IBM-Client: {client_id} 
X-IBM-Client-Secret: {client_secret}
Digest: {digest} 
Signature: {signature}
X-Nordea-Originating-Date: {date}
X-Nordea-Originating-Host: {host}

SANDBOX ONLY

When using REDIRECT authentication_type please add:X-Nordea-Mock-Authorizer-Id:{authorizer_id}

The body of the request will vary, determined by the authentication type chosen.

Example of DECOUPLED authentication type with MTA authentication method

{
  "authentication_type": "DECOUPLED",
  "authentication_method": "MTA",
  "authorizer_id": "70311198"
}

Example of DECOUPLED authentication type with BANKID_SE authentication method

{
  "authentication_type": "DECOUPLED",
  "authentication_method": "BANKID_SE"
}

Example of REDIRECT authentication type

{
  "authentication_type": "REDIRECT",
  "redirect_uri": "http://test.com",
  "state": "state",
  "authentication_method": "BANKID_SE",
  "language": "en"
}

Where the payment request is valid the response will be 200 SUCCESS and formatted like the example below

{
  "group_header": {
    "message_identification": "k3VAX2Q96tuHZcyG",
    "creation_date_time": "2021-03-26T07:07:09.0186462Z",
    "http_code": 200
  },
  "response": {
    "_id": "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
    "amount": "123.45",
    "currency": "EUR",
    "requested_execution_date": "2019-07-31",
    "execution_date": "2019-07-31", "debtor": {
      "account": {
        "value": "FI4116603500005114",
        "type": "IBAN",
        "currency": "EUR"
      },
      "own_reference": "Own notes"
    },
    "creditor": {
      "account": {
        "value": "FI1350001520000081",
        "type": "IBAN"
      },
      "name": "Finnish Supplier Inc",
      "reference": {
        "value": "RF18539007547034",
        "type": "RF"
      }
    },
    "external_id": "32rr98-fhff289-328f92-dd29",
    "end_to_end_id": "2019-07-31 0001",
    "status_timestamp": "2019-07-31T06:16:25.483",
    "payment_status": "AUTHORIZATION_PENDING",
    "auto_start_token": "8441d326-2d6e-4e4f-9412-303ec3d0931c",
    "authentication_id": "4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8",
    "_links": [
      {
        "rel": "self",
        "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024/confirm"
      },
      {
        "rel": "redirect",
        "href": "https://api.nordeaopenbanking.com/corporate/payments/identify?client_id=Psf34PDHxdLy2Sfyr4UF&code_challenge_method=S256&redirect_uri=https%3A%2F%2Fapi.nordeaopenbanking.com%2Fcorporate%2Fpayments%2Foauth&response_type=code&code_challenge=HAULnO8Z7njZCem7zHPq0FzSQxW5Sc2Im2WWEsVwlEU&scope=openid+agreement&state=80dff5c3-a1f9-499a-8bad-bf886801e0b9&nonce=PhSHQiuWOwCbRTGS9N5SrlRA2kSDyjK3DUGw71ly&login_hint=bankid_se&signing_token=eyJjdHkiOiJKV1QiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.hMT3ZHEcf3TNpnCrYfiisvB08y9C0AtezO9QuGqtR0L0OeLt8HWYN0v3PU8ZF1iu_v_Rh5LA4CjoIOU8lCGLSFmddUEfhl9iqMUeSh5wLizZv4pF6bo_YRnmR9WqLMzZpq_-dB9MB7mMA2KVHX6Jmy3ZWrleFuUabGdgypdyKy1Bi9tFAYFE0tHEAwm_8vPVyppypT6VFaldvRO8kTJrqZVuTFIYLXDKV69D8b40mEkcTRC5CO029UgCyyV8-Ia3vdhjk_0QklszkrAU0KlvIzVYat4GbXzbTC-snHJ_qgutFygtNH2vM1a84rLaYszbRa6dT285WsyCuNjMIHwSnQ.Dn2xpMne03d9EKzd.Sy83KdbkCzsXaSrUASZdWyRGKZ61jErjQLhN31j6ty7R7z81DGcdWUrB9X4DnHmWq2ZbzE2QI7xc3lAAllClrDyB90ZRPK62yLDprU0CHvIGIuLtC-ORqI5NhNtVS1XWkgHT_Th3AgCVZFCmujDlGNvfuoDvDgeesiC5ZQyYZ_uxHNn7IcQolU1LbBDnSry7WaglbhL-DnbnIOq_pQGRhw5zS9yYKyWWrO31XrV-2MA797-FgpCU7N-mzPUC2nUMhHrYt9C0A-h8h7ZtAF4AYl5LS3gZ-SARVp_K5-dpHhPC03Cx5gEkoL7EGsFNiEvvJkRlR_iaAgfRV-FFPbzMzqaKFi3c8GtUruarrhyMBdC-gmrKrTD_gzD_mTUJWRMYfR7W5cLl97vLC40ipUv85IkNP2KVLWi5B-2Kg_Jyhw0yz3X5wwCodG9Mn4rz0J8G-eZvahTaGCoEj0H5Zgyclq4cyESPqnzOqot-kQmG9eYEu9uQ1XSZ8gCEwes1MPTEd6l6v2Hwhw7qL1aj1B3rw-uPb_4mBhwj8BzZ5WRkbVpv0WqQr257Ysi5Hra3QCSdU8W8-58Gt4qQPuBA_khwgL4SjZnuji79NIoy4jQyA05j2WW4QQm6umkS8p4IXY6JkoOEPc1t.uM4OAVUbmD3kICouxGEL8w"
      },
      {
        "rel": "authentication_details",
        "href": "/v1/authentications/bankid_se/4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8"
      }
    ]
  }
}

Please note that “auto_start_token”, “authentication_id” as well as redirect and authentication_details links presence is determined by selected authentication_type and authentication_method

Confirming multiple payments

This endpoint URL has the following form:

POST/corporate/v2/payments/confirm

This endpoint supports PUT HTTP method.
The following headers must be used:

Content-Type: application/json 
Authorization: Bearer {access_token} 
X-IBM-Client: {client_id} 
X-IBM-Client-Secret: {client_secret}
Digest: {digest} 
Signature: {signature}
X-Nordea-Originating-Date: {date}
X-Nordea-Originating-Host: {host}

SANDBOX ONLY

When using REDIRECT authentication_type please add:X-Nordea-Mock-Authorizer-Id:{authorizer_id}

The body of the request will vary, determined by the authentication type chosen.

Example of DECOUPLED authentication type with MTA authentication method

{
  "authorization_details": {
    "authentication_type": "DECOUPLED",
    "authentication_method": "MTA",
    "authorizer_id": "70311591"
  },
  "payment_details": {
    "payment_id_list": [
      "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
      "f59abbab-8df4-49be-b7fe-247f279b5aab"
    ]
  }
}

Example of DECOUPLED authentication type with BANKID_SE authentication method

{
  "authorization_details": {
    "authentication_type": "DECOUPLED",
    "authentication_method": "BANKID_SE"
  },
  "payment_details": {
    "payment_id_list": [
      "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
      "f59abbab-8df4-49be-b7fe-247f279b5aab"
    ]
  }
}

Example of REDIRECT authentication type

{
  "authorization_details": {
    "authentication_type": "REDIRECT",
    "redirect_uri": "https://www.nordea.com",
    "state": "state",
    "authentication_method": "BANKID_SE",
    "language": "en"
  },
  "payment_details": {
    "payment_id_list": [
      "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
      "f59abbab-8df4-49be-b7fe-247f279b5aab"
    ]
  }
}

Where the payment request is valid the response will be 200 SUCCESS and formatted like the example below

{
  "group_header": {
    "message_identification": "F64MEP2Jl1LsTukB",
    "creation_date_time": "2021-09-13T08:58:23.0951993Z",
    "http_code": 200
  },
  "response": {
    "payments": [
      {
        "_id": "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
        "amount": "123.45",
        "currency": "EUR",
        "requested_execution_date": "2019-07-31",
        "execution_date": "2019-07-31",
        "debtor": {
          "account": {
            "value": "FI4116603500005114",
            "type": "IBAN",
            "currency": "EUR"
          },
          "own_reference": "Own notes"
        },
        "creditor": {
          "account": {
            "value": "FI1350001520000081",
            "type": "IBAN"
          },
          "name": "Finnish Supplier Inc",
          "reference": {
            "value": "RF18539007547034",
            "type": "RF"
          }
        },
        "external_id": "32rr98-fhff289-328f92-dd29",
        "end_to_end_id": "2019-07-31 0001",
        "status_timestamp": "2021-09-13T08:58:23.0951993",
        "create_timestamp": "2021-09-13T08:57:50.3416179",
        "payment_status": "AUTHORIZATION_PENDING",
        "auto_start_token": "8441d326-2d6e-4e4f-9412-303ec3d0931c",
        "authentication_id": "4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8",
        "_links": [
          {
            "rel": "details",
            "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024"
          }
        ]
      },
      {
        "_id": "f59abbab-8df4-49be-b7fe-247f279b5aab",
        "amount": "123.45",
        "currency": "EUR",
        "requested_execution_date": "2019-08-02",
        "execution_date": "2019-08-03",
        "debtor": {
          "account": {
            "value": "FI4116603500005114",
            "type": "IBAN",
            "currency": "EUR"
          },
          "own_reference": "Own notes"
        },
        "creditor": {
          "account": {
            "value": "FI1350001520000081",
            "type": "IBAN"
          },
          "name": "Finnish Supplier Inc",
          "reference": {
            "value": "RF18539007547034",
            "type": "RF"
          }
        },
        "external_id": "0093c3d3-ea30-4288-a7be-6c43c5533241",
        "end_to_end_id": "2019-07-31 0002",
        "status_timestamp": "2021-09-13T08:58:23.0951993",
        "create_timestamp": "2021-09-13T08:57:48.7453772",
        "payment_status": "AUTHORIZATION_PENDING",
        "auto_start_token": "8441d326-2d6e-4e4f-9412-303ec3d0931c",
        "authentication_id": "4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8",
        "_links": [
          {
            "rel": "details",
            "href": "/v2/payments/f59abbab-8df4-49be-b7fe-247f279b5aab"
          }
        ]
      }
    ]
  },
  "_links": [
    {
      "rel": "self",
      "href": "/v2/payments/confirm"
    },
    {
      "rel": "redirect",
      "href": "https://api.nordeaopenbanking.com/corporate/payments/identify?client_id=Psf34PDHxdLy2Sfyr4UF&code_challenge_method=S256&redirect_uri=https%3A%2F%2Fapi.nordeaopenbanking.com%2Fcorporate%2Fpayments%2Foauth&response_type=code&code_challenge=HAULnO8Z7njZCem7zHPq0FzSQxW5Sc2Im2WWEsVwlEU&scope=openid+agreement&state=80dff5c3-a1f9-499a-8bad-bf886801e0b9&nonce=PhSHQiuWOwCbRTGS9N5SrlRA2kSDyjK3DUGw71ly&login_hint=bankid_se&signing_token=eyJjdHkiOiJKV1QiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.hMT3ZHEcf3TNpnCrYfiisvB08y9C0AtezO9QuGqtR0L0OeLt8HWYN0v3PU8ZF1iu_v_Rh5LA4CjoIOU8lCGLSFmddUEfhl9iqMUeSh5wLizZv4pF6bo_YRnmR9WqLMzZpq_-dB9MB7mMA2KVHX6Jmy3ZWrleFuUabGdgypdyKy1Bi9tFAYFE0tHEAwm_8vPVyppypT6VFaldvRO8kTJrqZVuTFIYLXDKV69D8b40mEkcTRC5CO029UgCyyV8-Ia3vdhjk_0QklszkrAU0KlvIzVYat4GbXzbTC-snHJ_qgutFygtNH2vM1a84rLaYszbRa6dT285WsyCuNjMIHwSnQ.Dn2xpMne03d9EKzd.Sy83KdbkCzsXaSrUASZdWyRGKZ61jErjQLhN31j6ty7R7z81DGcdWUrB9X4DnHmWq2ZbzE2QI7xc3lAAllClrDyB90ZRPK62yLDprU0CHvIGIuLtC-ORqI5NhNtVS1XWkgHT_Th3AgCVZFCmujDlGNvfuoDvDgeesiC5ZQyYZ_uxHNn7IcQolU1LbBDnSry7WaglbhL-DnbnIOq_pQGRhw5zS9yYKyWWrO31XrV-2MA797-FgpCU7N-mzPUC2nUMhHrYt9C0A-h8h7ZtAF4AYl5LS3gZ-SARVp_K5-dpHhPC03Cx5gEkoL7EGsFNiEvvJkRlR_iaAgfRV-FFPbzMzqaKFi3c8GtUruarrhyMBdC-gmrKrTD_gzD_mTUJWRMYfR7W5cLl97vLC40ipUv85IkNP2KVLWi5B-2Kg_Jyhw0yz3X5wwCodG9Mn4rz0J8G-eZvahTaGCoEj0H5Zgyclq4cyESPqnzOqot-kQmG9eYEu9uQ1XSZ8gCEwes1MPTEd6l6v2Hwhw7qL1aj1B3rw-uPb_4mBhwj8BzZ5WRkbVpv0WqQr257Ysi5Hra3QCSdU8W8-58Gt4qQPuBA_khwgL4SjZnuji79NIoy4jQyA05j2WW4QQm6umkS8p4IXY6JkoOEPc1t.uM4OAVUbmD3kICouxGEL8w"
    },
    {
      "rel": "authentication_details",
      "href": "/v1/authentications/bankid_se/4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8"
    }
  ]
}

Please note that “auto_start_token”, “authentication_id” as well as redirect and authentication_details links presence is determined by selected authentication_type and authentication_method

Cancel a Payment

This endpoint URL has the following form:

PUT /corporate/v2/payments/<payment_id>/cancel

This endpoint supports PUT HTTP method.
The following headers must be used:

Content-Type: application/json 
Authorization: Bearer {access_token} 
X-IBM-Client: {client_id} 
X-IBM-Client-Secret: {client_secret}
Digest: {digest} 
Signature: {signature}
X-Nordea-Originating-Date: {date}
X-Nordea-Originating-Host: {host}

SANDBOX ONLY

When using REDIRECT authentication_type please add:X-Nordea-Mock-Authorizer-Id:{authorizer_id}

The body of the request will vary, determined by the authentication type chosen.

Example of DECOUPLED authentication type

{
  "authentication_type": "DECOUPLED",
  "authentication_method": "MTA",
  "authorizer_id": "70311591"
}

Example of REDIRECT authentication type

{
  "authentication_type": "REDIRECT",
  "redirect_uri": "http://test.com",
  "state": "state",
  "authentication_method": "BANKID_SE",
  "language": "en"
}

Where the payment request is valid the response will be 200 SUCCESS and formatted like the example below

{
  "group_header": {
    "message_identification": "65jIV0sRSTWeHd3C",
    "creation_date_time": "2021-05-06T12:49:40.484771Z",
    "http_code": 200
  },
  "response": {
    "_id": "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
    "amount": "123.45",
    "currency": "EUR",
    "requested_execution_date": "2019-07-31",
    "execution_date": "2019-07-31",
    "debtor": {
      "account": {
        "value": "FI4116603500005114",
        "type": "IBAN",
        "currency": "EUR"
      },
      "own_reference": "Own notes"
    },
    "creditor": {
      "account": {
        "value": "FI1350001520000081",
        "type": "IBAN"
      },
      "name": "Finnish Supplier Inc",
      "reference": {
        "value": "RF18539007547034",
        "type": "RF"
      }
    },
    "external_id": "32rr98-fhff289-328f92-dd29",
    "end_to_end_id": "2019-07-31 0001",
    "status_timestamp": "2019-07-31T06:16:25.483",
    "payment_status": "AUTHORIZATION_PENDING",
    "payment_status_reason": "info.payment.cancellation_in_progress",
    "auto_start_token": "8441d326-2d6e-4e4f-9412-303ec3d0931c",
    "authentication_id": "4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8",
    "_links": [
      {
        "rel": "self",
        "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024/cancel"
      },
      {
        "rel": "details",
        "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024"
      },
      {
        "rel": "redirect",
        "href": "https://api.nordeaopenbanking.com/corporate/payments/identify?client_id=Psf34PDHxdLy2Sfyr4UF&code_challenge_method=S256&redirect_uri=https%3A%2F%2Fapi.nordeaopenbanking.com%2Fcorporate%2Fpayments%2Foauth&response_type=code&code_challenge=Z-iJoADAzUOuP8DISxbPY6T-IgCAfY0wx9oPbKIXqtM&scope=openid+agreement&state=27f9a022-b16a-4e57-953c-2d18dc922386&nonce=l5AjePogRPjWtw09864NOqqb47aZH14GD0sivuTv&login_hint=bankid_se&signing_token=eyJjdHkiOiJKV1QiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.hMT3ZHEcf3TNpnCrYfiisvB08y9C0AtezO9QuGqtR0L0OeLt8HWYN0v3PU8ZF1iu_v_Rh5LA4CjoIOU8lCGLSFmddUEfhl9iqMUeSh5wLizZv4pF6bo_YRnmR9WqLMzZpq_-dB9MB7mMA2KVHX6Jmy3ZWrleFuUabGdgypdyKy1Bi9tFAYFE0tHEAwm_8vPVyppypT6VFaldvRO8kTJrqZVuTFIYLXDKV69D8b40mEkcTRC5CO029UgCyyV8-Ia3vdhjk_0QklszkrAU0KlvIzVYat4GbXzbTC-snHJ_qgutFygtNH2vM1a84rLaYszbRa6dT285WsyCuNjMIHwSnQ.Dn2xpMne03d9EKzd.Sy83KdbkCzsXaSrUASZdWyRGKZ61jErjQLhN31j6ty7R7z81DGcdWUrB9X4DnHmWq2ZbzE2QI7xc3lAAllClrDyB90ZRPK62yLDprU0CHvIGIuLtC-ORqI5NhNtVS1XWkgHT_Th3AgCVZFCmujDlGNvfuoDvDgeesiC5ZQyYZ_uxHNn7IcQolU1LbBDnSry7WaglbhL-DnbnIOq_pQGRhw5zS9yYKyWWrO31XrV-2MA797-FgpCU7N-mzPUC2nUMhHrYt9C0A-h8h7ZtAF4AYl5LS3gZ-SARVp_K5-dpHhPC03Cx5gEkoL7EGsFNiEvvJkRlR_iaAgfRV-FFPbzMzqaKFi3c8GtUruarrhyMBdC-gmrKrTD_gzD_mTUJWRMYfR7W5cLl97vLC40ipUv85IkNP2KVLWi5B-2Kg_Jyhw0yz3X5wwCodG9Mn4rz0J8G-eZvahTaGCoEj0H5Zgyclq4cyESPqnzOqot-kQmG9eYEu9uQ1XSZ8gCEwes1MPTEd6l6v2Hwhw7qL1aj1B3rw-uPb_4mBhwj8BzZ5WRkbVpv0WqQr257Ysi5Hra3QCSdU8W8-58Gt4qQPuBA_khwgL4SjZnuji79NIoy4jQyA05j2WW4QQm6umkS8p4IXY6JkoOEPc1t.uM4OAVUbmD3kICouxGEL8w"
      },
      {
        "rel": "authentication_details",
        "href": "/v1/authentications/bankid_se/4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8"
      }
    ]
  }
}

Please note that “auto_start_token”, “authentication_id” as well as redirect and authentication_details links presence is determined by selected authentication_type and authentication_method

Cancel multiple payments

This endpoint URL has the following form:

POST/corporate/v2/payments/cancel

This endpoint supports PUT HTTP method.
The following headers must be used:

Content-Type: application/json 
Authorization: Bearer {access_token} 
X-IBM-Client: {client_id} 
X-IBM-Client-Secret: {client_secret}
Digest: {digest} 
Signature: {signature}
X-Nordea-Originating-Date: {date}
X-Nordea-Originating-Host: {host}

SANDBOX ONLY

When using REDIRECT authentication_type please add:X-Nordea-Mock-Authorizer-Id:{authorizer_id}

The body of the request will vary, determined by the authentication type chosen.

Example of DECOUPLED authentication type

{
  "authorization_details": {
    "authentication_type": "DECOUPLED",
    "authentication_method": "MTA",
    "authorizer_id": "70311591"
  },
  "payment_details": {
    "payment_id_list": [
      "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
      "f59abbab-8df4-49be-b7fe-247f279b5aab"
    ]
  }
}

Example of REDIRECT authentication type

{
  "authorization_details": {
    "authentication_type": "REDIRECT",
    "redirect_uri": "https://www.nordea.com",
    "state": "state",
    "authentication_method": "BANKID_SE",
    "language": "en"
  },
  "payment_details": {
    "payment_id_list": [
      "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
      "f59abbab-8df4-49be-b7fe-247f279b5aab"
    ]
  }
}

Where the payment request is valid the response will be 200 SUCCESS and formatted like the example below

{
  "group_header": {
    "message_identification": "F64MEP2Jl1LsTukB",
    "creation_date_time": "2021-09-13T08:58:23.0951993Z",
    "http_code": 200
  },
  "response": {
    "payments": [
      {
        "_id": "7f156cea-0ebb-4c7e-ab55-96ea9fc3b024",
        "amount": "123.45",
        "currency": "EUR",
        "requested_execution_date": "2019-07-31",
        "execution_date": "2019-07-31",
        "debtor": {
          "account": {
            "value": "FI4116603500005114",
            "type": "IBAN",
            "currency": "EUR"
          },
          "own_reference": "Own notes"
        },
        "creditor": {
          "account": {
            "value": "FI1350001520000081",
            "type": "IBAN"
          },
          "name": "Finnish Supplier Inc",
          "reference": {
            "value": "RF18539007547034",
            "type": "RF"
          }
        },
        "external_id": "32rr98-fhff289-328f92-dd29",
        "end_to_end_id": "2019-07-31 0001",
        "status_timestamp": "2021-09-13T08:47:39.414802",
        "create_timestamp": "2021-09-13T08:47:15.3722106",
        "payment_status": "AUTHORIZATION_PENDING",
        "payment_status_reason": "info.payment.cancellation_in_progress",
        "auto_start_token": "8441d326-2d6e-4e4f-9412-303ec3d0931c",
        "authentication_id": "4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8",
        "_links": [
          {
            "rel": "details",
            "href": "/v2/payments/7f156cea-0ebb-4c7e-ab55-96ea9fc3b024"
          }
        ]
      },
      {
        "_id": "f59abbab-8df4-49be-b7fe-247f279b5aab",
        "amount": "123.45",
        "currency": "EUR",
        "requested_execution_date": "2019-08-02",
        "execution_date": "2019-08-03",
        "debtor": {
          "account": {
            "value": "FI4116603500005114",
            "type": "IBAN",
            "currency": "EUR"
          },
          "own_reference": "Own notes"
        },
        "creditor": {
          "account": {
            "value": "FI1350001520000081",
            "type": "IBAN"
          },
          "name": "Finnish Supplier Inc",
          "reference": {
            "value": "RF18539007547034",
            "type": "RF"
          }
        },
        "external_id": "0093c3d3-ea30-4288-a7be-6c43c5533241",
        "end_to_end_id": "2019-07-31 0002",
        "status_timestamp": "2021-09-13T08:47:39.414802",
        "create_timestamp": "2021-09-13T08:47:56.534234",
        "payment_status": "AUTHORIZATION_PENDING",
        "payment_status_reason": "info.payment.cancellation_in_progress",
        "auto_start_token": "8441d326-2d6e-4e4f-9412-303ec3d0931c",
        "authentication_id": "4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8",
        "_links": [
          {
            "rel": "details",
            "href": "/v2/payments/f59abbab-8df4-49be-b7fe-247f279b5aab"
          }
        ]
      }
    ]
  },
  "_links": [
    {
      "rel": "self",
      "href": "/v2/payments/cancel"
    },
    {
      "rel": "redirect",
      "href": "https://api.nordeaopenbanking.com/corporate/payments/identify?client_id=Psf34PDHxdLy2Sfyr4UF&code_challenge_method=S256&redirect_uri=https%3A%2F%2Fapi.nordeaopenbanking.com%2Fcorporate%2Fpayments%2Foauth&response_type=code&code_challenge=Z-iJoADAzUOuP8DISxbPY6T-IgCAfY0wx9oPbKIXqtM&scope=openid+agreement&state=27f9a022-b16a-4e57-953c-2d18dc922386&nonce=l5AjePogRPjWtw09864NOqqb47aZH14GD0sivuTv&login_hint=bankid_se&signing_token=eyJjdHkiOiJKV1QiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.hMT3ZHEcf3TNpnCrYfiisvB08y9C0AtezO9QuGqtR0L0OeLt8HWYN0v3PU8ZF1iu_v_Rh5LA4CjoIOU8lCGLSFmddUEfhl9iqMUeSh5wLizZv4pF6bo_YRnmR9WqLMzZpq_-dB9MB7mMA2KVHX6Jmy3ZWrleFuUabGdgypdyKy1Bi9tFAYFE0tHEAwm_8vPVyppypT6VFaldvRO8kTJrqZVuTFIYLXDKV69D8b40mEkcTRC5CO029UgCyyV8-Ia3vdhjk_0QklszkrAU0KlvIzVYat4GbXzbTC-snHJ_qgutFygtNH2vM1a84rLaYszbRa6dT285WsyCuNjMIHwSnQ.Dn2xpMne03d9EKzd.Sy83KdbkCzsXaSrUASZdWyRGKZ61jErjQLhN31j6ty7R7z81DGcdWUrB9X4DnHmWq2ZbzE2QI7xc3lAAllClrDyB90ZRPK62yLDprU0CHvIGIuLtC-ORqI5NhNtVS1XWkgHT_Th3AgCVZFCmujDlGNvfuoDvDgeesiC5ZQyYZ_uxHNn7IcQolU1LbBDnSry7WaglbhL-DnbnIOq_pQGRhw5zS9yYKyWWrO31XrV-2MA797-FgpCU7N-mzPUC2nUMhHrYt9C0A-h8h7ZtAF4AYl5LS3gZ-SARVp_K5-dpHhPC03Cx5gEkoL7EGsFNiEvvJkRlR_iaAgfRV-FFPbzMzqaKFi3c8GtUruarrhyMBdC-gmrKrTD_gzD_mTUJWRMYfR7W5cLl97vLC40ipUv85IkNP2KVLWi5B-2Kg_Jyhw0yz3X5wwCodG9Mn4rz0J8G-eZvahTaGCoEj0H5Zgyclq4cyESPqnzOqot-kQmG9eYEu9uQ1XSZ8gCEwes1MPTEd6l6v2Hwhw7qL1aj1B3rw-uPb_4mBhwj8BzZ5WRkbVpv0WqQr257Ysi5Hra3QCSdU8W8-58Gt4qQPuBA_khwgL4SjZnuji79NIoy4jQyA05j2WW4QQm6umkS8p4IXY6JkoOEPc1t.uM4OAVUbmD3kICouxGEL8w"
    },
    {
      "rel": "authentication_details",
      "href": "/v1/authentications/bankid_se/4c5d6d5cb844160bc28325b1160ca6ca31324822ffd136266c447370d0656ff8"
    }
  ]
}

Please note that “auto_start_token”, “authentication_id” as well as redirect and authentication_details links presence is determined by selected authentication_type and authentication_method

Get details of the BankID SE authentication

This endpoint URL has the following form:

GET /corporate/v1/authentications/bankid_se/{authentication_id}

This endpoint supports GET HTTP method.
The following headers must be used:

X-IBM-Client-Id: {client_id} 
X-IBM-Client-Secret: {client_secret}
X-Nordea-Originating-Date: {date}
X-Nordea-Originating-Host: {host}

Where the request is valid the response will be 200 SUCCESS and formatted like the example below

{
  "group_header": {
    "message_identification": "64b536c0e92c3947bd2f993c1af39d44",
    "creation_date_time": "2024-01-15T11:03:30.04307331Z",
    "http_code": 200
  },
  "response": {
    "qr_data": "bankid.52083e2c180a520d450b49e3b3bc29b60f701c889b2e1f5d1b81d2013d161896.4.AIf7W1tf0CK8PV66IogxfLoEsneyfSkylxGICIyuhnmA1E0qc5mDGg66s2A8JU4M",
    "auto_start_token": "8441d326-2d6e-4e4f-9412-303ec3d0931c",
    "status": "WAITING_FOR_USER"
  }
}

Please note that “auto_start_token” and “qr_data” will not be present when “status” will be different then “WAITING_FOR_USER”

Sample test data

A good amount of sample data (users, authorization permissions, etc.) have been placed in the sandbox environment to allow developers to explore the Corporate Payments API features/behaviour and test their client application functionality. This data is detailed in the table below for your reference. Data available in Sandbox environment can be fetched by using endpoint GET /corporate/v2/authorize/users.

Test data for Danish payments

Agreement Number	Account IBAN	Account BBAN	Account Currency	User Logon Id	Payment Authorization Permission	Type
130348721209	DK8820000216144198	20000216144198	DKK	70313276	ACT_ALONE	Transactional
130348721209	DK4720000808505894	20000808505894	DKK	70313276	ACT_ALONE	Transactional
130348721209	DK0820001544959502	20001544959502	DKK	70313276	ACT_ALONE	Transactional
130348721209	DK1020005005538159	20005005538159	DKK	70313276	ACT_ALONE	Transactional
130348721209	DK1920005036552583	20005036552583	DKK	70313276	ACT_ALONE	Transactional
130474822200	DK1520000807622315	20000807622315	DKK	70312662	TWO_TOGETHER	Transactional
130474822200	DK1520000807622315	20000807622315	DKK	70313004	ACT_ALONE	Transactional
130474822200	DK5720001544465666	20001544465666	DKK	70312662	TWO_TOGETHER	Transactional
130474822200	DK5720001544465666	20001544465666	DKK	70313004	ACT_ALONE	Transactional
130474822427	DK5220000270491715	20000270491715	DKK	70311198	ACT_ALONE	Transactional
130474822427	DK5220000270491715	20000270491715	DKK	70311591	TWO_TOGETHER	Transactional
130474822427	DK7220001560155049	20001560155049	DKK	70311198	ACT_ALONE	Transactional
130474822427	DK7220001560155049	20001560155049	DKK	70311591	TWO_TOGETHER	Transactional
130474822427	DK2420005005528692	20005005528692	DKK	70311198	ACT_ALONE	Transactional
130474822427	DK2420005005528692	20005005528692	DKK	70311591	TWO_TOGETHER	Transactional
130474822427	DK2120001543991305	20001543991305	DKK	70311198	ACT_ALONE	Transactional
130474822427	DK6220005036579260	20005036579260	USD	70311198	ACT_ALONE	Transactional
130474822427	DK2120001543991305	20001543991305	DKK	70311515	ACT_ALONE	Cash Pool
130474822427	DK2120001543991305	20001543991305	DKK	70311591	TWO_TOGETHER	Cash Pool
130474822427	DK2120001543991305	20001543991305	DKK	70312055	TWO_TOGETHER	Cash Pool
130474822427	DK1820000970202021	20000970202021	DKK	70311198	ACT_ALONE	Cash Pool
130474822427	DK1820000970202021	20000970202021	DKK	70311515	ACT_ALONE	Cash Pool
130474822427	DK1820000970202021	20000970202021	DKK	70311591	TWO_TOGETHER	Cash Pool
130474822427	DK1820000970202021	20000970202021	DKK	70312055	TWO_TOGETHER	Cash Pool
130474822427	DK3620005036542383	20000970202021	DKK	70311198	ACT_ALONE	Cash Pool
130474822427	DK3620005036542383	20000970202021	DKK	70311515	ACT_ALONE	Cash Pool
130474822427	DK3620005036542383	20000970202021	DKK	70311591	TWO_TOGETHER	Cash Pool
130474822427	DK3620005036542383	20000970202021	DKK	70312055	TWO_TOGETHER	Cash Pool

Test data for Finnish payments

Agreement Number	Account IBAN	Account BBAN	Account Currency	User Logon Id	Payment Authorization Permission	Type
130348721209	FI4616603001014326	N/A	EUR	70313276	ACT_ALONE	Transactional
130348721209	FI4616603001014326	N/A	EUR	70313514	TWO_TOGETHER	Transactional
130348721209	FI5115963000005662	N/A	EUR	70313276	ACT_ALONE	Transactional
130348721209	FI6711123000311263	N/A	EUR	70313276	ACT_ALONE	Transactional
130348721209	FI6711123000311263	N/A	EUR	70313514	TWO_TOGETHER	Transactional
130348721209	FI8216603000004393	N/A	EUR	70313276	ACT_ALONE	Transactional
130348721209	FI8216603000004393	N/A	EUR	70313514	ACT_ALONE	Transactional
130474822427	FI4116603500005114	N/A	EUR	70311198	ACT_ALONE	Transactional
130474822427	FI4715723000311878	N/A	EUR	70311198	ACT_ALONE	Transactional
130474822427	FI4715723000311878	N/A	EUR	70311515	TWO_TOGETHER	Transactional
130474822427	FI4715723000311878	N/A	EUR	70311591	TWO_TOGETHER	Transactional
130474822427	FI5815723000312165	N/A	EUR	70311198	ACT_ALONE	Transactional
130474822427	FI5815723000312165	N/A	EUR	70311515	TWO_TOGETHER	Transactional
130474822427	FI5815723000312165	N/A	EUR	70311591	TWO_TOGETHER	Transactional
130474822427	FI6116603001005423	N/A	EUR	70311198	ACT_ALONE	Transactional
130474822427	FI6116603001005423	N/A	EUR	70311515	TWO_TOGETHER	Transactional
130474822427	FI6116603001005423	N/A	EUR	70312055	ACT_ALONE	Transactional
130474822427	FI6116603001012213	N/A	EUR	70311198	ACT_ALONE	Transactional
130474822427	FI6116603001012213	N/A	EUR	70311515	TWO_TOGETHER	Transactional
130474822427	FI6116603001012213	N/A	EUR	70312055	ACT_ALONE	Transactional
130474822427	FI6816603001007528	N/A	EUR	70311198	ACT_ALONE	Transactional
130474822427	FI6816603001007528	N/A	EUR	70311515	CREATE_ONLY	Transactional
130474822427	FI6816603001007528	N/A	EUR	70311591	TWO_TOGETHER	Transactional
130474822427	FI6816603001007528	N/A	EUR	70312055	TWO_TOGETHER	Transactional
130474822427	FI8015723000311381	N/A	EUR	70311198	ACT_ALONE	Transactional
130474822427	FI8015723000311381	N/A	EUR	70311515	TWO_TOGETHER	Transactional
130474822427	FI8015723000311381	N/A	EUR	70311591	TWO_TOGETHER	Transactional
130474822427	FI6416605200008561	N/A	JPY	70312055	ACT_ALONE	Transactional
130474822427	FI6416605200008561	N/A	JPY	70311591	ACT_ALONE	Transactional
130474822427	FI8616605200008553	N/A	USD	70311198	ACT_ALONE	Transactional
130474822427	FI8616605200008553	N/A	USD	70311515	TWO_TOGETHER	Transactional
130474822427	FI8616605200008553	N/A	USD	70311591	TWO_TOGETHER	Transactional
130474822427	FI2724982400224961	N/A	EUR	70311198	ACT_ALONE	Cash Pool
130474822427	FI2724982400224961	N/A	EUR	70311515	ACT_ALONE	Cash Pool
130474822427	FI2724982400224961	N/A	EUR	70311591	TWO_TOGETHER	Cash Pool
130474822427	FI2724982400224961	N/A	EUR	70312055	TWO_TOGETHER	Cash Pool
130474822427	FI9117453000002297	N/A	EUR	70311198	ACT_ALONE	Cash Pool
130474822427	FI9117453000002297	N/A	EUR	70311515	ACT_ALONE	Cash Pool
130474822427	FI9117453000002297	N/A	EUR	70311591	ACT_ALONE	Cash Pool
130474822427	FI9117453000002297	N/A	EUR	70312055	ACT_ALONE	Cash Pool

Test data for Norwegian payments

Agreement Number	Debtor Account in IBAN	Debtor Account in BBAN	Account Currency	User Logon Id	Payment Authorization Permission	Type
130474822427	NO2268250512345	68250512345	NOK	70311198	ACT_ALONE	Transactional
130474822427	NO2268250512345	68250512345	NOK	70311515	TWO_TOGETHER	Transactional
130474822427	NO2268250512345	68250512345	NOK	70311591	TWO_TOGETHER	Transactional
130474822427	NO2268250512345	68250512345	NOK	70312055	ACT_ALONE	Transactional
130474822427	NO9768250512353	68250512353	NOK	70311198	ACT_ALONE	Transactional
130474822427	NO9768250512353	68250512353	NOK	70311591	TWO_TOGETHER	Transactional
130474822427	NO9768250512353	68250512353	NOK	70312055	ACT_ALONE	Transactional
130474822427	NO7568250512361	68250512361	NOK	70311198	ACT_ALONE	Transactional
130474822427	NO7568250512361	68250512361	NOK	70311515	TWO_TOGETHER	Transactional
130474822427	NO7568250512361	68250512361	NOK	70311591	TWO_TOGETHER	Transactional
130474822427	NO7568250512361	68250512361	NOK	70312055	ACT_ALONE	Transactional
130474822427	NO9464520503798	64520503798	NOK	70311198	ACT_ALONE	Cash Pool
130474822427	NO9464520503798	64520503798	NOK	70311515	ACT_ALONE	Cash Pool
130474822427	NO9464520503798	64520503798	NOK	70311591	TWO_TOGETHER	Cash Pool
130474822427	NO9464520503798	64520503798	NOK	70312055	TWO_TOGETHER	Cash Pool
130474822427	NO6564520501507	64520501507	NOK	70311198	ACT_ALONE	Cash Pool
130474822427	NO6564520501507	64520501507	NOK	70311515	ACT_ALONE	Cash Pool
130474822427	NO6564520501507	64520501507	NOK	70311591	TWO_TOGETHER	Cash Pool
130474822427	NO6564520501507	64520501507	NOK	70312055	TWO_TOGETHER	Cash Pool
130474822427	NO2265600440335	65600440335	EUR	70311198	ACT_ALONE	Cash Pool
130474822427	NO2265600440335	65600440335	EUR	70311515	ACT_ALONE	Cash Pool
130474822427	NO2265600440335	65600440335	EUR	70311591	ACT_ALONE	Cash Pool
130474822427	NO2265600440335	65600440335	EUR	70312055	ACT_ALONE	Cash Pool
130474822200	NO4468250512337	68250512337	USD	70312662	TWO_TOGETHER	Transactional
130474822200	NO4468250512337	68250512337	USD	70313004	ACT_ALONE	Transactional
130474822200	NO6668250512329	68250512329	EUR	70312662	TWO_TOGETHER	Transactional
130474822200	NO6668250512329	68250512329	EUR	70313004	ACT_ALONE	Transactional
130474822200	NO9468250512310	68250512310	USD	70312662	ACT_ALONE	Transactional
130474822200	NO9468250512310	68250512310	USD	70313004	ACT_ALONE	Transactional

Test data for Swedish payments

Agreement Number	Account IBAN	Account BBAN	Plusgiro Number	Account Currency	User Logon Id	Payment Authorization Permission	Type
130348721209	SE5695000099602605435979	99602605435979	5435979	SEK	70313276	ACT_ALONE	Transactional
130348721209	SE5695000099602605435979	99602605435979	5435979	SEK	70313514	ACT_ALONE	Transactional
130348721209	SE7595000099603400171769	99603400171769	171769	EUR	70313276	ACT_ALONE	Transactional
130348721209	SE7595000099603400171769	99603400171769	171769	EUR	70313514	ACT_ALONE	Transactional
130348721209	SE1895000099602613964515	99602613964515	13964515	SEK	70313276	ACT_ALONE	Cash Pool
130474822200	SE5595000099604200176040	99604200176040	176040	SEK	70313004	ACT_ALONE	Transactional
130474822200	SE5595000099604200176040	99604200176040	176040	SEK	70312662	ACT_ALONE	Transactional
130474822200	SE4830000000040161303354	40161303354	N/A	SEK	70312662	ACT_ALONE	Transactional
130474822200	SE4830000000040161303354	40161303354	N/A	SEK	70313004	TWO_TOGETHER	Transactional
130474822427	SE0295000099604213908314	99604213908314	13908314	SEK	70311198	ACT_ALONE	Transactional
130474822427	SE0295000099604213908314	99604213908314	13908314	SEK	70311515	ACT_ALONE	Transactional
130474822427	SE0295000099604213908314	99604213908314	13908314	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE0295000099604213908314	99604213908314	13908314	SEK	312055	TWO_TOGETHER	Transactional
130474822427	SE9195000099602614054381	99602614054381	14054381	SEK	70311198	ACT_ALONE	Transactional
130474822427	SE9195000099602614054381	99602614054381	14054381	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE8795000099601814438154	99601814438154	14438154	SEK	70311198	ACT_ALONE	Transactional
130474822427	SE8795000099601814438154	99601814438154	14438154	SEK	70311515	ACT_ALONE	Transactional
130474822427	SE8795000099601814438154	99601814438154	14438154	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE6130000000034821701634	34821701634	N/A	SEK	70311198	ACT_ALONE	Transactional
130474822427	SE6130000000034821701634	34821701634	N/A	SEK	70311515	ACT_ALONE	Transactional
130474822427	SE6130000000034821701634	34821701634	N/A	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE3930000000040161303419	40161303419	N/A	SEK	70311198	ACT_ALONE	Transactional
130474822427	SE3930000000040161303419	40161303419	N/A	SEK	70311515	ACT_ALONE	Transactional
130474822427	SE3930000000040161303419	40161303419	N/A	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE9130000000041357802818	41357802818	N/A	SEK	70311198	ACT_ALONE	Transactional
130474822427	SE9130000000041357802818	41357802818	N/A	SEK	70311515	ACT_ALONE	Transactional
130474822427	SE9130000000041357802818	41357802818	N/A	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE4530000000030167700413	30167700413	N/A	CHF	70311198	ACT_ALONE	Transactional
130474822427	SE4530000000030167700413	30167700413	N/A	CHF	70311515	ACT_ALONE	Transactional
130474822427	SE4530000000030167700413	30167700413	N/A	CHF	70311591	TWO_TOGETHER	Transactional
130474822427	SE4530000000030167700413	30167700413	N/A	CHF	70312055	TWO_TOGETHER	Transactional
130474822427	SE1695000099604200171892	4200171892	N/A	EUR	70311198	ACT_ALONE	Transactional
130474822427	SE1695000099604200171892	4200171892	N/A	EUR	70311591	TWO_TOGETHER	Transactional
130474822427	SE5095000099603413908389	99603413908389	13908389	EUR	70311198	ACT_ALONE	Transactional
130474822427	SE5095000099603413908389	99603413908389	13908389	EUR	70311591	TWO_TOGETHER	Transactional
130474822427	SE5095000099603413908389	99603413908389	13908389	EUR	70312055	TWO_TOGETHER	Transactional
130474822427	SE9195000099602614054381	99602614054381	14054381	SEK	70311198	ACT_ALONE	Transactional
130474822427	SE9195000099602614054381	99602614054381	14054381	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE9195000099602614054381	99602614054381	14054381	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE9130000000041357802818	41357802818	N/A	SEK	70311198	ACT_ALONE	Transactional
130474822427	SE9130000000041357802818	41357802818	N/A	SEK	70311591	TWO_TOGETHER	Transactional
130474822427	SE5295000099602600119966	99602600119966	N/A	SEK	70311198	ACT_ALONE	Cash Pool
130474822427	SE5295000099602600119966	99602600119966	N/A	SEK	70311515	ACT_ALONE	Cash Pool
130474822427	SE5295000099602600119966	99602600119966	N/A	SEK	70311591	TWO_TOGETHER	Cash Pool
130474822427	SE5295000099602600119966	99602600119966	N/A	SEK	70312055	TWO_TOGETHER	Cash Pool
130474822427	SE4395000099603400105221	99603400105221	N/A	EUR	70311198	ACT_ALONE	Cash Pool
130474822427	SE4395000099603400105221	99603400105221	N/A	EUR	70311515	ACT_ALONE	Cash Pool
130474822427	SE4395000099603400105221	99603400105221	N/A	EUR	70311591	TWO_TOGETHER	Cash Pool
130474822427	SE4395000099603400105221	99603400105221	N/A	EUR	70312055	TWO_TOGETHER	Cash Pool

Test data for External payments

Agreement Number	Account Number	Account Currency	User Logon Id	Payment Authorization Permission
130474822427	SE8592700000092701058888	SEK	70311198	ACT_ALONE
130474822427	SE8592700000092701058888	SEK	70311515	TWO_TOGETHER
130474822427	SE8592700000092701058888	SEK	70311591	TWO_TOGETHER
130474822427	SE8592700000092701058888	SEK	70312055	TWO_TOGETHER
130474822427	DK7962034118980181	DKK	70311198	ACT_ALONE
130474822427	DK7962034118980181	DKK	70311515	TWO_TOGETHER
130474822427	DK7962034118980181	DKK	70311591	TWO_TOGETHER
130474822427	DK7962034118980181	DKK	70312055	ACT_ALONE
130474822427	FI2916603001015893	EUR	70311198	ACT_ALONE
130474822427	FI2916603001015893	EUR	70311515	TWO_TOGETHER
130474822427	FI2916603001015893	EUR	70311591	TWO_TOGETHER
130474822427	FI2916603001015893	EUR	70312055	TWO_TOGETHER
130474822427	PL39106000760000409950046599	EUR	70311198	ACT_ALONE
130474822427	PL39106000760000409950046599	EUR	70311515	TWO_TOGETHER
130474822427	PL39106000760000409950046599	EUR	70311591	TWO_TOGETHER
130474822427	PL39106000760000409950046599	EUR	70312055	ACT_ALONE
130474822427	77881122	GBP	70311198	ACT_ALONE

Corporate Accounts API v3 Corporate Payments Single SCA API v2