{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml","oas-openapi/api.yaml":"oas-openapi/api.yaml"},"props":{"metadata":{"markdoc":{"tagList":["openapi-code-sample","json-schema"]},"type":"markdown"},"seo":{"title":"5. Autogiro 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":"5-autogiro-deposits","__idx":0},"children":["5. Autogiro Deposits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Autogiro lets you pull deposits from the customer's bank account into their Fondo account. It is used in two ways:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allocation plans"]}," — Rules for distributing an account's cash balance across funds by percentage (e.g., \"allocate 60% to fund X, 40% to fund Y\")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Savings plans"]}," — Recurring withdrawals from a payment account, investing fixed amounts into specified funds (e.g., \"withdraw 5000 SEK monthly and buy fund X\")."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-sign-the-autogiro-mandate","__idx":1},"children":["Step 1: Sign the autogiro mandate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are multiple ways to create an autogiro mandate:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createAccount"]}," journey when setting up an allocation plan — you provide the autogiro bank account when initializing the journey."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updateAllocationPlan"]}," journey — you provide the autogiro bank account when initializing the journey."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addBankAccount"]}," journey — the customer selects a bank account to connect, including a 3rd-party account verification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createAccount"]}," journey when setting up a savings plan."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-create-a-payment-instruction-only-for-allocation-plan","__idx":2},"children":["Step 2: Create a payment instruction (only for allocation plan)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the mandate is active, trigger autogiro deposits by creating a payment instruction. You can batch multiple payments (to different accounts) in a single instruction."]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-openapi/api.yaml","operationId":"createPaymentInstruction","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The instruction progresses through: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["new"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["executing"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processed"]},". The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clientRef"]}," you provide is copied to the resulting cash transactions for reconciliation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-instruction-schema","__idx":3},"children":["Payment instruction schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../../openapi/models/payment/post_payment_instruction.yaml"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/post_payment_instruction"},"uuid":{"$id":"/models/uuid.yaml","title":"UUID","type":"string","example":"49ad7378-121c-4a53-9894-dfd14a7b4877","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"post_payment_instruction":{"$id":"/models/payment/post_payment_instruction.yaml","type":"object","required":["payments","type"],"additionalProperties":false,"properties":{"type":{"description":"The type of payment","enum":["autogiro"]},"payments":{"description":"Array of payment instructions","type":"array","items":{"type":"object","required":["amount","account","clientRef"],"properties":{"amount":{"description":"The amount of the payment","type":"number","example":110},"account":{"$ref":"#/components/schemas/uuid"},"clientRef":{"description":"Client specified reference for keeping track of payment.\nValue is copied to the `clientRef` of transactions\n","example":"instruction_id_29384","type":"string"}}}}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"track-payments","__idx":4},"children":["Track payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the status of individual payments within an instruction:"]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-openapi/api.yaml","operationId":"getInstructionPayment","parameters":{},"environments":{}},"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/place-order"},"children":["Place an order"]}]}]},"headings":[{"value":"5. Autogiro Deposits","id":"5-autogiro-deposits","depth":1},{"value":"Step 1: Sign the autogiro mandate","id":"step-1-sign-the-autogiro-mandate","depth":2},{"value":"Step 2: Create a payment instruction (only for allocation plan)","id":"step-2-create-a-payment-instruction-only-for-allocation-plan","depth":2},{"value":"Payment instruction schema","id":"payment-instruction-schema","depth":3},{"value":"Track payments","id":"track-payments","depth":2}],"frontmatter":{"seo":{"title":"5. Autogiro Deposits"}},"lastModified":"2026-04-14T12:45:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/api-guide/getting-started/autogiro-payments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}