Withdrawal batch function

Freemarket’s batch payments functionality allows businesses to upload a single file and make multiple payments across a range of currencies & payment types at no additional cost.

Freemarket’s clients need to be able to make multiple payments:

  • Quickly; saving the time and cost of manually typing or pasting-in payments
  • Efficiently; using a format configurable from their ERP or treasury platform
  • Accurately; minimising the expensive mistakes associated with manual keying

    Key things to know

    • The service can be enabled or disabled based on client needs
    • Any client requiring this functionality should request it through their RM
    • Clients can send multiple currencies in the same batch
    • The payments included in this file will be treated as individual payments and will be debited as such. For example, a file which has 15 USD and 12 CAD payments will see 15 debits on their USD account and 12 debits on their CAD account
    • Clients submit a .CSV file containing the payments data into the Freemarket web portal
    • Note that API channel cannot be used to submit files
    • There is a format guide and example (template) import .csv file in the appendix to this guide. Freemarket will enable clients to undertake to test, as needed
    • Files can be of mixed payment types e.g. SWIFT, SEPA, Faster Payments, etc.
    • Each payment instruction will be subject to initial data input validation and checks
    • Any payments which do not pass initial validation (checks on the file format, message content, account numbers, etc.) will be highlighted immediately the file is uploaded
    • The faulty payments at this stage can be corrected or withdrawn from the file and escalated separately; the payments which have been checked and validated will continue through the process
    • Files will be processed throughout the day – there are no specific batch processing times. However, there may be busy times just prior to the cut-offs in some currencies. Clients are encouraged to submit files in good time to achieve the targeted value date
    • The file may include beneficiaries which have not been authorised for single payments in the Freemarket platform
    • All files will therefore be subject to 2-factor authentication
    • If the file includes new beneficiaries, they will be created in the system with unauthorised status. If a subsequent payment is made to those unauthorised beneficiaries in the future using the single (classic) withdrawal method, then the payment needs to be authorised
    • Post batch import, payments in the file will be checked by Freemarket and its partner banks for sanctions, PEPs, Fraud, and in more detail for payment scheme rules and message content, reachability, etc. Payments which are stopped for investigation at those stages will be removed from the file and the remainder of the file will automatically continue for processing

    End-to-end process

    Steps to be followed are outlined below:

    1. Log into FMFX portal with company (corporate) account:

    Batch Payments Process Flow Image 1

    2. Click on the batch tab to access the Batch Account Management screen:

    Batch Payments Process Flow Image 2

    3. Click on the Upload file button to upload the pre-formatted CSV file. Click Continue to proceed.

    Batch Payments Process Flow Image 3

    4. Several validations will take place to check the information is correct: account balance check per currency, beneficiary information check, ultimate originator check, maximum withdrawal amount check to process the file etc. In case of error, the system will display the reason so it can be rectified:

    Please note: the limit for an individual transaction is 250k GBP or currency equivalent. Withdrawals over that limit won’t be supported as they require additional documentation.

    Batch Payments Process Flow Image 4

    At this point, customer can click Continue to proceed with the payments that have passed all validations excluding errored payments. The customer needs to click on the Confirm button to proceed.

    Please note: In case there is not enough funding available in the account to cover all the payments included in the file, the file can still be processed with the payments covered by the available funding.

    Batch Payments Process Flow Image 5

    5. Once the batch file is uploaded and all validations successfully done, an OTP token will be sent to be keyed in on the portal via SMS/Email. The number of transactions of the batch and a unique batch number (identifier) will be displayed:

    Batch Payments Process Flow Image 6

    Strong Customer Authentication is required for this functionality. This means that the user will need to authorise the batch using the Authentication code provided and clicking on ‘Confirm’:

    Batch Payments Process Flow Image 7

    If new beneficiaries are included in the batch file, the system will create them with ‘unauthorised’ status. These ‘unauthorised’ beneficiaries will not become authorised beneficiaries for future payments so the payments will need an authorisation.

    If the account is enabled for the approval workflow, then withdrawals will need to be approved by the other account user(s). An email will be sent automatically to request authorisation:

    Batch Payments Process Flow Image 8

    A new Transaction Type (Withdrawal batch) has been created to allow filtering:

    Batch Payments Process Flow Image 9
    Batch Payments Process Flow Image 10

    When clicking on ‘View details’, all the payments will be displayed on the approval screen. The entire batch can then be approved or rejected; note that you approve the whole batch together – there is no option to approve the individual withdrawals in the file.

    Batch Payments Process Flow Image 11

    6. Once the Batch is approved, withdrawal batch status will be ‘Pending’ until all the withdrawals are processed by the system:

    Batch Payments Process Flow Image 12

    Withdrawals in Enabled status are ready to be processed by the system;

    Batch Payments Process Flow Image 13

    7. Once all the payments are processed, the Batch status will be updated to ‘Completed’:

    Batch Payments Process Flow Image 14

    8. The whole batch will then become available in Completed Transactions

    Batch Payments Process Flow Image 15

    9. An email will be sent to confirm the Batch has been processed:

    Batch Payments Process Flow Image 16

    Appendix

    1.0 Format Guide

    Field No.
    Field Name
    Format
    Mandatory Y/N
    Comments
    1.
    AccountId
    #####
    Y
    The AccountId can be found in the URL when logged into your account portal.wearefreemarket.com/Customer/#####
    2.
    Amount
    Decimal (separated by dot)
    Y
    i.e.: 100.00
    3.
    CurrencyCode
    3 characters
    Y
    i.e.: GBP
    4.
    Reference
    35 characters
    N
    [^A-Za-z\d\.\-/?:(),+‘ ]
    5.
    Description
    35 characters
    N
    [^A-Za-z\d\.\-/?:(),+‘ ]
    6.
    PaymentPurposeCode (Reason for payment)
    Text
    Y
    Payment purpose codes (reason for payment)
    7.
    BeneficiaryType
    Text
    Y
  • Individual
  • Company
  • 8.
    PaymentRoutingAccountHolderName
    Text
    Y
    9.
    PaymentRoutingCountryCode
    ISO 3166-1 Alpha-2 country code
    Y
    i.e.: GB
    10.
    PaymentRoutingType
    Text
    Y

    Please use the correct Payment routing type for the Payment routing country

  • SortCodeAccountNumber [for GB]
  • RoutingTransitNumberAccountNumber [for US]
  • BankStateBranchAccountNumber [for AU]
  • NewZealandAccountNumber [for NZ]
  • TransitNumberAccountNumber [for CA]
  • IndianFinancialSystemCodeAccountNumber [for IN]
  • BicIban [where IBAN account numbering standard is implemented]
  • BicNuban [for NG]
  • BicClabe [for MX]
  • BicAccountNumber [other countries not specified above]
  • 11.
    PaymentRoutingBic
    text – alphanum.
    Y/N

    *Not required if the following payment routing types are specified in field 10:

  • SortCodeAccountNumber,
  • RoutingTransitNumberAccountNumber,
  • TransitNumberAccountNumber
  • 12.
    PaymentRoutingNationalBranchCode
    text – alphanum.
    Y/N

    *Mandatory if the following payment routing types are specified in field 10:

  • SortCodeAccountNumber – please provide Sort code
  • RoutingTransitNumberAccountNumber – please provide ABA Routing transit number
  • BankStateBranchAccountNumber – please provide Bank state branch number
  • TransitNumberAccountNumber – please provide Transit number
  • IndianFinancialSystemCodeAccountNumber – please provide Indian Financial System Code
  • 13.
    PaymentRoutingAccountNumber
    text – alphanum.
    Y
    14.
    IntermediaryRoutingBic
    text – alphanum.
    N
    15.
    AlternatePaymentRoutingType
    Text
    N
    * Mandatory if SortCodeAccountNumber option is used in 10
    16.
    AlternatePaymentRoutingBic
    text – alphanum.
    N
    17.
    AlternatePaymentRoutingNationalBranchCode
    text – alphanum.
    N
    * Mandatory if SortCodeAccountNumber option is used in 10
    18.
    AlternatePaymentRoutingAccountNumber
    text – alphanum.
    N
    * Mandatory if SortCodeAccountNumber option is used in 10
    19.
    AddressCountryCode
    ISO 3166-1 Alpha-2 country code
    Y
    i.e.: GB
    20.
    AddressTown
    Text
    Y
    21.
    AddressDistrict
    Text
    N
    22.
    AddressStreet
    Text
    Y
    23.
    AddressHouseNumber
    Text
    N
    24.
    AddressPostCode
    Text
    Y/N
    Optional in countries where post code is not supported
    25.
    UltimateOriginatorName
    Text
    Y/N
    *It is mandatory for the accounts where 3rd party withdrawals are allowed.
    Full name if the UO is an individual, or the full company name if the UO is a company
    26.
    UltimateOriginatorAddressCountryCode
    Text
    Y/N
    *It is mandatory for the accounts where 3rd party withdrawals are allowed
    27.
    UltimateOriginatorAddressTown
    Text
    Y/N
    *It is mandatory for the accounts where 3rd party withdrawals are allowed
    28.
    UltimateOriginatorAddressDistrict
    Text
    N
    29.
    UltimateOriginatorAddressStreet
    Text
    Y/N
    *It is mandatory for the accounts where 3rd party withdrawals are allowed
    30.
    UltimateOriginatorAddressHouseNumber
    Text
    N
    31.
    UltimateOriginatorAddressPostCode
    Text
    Y/N
    Mandatory in countries where post code is supported and for the accounts where 3rd party withdrawals are allowed
    32.
    PaymentChargesCode
    Text
    N
    *Only for accounts with Payment Charges selection enabled
    • SHA (you will pay the Freemarket fee for the withdrawal, the beneficiary will incur charges raised by other banks handling the payment)
    • OUR (you will pay the Freemarket fee for the withdrawal, plus a fee which covers charges raised by other banks handling the payment)

    Note: Comma is not allowed on the provided CSV as it will cause an error.

    Important: All mandatory fields need to be populated and field format adhered to in order for the file to be processed with no errors. Non-mandatory fields will need to remain blank.

    ImportFile example:

    Payment Purpose Codes example: