{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-apis/banking/v4/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Negative Payments","keywords":"documentation, api, portal, banking, payment, account information, aritma, psd2, open banking, reconciliation","description":"Developer documentation for Aritma's banking and financial APIs - payments, account information, webhooks, authentication and integrations.","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":"negative-payments","__idx":0},"children":["Negative Payments"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using Aritma credit note functionality"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Aritma Banking Api allows for negative payments or credit notes. These payments can be sent alone or together with positive payments."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"matching-criteria","__idx":1},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#matching-criteria"},"children":[]},"Matching Criteria"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a negative payment to match a positive payment, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["all"]}," of the following must be true:"]},{"$$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":"Criterion"},"children":["Criterion"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Rule"},"children":["Rule"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Debtor account number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be identical"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creditor account number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be identical"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creditor name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be identical"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Debtor Account currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must match if using Swedish Postgiro numbers (multicurrency support)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remittance information type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SCOR"]}," is used, all matching payments must use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SCOR"]},". Other types match each other unless one uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SCOR"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Destination bank"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be the same bank"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bundling-rules","__idx":2},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#bundling-rules"},"children":[]},"Bundling Rules"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When negative and positive payments are matched and bundled together, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["combined sum must exceed 0"]}," for the payments to go through."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the bundled sum is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["greater than 0"]}," — the payments are sent"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the bundled sum is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["0 or less"]}," — the payments will not go through"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"unmatched-negative-payments","__idx":3},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#unmatched-payments"},"children":[]},"Unmatched Negative Payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you send a negative payment that does not match any positive payment in the same signing basket or payment approval, the system stores it for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["up to 30 days"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["During this period:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The negative payment waits for a matching positive payment to arrive"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once a match is found, the payments are bundled automatically"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After 30 days without a match, the negative payment expires and gets rejected"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This is also the case for a positive payment that matches a negative, but is smaller in amount. For instance a negative payment of -1000 and a regular payment"," ","of 500 that have the same matching key will both be waiting in the system for a payment that matches that is 501 or greater for the total sum to be above 0."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-scenarios","__idx":4},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#example"},"children":[]},"Example Scenarios"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-successful-match","__idx":5},"children":["✅ Successful Match"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Positive payment:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Debtor account: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345678901"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creditor account: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["98765432109"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creditor name: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Acme AB"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Amount: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2000 SEK"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Remittance: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Invoice 123"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Negative payment — matches:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Debtor account: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345678901"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creditor account: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["98765432109"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creditor name: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Acme AB"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Amount: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-1000 SEK"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Remittance: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Correction"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These payments match because all criteria align — same accounts, same creditor name, same destination bank."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-no-match--currency-mismatch-swedish-postgiro","__idx":6},"children":["❌ No Match — Currency Mismatch (Swedish Postgiro)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Positive payment:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Debtor account: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345-6"]}," (Swedish Postgiro)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Currency: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SEK"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Negative payment — does NOT match:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Debtor account: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345-6"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Currency: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOK"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Swedish Postgiro accounts support multiple currencies, so the currency must match exactly."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-no-match--scor-type-mismatch","__idx":7},"children":["❌ No Match — SCOR Type Mismatch"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Positive payment:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Remittance type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SCOR"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reference: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RF18539007547034"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Negative payment — does NOT match:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Remittance type: Free text"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reference: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Correction for invoice"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a payment uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SCOR"]},", the matching payment must also use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SCOR"]}," — other remittance types will not match."]}]},"headings":[{"value":"Negative Payments","id":"negative-payments","depth":1},{"value":"Matching Criteria","id":"matching-criteria","depth":2},{"value":"Bundling Rules","id":"bundling-rules","depth":2},{"value":"Unmatched Negative Payments","id":"unmatched-negative-payments","depth":2},{"value":"Example Scenarios","id":"example-scenarios","depth":2},{"value":"✅ Successful Match","id":"-successful-match","depth":3},{"value":"❌ No Match — Currency Mismatch (Swedish Postgiro)","id":"-no-match--currency-mismatch-swedish-postgiro","depth":3},{"value":"❌ No Match — SCOR Type Mismatch","id":"-no-match--scor-type-mismatch","depth":3}],"frontmatter":{"seo":{"title":"Negative Payments"}},"lastModified":"2026-08-17T10:37:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/banking/v4/guides/negative-payments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}