{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-apis/banking/v4/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Swedish domestic payments – Bankgiro, Plusgiro and account payments","keywords":"documentation, api, portal, banking, payment, account information, aritma, psd2, open banking, reconciliation","description":"How to send Bankgiro, Plusgiro and account (BBAN) payments in Sweden with the Aritma Banking API.","meta":[{"name":"google-site-verification","content":"hplqlK_5O42BZjNnjtVQMEpxv9JkxcD1eH4J1T-NQmI"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"swedish-domestic-payments","__idx":0},"children":["Swedish domestic payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide covers how to initiate domestic Swedish payments via the Aritma Banking API. It covers the three domestic payment types and which API parameters to use for each. Sweden has a unique payment landscape with multiple creditor account types — Bankgiro, Plusgiro, and BBAN (domestic bank account numbers) — each with distinct identification schemes, clearing member IDs, and bank-specific rules."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Payment type"},"children":["Payment type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Creditor identified by"},"children":["Creditor identified by"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"creditorAccount"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAccount"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bankgiro payment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bankgiro number (7–8 digits)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other.schemeName: \"BGNR\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plusgiro payment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plusgiro number (2–8 digits)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other.schemeName: \"PGNR\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account payment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clearing number + account number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bban"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All three are sent to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["same endpoint"]}," with the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["same JSON structure"]},". Aritma uses the account type, currency and country you send to create the correct domestic payment for the customer's bank. You don't need to send bank-specific values such as clearing member IDs for Bankgiro or Plusgiro."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Structured addresses from November 2026"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["November 2026"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["townName"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["mandatory"]}," in both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["debtorAddress"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAddress"]},". Payments without them may be rejected by the bank. Start sending them now."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"Invalid OCR references are rejected"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the OCR reference doesn't match the payee's OCR agreement with Bankgirot or Plusgirot, the bank can ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["reject"]}," the payment. Validate the check digit before sending, and never put free text in an OCR reference."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," Payments can only be instructed ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["from"]}," Bankgiro numbers that are linked to a bank account serviced by the debtor's bank. Payments can only be instructed from Bankgiro numbers that are linked to a bank account serviced by the debtor's bank."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"domestic-payment-types","__idx":1},"children":["Domestic Payment Types"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-bankgiro-payment","__idx":2},"children":["1. Bankgiro Payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A payment to a Bankgiro number (alias). Use when the creditor has provided a 7–8 digit Bankgiro number."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API input:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAccount.other.identification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345678"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bankgiro number (7–8 digits)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAccount.other.schemeName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BGNR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always BGNR for Bankgiro"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAgentCountryCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAddress.townName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Stockholm"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory from Nov 2026"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAddress.country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory from Nov 2026"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"body-structure","__idx":3},"children":["Body structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One request creates one bulk payment containing one or more payment lines. All lines in a request must share the same debtor account and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestedExecutionDate"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"debtorAccount\": {\"bban\": \"123456789\"},\n  \"debtorName\": \"Aritma AS\",\n  \"debtorAddress\": {\"townName\": \"Stockholm\", \"country\": \"SE\"},\n  \"requestedExecutionDate\": \"2026-01-01\",\n  \"paymentLines\": [\n    {\n    .....\n      \"endToEndIdentification\": \"end-to-end-12345\",\n      \"instructedAmount\": {\"currency\": \"SEK\", \"amount\": \"100\"},\n      \"creditorAccount\": {\"other\":{\n                            \"identification\":\"80017654\",\n                            \"schemeName\":\"BGNR\"                             \n                                } },\n      \"creditorName\": \"Leverantör AB\",\n      \"creditorAgentCountryCode\":\"SE\",\n      \"creditorAddress\": {\"townName\": \"Stockholm\", \"country\": \"SE\"},\n      \"remittanceInformationStructured\":{\"reference\": \"897874654875\", \"referenceType\": \"SCOR\"}\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rules:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Bankgiro numbers are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["7 or 8 digits"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-plusgiro-payment","__idx":4},"children":["2. Plusgiro Payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A payment to a Plusgiro number (account at Nordea). Use when the creditor has provided a 2–8 digit Plusgiro number."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API input:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAccount.other.identification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4505905"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plusgiro number (2–8 digits, never starts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAccount.other.schemeName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PGNR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always PGNR for Plusgiro"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAgentCountryCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Företaget AB"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAddress.townName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Stockholm"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory from Nov 2026"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAddress.country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory from Nov 2026"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"body-structure-1","__idx":5},"children":["Body structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One request creates one bulk payment containing one or more payment lines. All lines in a request must share the same debtor account and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestedExecutionDate"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"debtorAccount\": {\"bban\": \"123456789\"},\n  \"debtorName\": \"Aritma AS\",\n  \"debtorAddress\": {\"townName\": \"Stockholm\", \"country\": \"SE\"},\n  \"requestedExecutionDate\": \"2026-01-01\",\n  \"paymentLines\": [\n    {\n    .....\n      \"endToEndIdentification\": \"end-to-end-12345\",\n      \"instructedAmount\": {\"currency\": \"SEK\", \"amount\": \"100\"},\n      \"creditorAccount\": {\"other\":{\n                            \"identification\":\"40017654\",\n                            \"schemeName\":\"PGNR\"                             \n                                } },\n      \"creditorName\": \"Leverantör AB\",\n      \"creditorAgentCountryCode\":\"SE\",\n      \"creditorAddress\": {\"townName\": \"Stockholm\", \"country\": \"SE\"},\n      \"remittanceInformationStructured\":{\"reference\": \"897874654875\", \"referenceType\": \"SCOR\"}\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rules:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Plusgiro numbers are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2–8 digits"]},". ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Never starts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-account-payment-bban","__idx":6},"children":["3. Account Payment (BBAN)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A payment directly to a Swedish bank account using a clearing number + account number."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API input:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAccount.bban"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["832796940330123"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAgentClearingSystem.memberId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8327"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clearing number (5 digits if starts with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8"]},", otherwise 4)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAgentCountryCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Företaget AB"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommended (mandatory for salary)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAddress.townName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Stockholm"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory from Nov 2026"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAddress.country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory from Nov 2026"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SEK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Or other supported currency"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"body-structure-2","__idx":7},"children":["Body structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One request creates one bulk payment containing one or more payment lines. All lines in a request must share the same debtor account and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestedExecutionDate"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"debtorAccount\": {\"bban\": \"123456789\"},\n  \"debtorName\": \"Aritma AS\",\n  \"debtorAddress\": {\"townName\": \"Stockholm\", \"country\": \"SE\"},\n  \"requestedExecutionDate\": \"2026-01-01\",\n  \"paymentLines\": [\n    {\n    .....\n      \"endToEndIdentification\": \"end-to-end-12345\",\n      \"instructedAmount\": {\"currency\": \"SEK\", \"amount\": \"100\"},\n      \"creditorAccount\": {\"bban\":\"832796940330123\"},\n      \"creditorAgentClearingSystem\":{\"memberid\":\"8327\"},\n      \"creditorName\": \"Leverantör AB\",\n      \"creditorAgentCountryCode\":\"SE\",\n      \"creditorAddress\": {\"townName\": \"Stockholm\", \"country\": \"SE\"},\n      \"remittanceInformationStructured\":{\"reference\": \"897874654875\", \"referenceType\": \"SCOR\"}\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rules:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The clearing number in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memberId"]}," identifies the creditor's bank."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5 digits"]}," when starting with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8"]}," (Swedbank/Sparbanken), otherwise ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["4 digits"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAgent.bic"]}," at the same time as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAgentClearingSystem.memberId"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"international-payments-from-sweden","__idx":8},"children":["International Payments from Sweden"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tax-reporting-code","__idx":9},"children":["Tax Reporting Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A tax reporting code must be provided when a cross-border payment exceeds ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SEK 150,000"]}," (or equivalent in foreign currency). Codes are maintained by Skatteverket."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide the code:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regulatoryReportingCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["101"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regulatoryReportingInformation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["varuimport"]}," (example)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["one"]}," code per payment."," ","See the full list of ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.skatteverket.se/foretag/skatterochavdrag/kontrolluppgifter/kontrolluppgifterinternationellt/betalningskoder.4.96cca41179bad4b1aa7933.html"},"children":["payment codes on Skatteverket.se"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Change"},"children":["Change"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Impact"},"children":["Impact"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Beneficiary name mandatory"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorName"]}," must be populated on all BG/PG payments"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Town Name mandatory"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["townName"]}," in debtor and creditor address"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Richer references"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Messages up to 140 characters"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Extended Remittance Info"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Up to 999 references per payment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Improved OCR validation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Structured reference validation enhanced"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Later cut-off times"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Increased operational flexibility"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"checklist","__idx":10},"children":["Checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before sending, check that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Bankgiro numbers use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schemeName: \"BGNR\""]}," and Plusgiro numbers use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["schemeName: \"PGNR\""]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Bankgiro and Plusgiro numbers contain digits only"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Account payments use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bban"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," Account payments use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAgentClearingSystem: {\"memberId\": \"XXXX\"}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorName"]}," is populated"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"input","attributes":{"checked":false,"type":"checkbox","readOnly":true},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["debtorAddress"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creditorAddress"]}," include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["townName"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}]}]}]},"headings":[{"value":"Swedish domestic payments","id":"swedish-domestic-payments","depth":1},{"value":"Domestic Payment Types","id":"domestic-payment-types","depth":2},{"value":"1. Bankgiro Payment","id":"1-bankgiro-payment","depth":3},{"value":"Body structure","id":"body-structure","depth":3},{"value":"2. Plusgiro Payment","id":"2-plusgiro-payment","depth":3},{"value":"Body structure","id":"body-structure-1","depth":3},{"value":"3. Account Payment (BBAN)","id":"3-account-payment-bban","depth":3},{"value":"Body structure","id":"body-structure-2","depth":3},{"value":"International Payments from Sweden","id":"international-payments-from-sweden","depth":2},{"value":"Tax Reporting Code","id":"tax-reporting-code","depth":3},{"value":"Checklist","id":"checklist","depth":2}],"frontmatter":{"title":"Swedish domestic payments","seo":{"title":"Swedish domestic payments – Bankgiro, Plusgiro and account payments","description":"How to send Bankgiro, Plusgiro and account (BBAN) payments in Sweden with the Aritma Banking API."}},"lastModified":"2026-10-07T11:38:10.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/banking/v4/guides/swedish-payments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}