{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml","oas-openapi/api.yaml":"oas-openapi/api.yaml"},"props":{"metadata":{"markdoc":{"tagList":["json-schema","openapi-code-sample"]},"type":"markdown"},"seo":{"title":"4. Deposits","description":"Fondo is the ground breaking open finance platform that lets you focus on what matters","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"4-deposits","__idx":0},"children":["4. Deposits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before placing orders the account needs funds. There are two ways to deposit money into an account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bankgiro-transfer","__idx":1},"children":["Bankgiro transfer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The customer makes a standard bank transfer to Fondo's bankgiro number using the account's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ref"]}," field as the OCR reference. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ref"]}," is returned when the account is created and is available on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/openapi/api/account/getaccounts"},"children":["account object"]},"."]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../../openapi/models/account/account.yaml#/properties/ref"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/ref"},"ref":{"type":"string","maxLength":128,"description":"ref is a unique account number, based on\nepoch, length and Luhn. OCR length digit compliant.\n","example":"160367146695159"}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"swish","__idx":2},"children":["Swish"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Swish lets the customer pay directly from the Swish app. There are two flows:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Same device"]}," — the customer is on a mobile device; Swish opens directly via its app-switch token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["QR code"]}," — the customer is on a desktop; you display a QR code they scan with the Swish app."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-swish-deposit-session","__idx":3},"children":["Create a Swish deposit session"]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-openapi/api.yaml","operationId":"createSwishDeposit","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"request-schema","__idx":4},"children":["Request schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../../openapi/models/swish/deposit_swish.yaml"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/deposit_swish"},"deposit_swish":{"$id":"/models/swish/deposit_swish.yaml","type":"object","discriminator":{"propertyName":"type"},"oneOf":[{"title":"SwishDepositQr","type":"object","required":["type","amount","qrFormat"],"properties":{"type":{"type":"string","enum":["qr"],"description":"type of swish signature"},"clientRef":{"type":"string","description":"Client reference for tracking the payment"},"amount":{"type":"number","description":"Amount"},"qrFormat":{"type":"object","required":["format"],"description":"qr format in accordance to to swish Mcom to Qcom qr v1 https://developer.swish.nu/api/qr-codes/v1","properties":{"format":{"type":"string","enum":["jpg","svg","png"]},"size":{"type":"number","description":"Size of the QR code. The code is a square, so width and height are the same. Not required if the format is svg."},"border":{"type":"number","description":"Width of the border."},"transparent":{"type":"boolean","description":"Transparent background color. Does not work with jpg format."}}}}},{"title":"SwishDepositSameDevice","type":"object","required":["type","amount"],"properties":{"type":{"type":"string","enum":["same_device"],"description":"type of swish signature"},"clientRef":{"type":"string","description":"Client reference for tracking the payment"},"amount":{"type":"number","description":"Amount"}}}]}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"poll-for-payment-status","__idx":5},"children":["Poll for payment status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After creating the Swish session, poll for the result:"]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-openapi/api.yaml","operationId":"pollSwishDeposit","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response-schema","__idx":6},"children":["Response schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../../openapi/models/swish/swish_poll_response.yaml"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/swish_poll_response"},"swish_poll_response":{"$id":"/models/swish/swish_poll_response.yaml","type":"object","properties":{"status":{"type":"string","description":"status from Swish","example":"PAID"},"errorCode":{"type":["string","null"],"description":"error code from Swish","example":"AM02"}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next:"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/api-guide/getting-started/autogiro-payments"},"children":["Autogiro deposits"]}]}]},"headings":[{"value":"4. Deposits","id":"4-deposits","depth":1},{"value":"Bankgiro transfer","id":"bankgiro-transfer","depth":2},{"value":"Swish","id":"swish","depth":2},{"value":"Create a Swish deposit session","id":"create-a-swish-deposit-session","depth":3},{"value":"Request schema","id":"request-schema","depth":4},{"value":"Poll for payment status","id":"poll-for-payment-status","depth":3},{"value":"Response schema","id":"response-schema","depth":4}],"frontmatter":{"seo":{"title":"4. Deposits"}},"lastModified":"2026-04-14T12:45:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/api-guide/getting-started/deposits","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}