Corporate Payout API: FAQ – Nordea Open Banking Support

Reference:

While initiating a payment:

using template_id: INTERCOMPANY_CROSS_BORDER_SE, we receive the following error:

"payment_status":"PAYMENT_REJECTED","payment_status_reason":"error.payment.regulatory_reporting_code_missing"

Why is that?

Make sure you provide a valid purpose_code parameter (purpose code of money transfer as defined by Swedish Tax Authority/Skatteverket) in the request. Refer to the following list:

Swedish Tax Authority Payment Reporting Codes

We tried to refund a bank payment to the customer by calling:

POST /corporate/premium/v2/payments

Payment Initiation (Corporate Payout API)

{
"amount": 29.99,
"debtor": {
"account": {
"type": "IBAN",
"value": "FI62 {redacted} 80",
"currency": "EUR"
},
"own_reference": "RE4{redacted}7"
},
"creditor": {
"name": "{redacted}",
"account": {
"type": "IBAN",
"value": "DE7520{redacted}5100"
},
"message": "RE4{redacted}7"
},
"currency": "EUR",
"external_id": "0123456e-a123-1be1-1fb1-af12a12345e1",
"template_id": "SEPA_INSTANT_CREDIT_TRANSFER_FI"
}

and we encountered the following error ("code": "error.validation",

"description": "Creditor bank is not eligible for sepa instant transfer."):

{
"error": {
"request": {
"url": "/premium/v2/payments"
},
"failures": [
{
"code": "error.validation",
"description": "Creditor bank is not eligible for sepa instant transfer."
}
]
},
"group_header": {
"http_code": 400,
"creation_date_time": "2025-01-20T11:52:30.289503501Z",
"message_identification": "16554d049007166e"
}
}

Is there a way to know which banks are not eligible?

Nordea do not expose the list of banks eligible to receive instant payments. Each bank should share this information. If a creditor bank does not accept instant payments, we recommend you use SEPA_CREDIT_TRANSFER_FI template to process the payment:

Payment Initiation (Corporate Payout)

We have trouble sending a transfer to Swedbank - it's rejected with the following error:

"payment_status":"PAYMENT_REJECTED","payment_status_reason":"error.payment.credit_account_invalid"

Make sure to provide provide bank information - creditor.bank.bic - in your request towards:

POST /corporate/premium/v2/payments

Payment Initiation (Corporate Payout API)

for DOMESTIC_CREDIT_TRANSFER_SE template. Otherwise the payment is treated as Nordea internal - then the creditor number you provide will be evaluated as invalid one, as it does not belong to any of Nordea customers. Please also bear in mind that for payments to Nordea personkonto you should not use 3300 prefix. It can also cause such error.

We want to send transfers in Sweden (from Nordea to Swedish bank) and we collect the clearing number and account number from our customers (and the free text name of the bank). Is there a payment template that supports this information? Does DOMESTIC_CREDIT_TRANSFER_SE template require a bank code and BIC? Can we get a bank code from IBAN or clearing code?

DOMESTIC_CREDIT_TRANSFER_SE template does not require bank field and also accepts BGNR, PGNR, BBAN creditor account formats. BIC is mandatory if the payment is sent to a non-Nordea Swedish bank. Bank_code in Sweden is not a clearing code but - specifically for Sweden - bank identifier code (bankidentifieringskod).

Please see:

Corporate Payout API - details

Corporate Payout - API reference

SWIFT Codes for banks in Sweden

Note: We don't have official mappings from account to bankidentifieringskod so we cannot provide it.

What is the best approach to work with the requested_execution_date on DOMESTIC_CREDIT_TRANSFER_SE payment template? Is it recommended to add logic following cut-off times and then:

if we are before the cut-off - set requested_execution_date to today's date?
if we are after the cut-off - set requested_execution_date to tomorrow's date?

Are there any automated options to handle cut-off?

We don't have an automated option to handle cut-offs. We recommend changing requested_execution_date to the next working day if a payment is to be sent after cut-off time. Default requested_execution_date is always "today's date" - if it's sent after the cut-off time, it will be rejected.

Can we use DOMESTIC_CREDIT_TRANSFER_SE template for Business-to-Business Payouts via Nordea in Sweden? If so, do we need any additional information like company name or company registration number for B2B Payouts?

