{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"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":"bulk-payments-via-sftp","__idx":0},"children":["Bulk Payments via SFTP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use BCB SFTP to submit high-volume payment files in a secure, structured way."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New to this channel?"]}," Start with ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/bulk-payments-sftp-getting-started"},"children":["Getting Started: Bulk Payments via SFTP"]}," for the end-to-end customer journey (credentials, configuring your SFTP client, and what to do before you upload files)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-overview","__idx":1},"children":["1. Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bulk Payments"]}," service allows clients to submit multiple payment instructions in a single ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ISO 20022 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]}]}," file."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["BCB provisions dedicated SFTP credentials (a unique username and SSH key) and a client-isolated remote directory for each client."," ","Clients connect using their preferred SFTP tool or treasury platform and upload files to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/input"]},"."]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"sequenceDiagram\n participant customer as Customer\n participant bcbSftp as BCB_SFTP\n participant bulkEngine as Bulk_Payments_Engine\n participant cbalT24 as CBAL_T24\n\n customer->>bcbSftp: Upload pain.001 to /input\n bcbSftp->>bulkEngine: New file detected\n bulkEngine->>bulkEngine: Validate format and duplicate checks\n bulkEngine->>bulkEngine: Create batch record and archive original\n loop Per payment instruction\n bulkEngine->>cbalT24: Submit individual payment\n cbalT24-->>bulkEngine: Status or result\n end\n bulkEngine->>bcbSftp: Write pain.002 output artifact\n bulkEngine->>bcbSftp: Write daily camt.053 reconciliation\n bulkEngine->>bcbSftp: Move final artifacts to /output\n","diagramHtml":"
CBAL_T24Bulk_Payments_EngineBCB_SFTPCustomerCBAL_T24Bulk_Payments_EngineBCB_SFTPCustomerloop[Per payment instruction]Upload pain.001 to /inputNew file detectedValidate format and duplicate checksCreate batch record and archive originalSubmit individual paymentStatus or resultWrite pain.002 output artifactWrite daily camt.053 reconciliationMove final artifacts to /output
"},"children":["sequenceDiagram\n participant customer as Customer\n participant bcbSftp as BCB_SFTP\n participant bulkEngine as Bulk_Payments_Engine\n participant cbalT24 as CBAL_T24\n\n customer->>bcbSftp: Upload pain.001 to /input\n bcbSftp->>bulkEngine: New file detected\n bulkEngine->>bulkEngine: Validate format and duplicate checks\n bulkEngine->>bulkEngine: Create batch record and archive original\n loop Per payment instruction\n bulkEngine->>cbalT24: Submit individual payment\n cbalT24-->>bulkEngine: Status or result\n end\n bulkEngine->>bcbSftp: Write pain.002 output artifact\n bulkEngine->>bcbSftp: Write daily camt.053 reconciliation\n bulkEngine->>bcbSftp: Move final artifacts to /output\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-payment-rail-support","__idx":2},"children":["2. Payment Rail Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The current Bulk Payments scope supports:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SWIFT payments, using ISO 20022 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Local ACH (Automated Clearing House) payment files."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-sftp-connectivity-uat","__idx":3},"children":["3. SFTP Connectivity (UAT)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following connection details:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stbcbpaymentstest.blob.core.windows.net"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Port:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["22"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username:"]}," Provisioned per client (for example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stbcbpaymentstest."]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," Client-specific SSH private key"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-openssh-cli","__idx":4},"children":["Example (OpenSSH CLI)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"sftp -i /path/to/private-key @stbcbpaymentstest.blob.core.windows.net\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-connect-using-your-preferred-tool","__idx":5},"children":["4. Connect Using Your Preferred Tool"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can connect using:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any SFTP desktop client"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Command-line SFTP tooling"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasury or payment platforms with SFTP file-drop capability"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Managed file transfer (MFT) solutions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this connection profile:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Protocol:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SFTP"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stbcbpaymentstest.blob.core.windows.net"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Port:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["22"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Username:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[""]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," Provisioned SSH private key"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"key-format-notes","__idx":6},"children":["Key format notes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["OpenSSH private keys are commonly used."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Some tools may require key conversion into a tool-specific format."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the connection profile for repeat batch submissions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"5-directory-structure","__idx":7},"children":["5. Directory Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each client receives a dedicated SFTP directory with the following folders:"]},{"$$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":"Folder"},"children":["Folder"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/input"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Client drops ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]}," files here."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Final batch artifacts are placed here once processing completes (successful or not). ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.002"]}," and end-of-day ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["camt.053"]}," outputs are delivered here."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/archive"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Original submitted files are archived after ingestion."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"6-processing-lifecycle","__idx":8},"children":["6. Processing Lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001"]}," file is uploaded to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/input"]},", the platform:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Detects the new file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validates file format and performs duplicate detection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creates a batch record."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Archives the original file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Processes each payment instruction independently through existing payment controls."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Publishes completion artifacts to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Important behavior:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Batch processing is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["non-atomic"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Individual payments can succeed or fail independently."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["External client flow is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/input"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]}]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Output handling is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["batch-oriented"]},"; individual transaction completion files are written per batch into a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.002"]}," file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["End-of-day reconciliation file ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["camt053-YYYY-MM-DD.xml"]}," is delivered to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"7-status-and-reconciliation","__idx":9},"children":["7. Status and Reconciliation"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"illustrative-batch-statuses","__idx":10},"children":["Illustrative batch statuses"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECEIVED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IN_PROGRESS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUBMITTED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COMPLETED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PARTIALLY_FAILED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"result-delivery-channels","__idx":11},"children":["Result delivery channels"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SFTP output files"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API status polling endpoint"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional webhook notifications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["End-of-day reconciliation file (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["camt053-YYYY-MM-DD.xml"]},") in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"8-output-and-archive-artifacts","__idx":12},"children":["8. Output and Archive Artifacts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These examples define typical output and archive patterns."]},{"$$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":"Folder"},"children":["Folder"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example filename"},"children":["Example filename"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT-BATCH-B-001_pain002.xml"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Batch and transaction-level status summary file in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.002"]}," XML format."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/output"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{Tenant}-{Id}-YYYYMMDD_camt053.xml"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["End-of-day account and reporting file."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/archive"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001.001.03.bulk.case-b-round-numbers.xml"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Original uploaded input file retained for traceability."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"9-status-definitions-and-client-actions","__idx":13},"children":["9. Status Definitions and Client Actions"]},{"$$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":"Batch status"},"children":["Batch status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it means"},"children":["What it means"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Client action"},"children":["Client action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECEIVED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File has been accepted for intake."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait for validation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File structure and core checks passed."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait for processing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IN_PROGRESS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payments are being processed."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monitor status and output; no action needed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUBMITTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Instructions submitted to downstream systems."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Continue monitoring until terminal status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COMPLETED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Batch finished with no known failures."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reconcile totals and archive your local copy."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PARTIALLY_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Some instructions succeeded and some failed."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Download summary and reconciliation outputs, correct failed items, and resubmit as needed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Batch failed validation or processing."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Review error details, correct the file, and resubmit with a new batch or message reference."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"10-sample-files-happy-path","__idx":14},"children":["10. Sample Files (Happy Path)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following sample files are based on the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pain.001.001.03"]}," bulk structure and include different amount distributions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For each file:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NbOfTxs"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CtrlSum"]}," is set to the exact sum of all ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["InstdAmt"]}," 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":"Test case"},"children":["Test case"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"CtrlSum (USD)"},"children":["CtrlSum (USD)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Download"},"children":["Download"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case A - low values"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["50.34"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.case-a-low-value.xml"},"children":["pain.001.001.03.bulk.case-a-low-value.xml"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case B - round numbers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["550.00"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.case-b-round-numbers.xml"},"children":["pain.001.001.03.bulk.case-b-round-numbers.xml"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case C - mixed values"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["605.04"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.case-c-mixed-values.xml"},"children":["pain.001.001.03.bulk.case-c-mixed-values.xml"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case D - high values"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["51234.51"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.case-d-high-value.xml"},"children":["pain.001.001.03.bulk.case-d-high-value.xml"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"11-validation-files-failure-cases","__idx":15},"children":["11. Validation Files (Failure Cases)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These files are intentionally designed to fail specific controls."]},{"$$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":"Failure case"},"children":["Failure case"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Expected behavior"},"children":["Expected behavior"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Download"},"children":["Download"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Duplicate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MsgId"]}," (first submission)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["First submission should process normally."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.fail-duplicate-msgid-first.xml"},"children":["pain.001.001.03.bulk.fail-duplicate-msgid-first.xml"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Duplicate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MsgId"]}," (repeat submission)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Second submission should be flagged as duplicate."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.fail-duplicate-msgid-second.xml"},"children":["pain.001.001.03.bulk.fail-duplicate-msgid-second.xml"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CtrlSum"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validation should fail due to amount total mismatch."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.fail-invalid-ctrlsum.xml"},"children":["pain.001.001.03.bulk.fail-invalid-ctrlsum.xml"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NbOfTxs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validation should fail due to transaction count mismatch."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.fail-invalid-nboftxs.xml"},"children":["pain.001.001.03.bulk.fail-invalid-nboftxs.xml"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid execution date format"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validation should fail due to non-ISO date format."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/sftp-test-files/pain.001.001.03.bulk.fail-invalid-date-format.xml"},"children":["pain.001.001.03.bulk.fail-invalid-date-format.xml"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"12-security-and-controls","__idx":16},"children":["12. Security and Controls"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Client-isolated SFTP directories"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Secure file handling and storage"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No cross-client data visibility"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["End-to-end auditability of batch lifecycle and payment transitions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Observability through operational metrics and dashboards"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"13-support","__idx":17},"children":["13. Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For onboarding and integration support, contact:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email:"]}," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:api@bcb.bm"},"children":["api@bcb.bm"]}]}]}]},"headings":[{"value":"Bulk Payments via SFTP","id":"bulk-payments-via-sftp","depth":1},{"value":"1. Overview","id":"1-overview","depth":2},{"value":"2. Payment Rail Support","id":"2-payment-rail-support","depth":2},{"value":"3. SFTP Connectivity (UAT)","id":"3-sftp-connectivity-uat","depth":2},{"value":"Example (OpenSSH CLI)","id":"example-openssh-cli","depth":3},{"value":"4. Connect Using Your Preferred Tool","id":"4-connect-using-your-preferred-tool","depth":2},{"value":"Key format notes","id":"key-format-notes","depth":3},{"value":"5. Directory Structure","id":"5-directory-structure","depth":2},{"value":"6. Processing Lifecycle","id":"6-processing-lifecycle","depth":2},{"value":"7. Status and Reconciliation","id":"7-status-and-reconciliation","depth":2},{"value":"Illustrative batch statuses","id":"illustrative-batch-statuses","depth":3},{"value":"Result delivery channels","id":"result-delivery-channels","depth":3},{"value":"8. Output and Archive Artifacts","id":"8-output-and-archive-artifacts","depth":2},{"value":"9. Status Definitions and Client Actions","id":"9-status-definitions-and-client-actions","depth":2},{"value":"10. Sample Files (Happy Path)","id":"10-sample-files-happy-path","depth":2},{"value":"11. Validation Files (Failure Cases)","id":"11-validation-files-failure-cases","depth":2},{"value":"12. Security and Controls","id":"12-security-and-controls","depth":2},{"value":"13. Support","id":"13-support","depth":2}],"frontmatter":{"seo":{"title":"Bulk Payments via SFTP"}},"lastModified":"2026-04-23T11:55:14.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/bulk-payments-sftp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}