{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Getting Started: Bulk Payments via SFTP","description":"Secure, RESTful access to Bermuda Commercial Bank's financial services. Built for developers integrating account data, transfers, and more.","keywords":["Bermuda Commercial Bank","BCB API","Open Banking","Financial API","Banking API","Developer Portal"],"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":"getting-started-bulk-payments-via-sftp","__idx":0},"children":["Getting Started: Bulk Payments via SFTP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page describes the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["customer journey"]}," from credential handover through your first connection. It is tool-agnostic: you may use any desktop SFTP client, command-line SFTP, treasury system, or managed file transfer (MFT) product that supports SFTP and SSH key authentication."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For file formats, folder layout, processing behaviour, and sample ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]}," files, continue with ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/bulk-payments-sftp"},"children":["Bulk Payments via SFTP"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-are-setting-up","__idx":1},"children":["What you are setting up"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You will use SFTP to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["submit batches of multiple payment instructions"]}," in ISO 20022 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]}]}," files. Each file can contain many payments; you can also submit ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["multiple files over time"]}," as your operational schedule requires. Results and reconciliation artefacts are returned on the same SFTP endpoint (see the technical guide for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/input"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/archive"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-bcb-provides","__idx":2},"children":["What BCB provides"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After onboarding, BCB supplies:"]},{"$$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":"Item"},"children":["Item"]},{"$$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":"strong","attributes":{},"children":["SFTP host"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The server hostname or URL you connect to (environment-specific; UAT details are in the technical guide)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A unique provisioned username for your organisation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Private key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An SSH private key file used instead of a password. BCB holds the matching public key on the server side."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may receive these out of band (for example by secure email, your relationship manager, or an agreed key-exchange process). ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treat the private key like a secret:"]}," restrict who can read it, do not share it in chat or ticketing systems, and do not commit it to source control."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recommended-journey","__idx":3},"children":["Recommended journey"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secure the credentials"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Store the private key in a location only authorised staff and systems can access. If you use automation, use a secrets store or HSM pattern your organisation already approves."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a connection profile in your SFTP software"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"In your chosen tool, create a new SFTP (SSH File Transfer Protocol) connection and enter:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Protocol:"]}," SFTP (not FTP)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host:"]}," the hostname BCB gave you."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Port:"]}," typically ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["22"]}," unless BCB specifies otherwise."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username:"]}," your provisioned username."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," SSH private key (select the key file BCB provided).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Some applications require the key in a particular format (for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".ppk"]}," on Windows); convert only using trusted tooling if needed."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect and verify the workspace"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"After a successful login, you should see your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["client-isolated"]}," directory tree, including folders such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/input"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/archive"]},". If anything is missing or you cannot authenticate, contact BCB support with the error message from your client (not the key material)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read the technical guide and test"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/bulk-payments-sftp"},"children":["Bulk Payments via SFTP"]}," to learn where to drop files, how processing and statuses work, and to download ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sample ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]}," files"]}," for UAT. Build or export your production ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]}," according to that specification before go-live."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"after-you-are-connected","__idx":4},"children":["After you are connected"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload completed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]}," files to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/input"]}]}," only, unless BCB instructs otherwise."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Poll or monitor ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]}]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.002"]}," and reconciliation files (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["camt.053"]},") as described in the technical guide."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For API status polling or optional webhooks (if enabled for your tenancy), see the technical guide’s status section."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support","__idx":5},"children":["Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For onboarding and integration support, contact ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:api@bcb.bm"},"children":["api@bcb.bm"]},"."]}]},"headings":[{"value":"Getting Started: Bulk Payments via SFTP","id":"getting-started-bulk-payments-via-sftp","depth":1},{"value":"What you are setting up","id":"what-you-are-setting-up","depth":2},{"value":"What BCB provides","id":"what-bcb-provides","depth":2},{"value":"Recommended journey","id":"recommended-journey","depth":2},{"value":"After you are connected","id":"after-you-are-connected","depth":2},{"value":"Support","id":"support","depth":2}],"frontmatter":{"seo":{"title":"Getting Started: Bulk Payments via SFTP"}},"lastModified":"2026-04-23T11:55:14.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/bulk-payments-sftp-getting-started","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}