Yes, use DOMESTIC_CREDIT_TRANSFER_SE and specify if the beneficiary account is an IBAN/BBAN/BGNR/PGNR. The company name and/or company registration number don't need to be included in the payment initiation request.

Can the SEPA_CREDIT_TRANSFER_FI template be used for initiating SEPA transfers from Swedish EUR accounts (SE IBAN with BIC NDEASESS)?

No, it cannot be used. For payments from Swedish accounts, you must use Swedish payment templates (e.g., CROSS_BORDER_SE). Please refer to:

Payment templates

We are enhancing our UIs to prevent Nordea payment failures caused by incompatible characters. Customer business names may contain characters unsupported by the API. This prevents payment initiation when creditor account names must precisely match registered business names. Our system currently applies limited character substitutions during payment requests. Could you advise on resolving this issue and supply the complete list of characters that the API rejects? Alternatively, could you specify the subset of supported characters?

Please see: Reference and the following example:

name:
          description: Name of the creditor.
          example: Example and Example Ltd
          maxLength: 35
          minLength: 0
          pattern: ^$|[\w\u00e4\u00c4\u00e5\u00c5\u00f6\u00d6\u00e6\u00c6\u00f8\u00d8.,:\-+'\/()?;*!%&=@]+[\w\u00e4\u00c4\u00e5\u00c5\u00f6\u00d6\u00e6\u00c6\u00f8\u00d8\s.,:\-+'\/()?;*!%&=@]*
          type: string

Also refer to:

regex101.com

where you can check what characters are supported for each template and field.

What could cause this error during a payment initiation process: "code": "error.resource.denied", "description": "Token does not authorize the requested action."?

response body: {\"group_header\":{\"message_identification\":\"362200f92df21681\",\"creation_date_time\":\"2026-02-04T08:48:15.705947555Z\",\"http_code\":403},\"error\":{\"request\":{\"url\":\"/premium/v2/payments\"},\"failures\":[{\"code\":\"error.resource.denied\",\"description\":\"Token does not authorize the requested action.\"}]}}

It can be caused by using a client_token received after initialising the corporate authorisation process. This token cannot be used in a payment initiation process and must first be exchanged for an access token. Please refer to the following documentation:

Corporate Authorization API

API Reference - Corporate Access Authorization API

We encountered the following payment rejection: "payment_status":"PAYMENT_REJECTED", "payment_status_reason":"error.payment.not_authorized

{"_id":"bd400860-***-ef91cf65a10d","template_id":"SEPA_CREDIT_TRANSFER
_FI","external_id":"BB187326-***-85E69056442B","end_to_end_id":"1_17***17","amount":"927.7","requested_execution_date":"2026-03-02","currency":"EUR","urgency":"NORMAL","debtor":{"account":{"value":"xxx","type":"IBAN","currency
":"EUR"}},"creditor":{"account":{"value":"xxx","type":"IBAN"},"name":"yyy Oy","reference":{"value":"10***20","type":"FI_DOM"}},"status_timestamp":"2026-03-02T13:28:59.378113","create_timestamp":"2026-03-02T13:28:59.024041
","payment_status":"PAYMENT_REJECTED","payment_status_reason":"error.payment.not_authorized","verification_of_payee_result":{"status":"MATCH"},"_links":[{"rel":"self","href":"/premium/v2/payments/bd400860-***-b949-ef91cf65a10d"}]}},"success":true}

What could be the reason?

This might indicate that the payment rights are missing from your Corporate Netbank agreement. Please contact your Nordea customer team for assistance in setting up these permissions.

We encountered the following error: "code": "error.validation", "description": "Creditor name must be provided."

{
"group_header": {
"message_identification": "07b1263f3780169b",
"creation_date_time": "2026-04-23T07:02:17.798962605Z",
"http_code": 400
},
"error": {
"request": {
"url": "/premium/v2/payments"
},
"failures": [
{
"code": "error.validation",
"description": "Creditor name must be provided.",
"path": "creditor.name",
"type": "CreditorNameRequired"
}

Why is that?

The name of the beneficiary (creditor) is mandatory for regular credit transfers in Sweden. Please refer to Changes from the previous version section:

Corporate Payout API - details

Corporate Payout - API reference

Note: For allowed set of characters see:

Corporate Payout - API Reference

Related Questions

Reference: