Upload a payment file

In addition to the API and manual payment order creation in the dashboard, Numeral enables you to create payment orders by uploading a payment file in the dashboard. To upload a payment file, go to Payments > Payment orders > Upload payment file.

Uploading a payment file

By default, the payment file upload feature supports two formats:

  • Standard PAIN.001 XML files
  • Numeral CSV template

If you you have a custom file format that you would like to use, please contact us at [email protected].

After you upload a payment file, the corresponding payment orders will be created asynchronously. You can close or refresh the page. After they have been created, payment orders will be visible on the Payment orders page.

Processing time

Number paymentsProcessing time
Up to 1,000<60 seconds
Up to 10,000~5 minutes
Up to 25,000~25 minutes

Numeral CSV template

ColumnDescriptionAuthorised valuesMandatory
idThe ID of the payment. If filled, Numeral will check for duplicates before creating the payment
typeThe type of the paymentsepa only:white-check-mark:
directionThe direction of the payment- credit
- debit
:white-check-mark:
amountThe amount of the payment, with decimalsAmount, with decimals:white-check-mark:
currencyThe currency of the paymentISO 4217 currency codes, e.g. EUR or GBP:white-check-mark:
referenceThe message that will appear on the origin and destination account statements, with a maximum of 140 characters String, up to 140 characters:white-check-mark:
destination_holder_nameThe account holder name of the destination account:white-check-mark:
destination_account_numberThe account number of the destination accountIBAN format:white-check-mark:
destination_bank_codeThe bank code of the destination accountSwift code format:white-check-mark:
destination_countryThe country of the destination accountISO 3166 country codes:white-check-mark:
destination_city
destination_building_number
destination_street_name
destination_zip_code
direct_debit_mandate_type
direct_debit_mandate_sequence
direct_debit_mandate_signature_date