{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/directdebit/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"SFTP Onboarding - Monato Direct Debit","siteUrl":"https://docs.monato.com","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":"sftp-onboarding","__idx":0},"children":["SFTP Onboarding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow these steps to submit your first batch of charges via the Monato SFTP integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-get-your-sftp-credentials","__idx":1},"children":["Step 1: Get Your SFTP Credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SFTP credentials and connection details are provided by the Monato team at contract signing. Your credentials include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host"]}," — the SFTP server address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username"]}," — your organisation's SFTP username"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Password or SSH key"]}," — depending on the authentication method configured for your account"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact the Monato team if you have not received your credentials."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-prepare-the-charge-request-file","__idx":2},"children":["Step 2: Prepare the Charge Request File"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prepare a CSV file following the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/directdebit/content/reference/batch-file-spec"},"children":["Batch Files Column Specification"]},". Each row represents a single charge."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"File Naming Rules"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The file name must not contain special characters or spaces. Allowed characters are letters (upper or lowercase), numbers, hyphens (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-"]},"), and underscores (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["charges_20251120_group_1.csv"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.google.com/spreadsheets/d/1HsgJg3sRcUpftfDUPDF3hpY2NLLuB7lCL3JsK-bpgyQ/"},"children":["Charges Request File Layout"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.google.com/spreadsheets/d/1WwhpzbE8c9eQcgXW8N-jO6pJuMPawsMxeKvBSwpVEOs"},"children":["Charges Request File Example"]}," to get started."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-upload-the-file","__idx":3},"children":["Step 3: Upload the File"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect to the Monato SFTP server using your credentials and upload the file to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in"]}]}," folder."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-pre-validation-response","__idx":4},"children":["Step 4: Pre-validation Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Within ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5 minutes"]}," of upload, the platform publishes a pre-validation response file in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["out"]}]}," folder."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pre-validation-passed","__idx":5},"children":["Pre-validation passed"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{original_file_name}_pre_validation_ok_{uuid}.csv\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["File content: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FILE_SCHEDULED_FOR_PROCESSING"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The file has been accepted and is queued for processing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pre-validation-failed","__idx":6},"children":["Pre-validation failed"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{original_file_name}_pre_validation_nok_{uuid}.csv\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["File content: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_ABLE_TO_PROCESS_FILE"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The file could not be accepted — check the file name, format, and structure against the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/directdebit/content/reference/batch-file-spec"},"children":["column specification"]}," and re-upload."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5-input-validation","__idx":7},"children":["Step 5: Input Validation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If pre-validation passes, the platform runs input validation on the file contents within ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2 minutes"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validation-errors-found","__idx":8},"children":["Validation errors found"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{original_file_name}_process_nok_{uuid}.csv\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This file contains all rows from the original request file plus an additional column with the validation error for each failing row. Correct the errors and re-upload the file."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.google.com/spreadsheets/d/15Jt0jGLNfmFMeXFu-ddMru1RJkqRDlER77T85QumdYs"},"children":["See Validation Response File Example"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validation-passed","__idx":9},"children":["Validation passed"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{original_file_name}_process_ok_{uuid}.csv\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All charges have passed validation and have been submitted to the banking network for processing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-6-charge-responses","__idx":10},"children":["Step 6: Charge Responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["next business day"]},", the platform publishes a charges response file in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["out"]}]}," folder:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"responses_{yyyyMMdd}_{uuid}.csv\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This file contains a row for every charge that received a response from the banking network on that date, including risk and penny validation errors."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.google.com/spreadsheets/d/1dowdDTs0di2283TaaQCZUJNnDWsBssXYq3nfqAA4J0s"},"children":["See Charges Response File Example"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["result"]}," column will contain one of the following values:"]},{"$$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":"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":["confirmed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The charge was successfully collected"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["declined"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The charge was not collected — see the error code column for the reason"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The charge was canceled before processing"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full list of error codes that may appear in response files, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/directdebit/content/reference/error-codes"},"children":["Error Codes"]},"."]}]},"headings":[{"value":"SFTP Onboarding","id":"sftp-onboarding","depth":1},{"value":"Step 1: Get Your SFTP Credentials","id":"step-1-get-your-sftp-credentials","depth":2},{"value":"Step 2: Prepare the Charge Request File","id":"step-2-prepare-the-charge-request-file","depth":2},{"value":"Step 3: Upload the File","id":"step-3-upload-the-file","depth":2},{"value":"Step 4: Pre-validation Response","id":"step-4-pre-validation-response","depth":2},{"value":"Pre-validation passed","id":"pre-validation-passed","depth":3},{"value":"Pre-validation failed","id":"pre-validation-failed","depth":3},{"value":"Step 5: Input Validation","id":"step-5-input-validation","depth":2},{"value":"Validation errors found","id":"validation-errors-found","depth":3},{"value":"Validation passed","id":"validation-passed","depth":3},{"value":"Step 6: Charge Responses","id":"step-6-charge-responses","depth":2}],"frontmatter":{"seo":{"title":"SFTP Onboarding - Monato Direct Debit"}},"lastModified":"2026-07-03T21:00:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/directdebit/content/guides/sftp/onboarding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}