Skip to main content
POST
Move the paying account's Nordea Business connection forward

Authorizations

Authorization
string
header
required

Firebase ID token from an interactive portal session. Required for interactive operations (payroll, company settings, API-key management) and invoice decisions allowed by the member's review permissions.

Body

application/json
customer_id
string
required
expected_row_version
integer<int64>
required
Required range: x >= 1
state
enum<string>
required
Available options:
application_submitted,
observe,
active
evidence_ref
string
deprecated

Retired free-text note; refused for active.

Maximum string length: 500
evidence_document_id
string

Required for active. The customer's retained activation letter (an evidence.document of this tenant, PDF or image).

Maximum string length: 128
evidence_sha256
string

Required for active. The digest of the letter as the uploads list shows it; the server activates exactly those retained bytes or answers 409.

Pattern: ^[0-9a-f]{64}$
letter_account_iban
string

Required for active. The payment account the letter names; must be the current paying account.

agreement_id
string

The bank's agreement identifier printed on the letter (Nordea "Sopimustunnus").

Maximum string length: 64

Response

Current payment settings.

can_change
boolean
required
can_verify
boolean
required
banks
object[]
required

The banks a company admin may choose as the paying bank: the provider lists them for the market and LAC has a route policy for them. route is how a payment reaches the bank (iso_corporate: a bank-side corporate agreement and the customer confirms the uploaded file in the bank; psd2_pis: payment initiation the customer authorises at release). readiness is live when LAC has proven the route end to end and releases money on it, provider_listed when the provider lists the bank but LAC has not verified the route yet: the account can be saved and the customer-side steps started, but nothing is released. activation names what marks the bank connection active and guide the setup guidance the portal renders for the bank. Live routes sort first.

terms
object
required
verification
object
required

Authoritative KYC UI state derived from LAC's hosted-flow attempt record and the provider's live status. started means LAC returned a hosted URL that remains the one actionable flow for 24 hours; retry means that URL expired or Open Payments answered Invalid; pending means a start has no recorded outcome and must not be repeated before the same 24-hour boundary. Only clear represents current provider validity.

setup
object