Exchanging Files with Electrum

All file exchanges with Electrum occur via a dedicated AWS S3 bucket. This directory has the following file structure:

[CORPORATE_CLIENT]
   [SERVICE]
      Mark-offs
         [YYYY-MM-DD]
            [File]
            [File]
            Processed
               [File]
       Reports       
          [YYYY-MM-DD]
             [File]
             [File]

• The main parent directory will indicate your name or identifier as a corporate client of the sponsor bank - this value will be agreed on between you and Electrum during your onboarding process.  
• The value of the SERVICE directory will be PAYSHAP - alternative values will become available as the EPC solution supports more payment streams.  
• There are separate subdirectories for you to upload or download mark-off files, and where you can obtain recon report files supplied by Electrum, respectively.

Transferring Your Mark-Off File to Electrum

A daily transaction processing window between Electrum and each corporate client starts at 00h00 and ends at 23h59. All transactions with transaction origination time stamps (originalMessageIdentifiers.creationDateTime) that fall within this window should be grouped together for reconciliation purposes.

After all transactions for a particular day have been processed, your system needs to generate a file that includes all the records. This file should be generated according to the file specification defined here.

Upload your mark-off file to the Mark-offs folder for the relevant processing day in your dedicated AWS S3 directory.

Selecting the Correct YYYY-MM-DD Folder

For both mark-offs and reports, the YYYY-MM-DD folder contains files with transaction records for the date indicated by the folder name, irrespective of when each file itself was generated or uploaded.

For example, if a transaction was initiated and processed on 2024-01-23 at 23h30, and the mark-off file containing that transaction is generated on 2024-01-24 at 00h30, then the mark-off file should be uploaded to the 2024-01-23 bucket, and not to the 2024-01-24 bucket.

When to Upload Your File

For a processing window that ends at 23h59 on a given day, you should upload your mark-off file by no later than 04h00 the following day; that is, a mark-off file for a processing window should be provided to Electrum within an hour of that processing window closing.

Uploading Multiple Files

It is common for a corporate client to generate a single mark-off file containing all of their transactions for a given service (e.g., PayShap) for a particular day. However, you may also provide your transactions via multiple mark-off files. In this case:

• Please refer to the file specification provided by Electrum to understand how to indicate multiple files uploaded.
• Note that all mark-off files that you supply for a particular day need to be uploaded to the same YYYY-MM-DD location.

The Processed Folder

Electrum's Back Office system will automatically retrieve your uploaded mark-off file or files for reconciliation processing. Once an individual mark-off file has been consumed by Electrum's Back Office, it will be removed from the original YYYY-MM-DD location and will be placed in the Processed subfolder.

This means that you can, at any time after uploading a mark-off file, verify whether it has been retrieved and processed by Electrum.

• If your file is still located in the original YYYY-MM-DD folder, then Electrum has not yet retrieved it.
• If your file has been moved into the Processed subfolder, then Electrum has successfully consumed your file for reconciliation processing.

Retrieving Reports Supplied by Electrum

After you have uploaded your mark-off file for a completed processing window, Electrum's Back Office engine performs reconciliation between your transaction records and those from the Electrum EPC engine.

Locate and download your recon reports from the Reports folder for the relevant processing day in your dedicated AWS S3 directory.

When Your Reports Will Be Available

For a processing window that ends at 23h59 on a given day, if your mark-off file has been uploaded before 04h00 the following day, the reconciliation reports generated by Electrum should be available in the relevant folder in your S3 bucket by no later than 08h00.

Receiving Transaction Extracts Supplied by Electrum

If you have opted to receive mark-off (extract) files from Electrum instead of making use of Electrum’s full recon capability, you can locate and download daily mark-off files from the Mark-offs folder for the relevant processing day in your dedicated AWS S3 directory.

When Your Reports Will Be Available

For a processing window that ends at 23h59 on a given day, the mark-off files generated by Electrum should be available in the relevant folder in your S3 bucket by no later than 08h00.