Buckaroo Support - EN

File upload

You can submit transactions in a variety of ways. The first option is by using various gateways: JSON, HTML, NVP & SOAP. The second option is to submit transactions via batch.

By using the Upload file feature, you can execute multiple transactions simultaneously. In doing so, please ensure that there is no customer interaction, which means an iDEAL payment is not possible.

File upload via the Plaza

If an account has the appropriate privilege settings, you can upload a file by following the steps below.

  1. Click on Services > Submit file.
  2. In the top right corner, click on Actions > Upload new batch.
  3. Place your file (.CSV) in the file drop screen and select the correct settings on the right.
  4. Click on Submit file and wait for approval.
  • Submit file as a test: If you wish to run a compliance test
  • Is Refund batch: Check this box if you’re dealing with a file that includes refunds
  • Select a website: Select one of your website keys, unless this is already included in the .csv file.

If a file is submitted succesfully, the applicant will receive an email containing an approval code. This code must be entered to process the file/transaction correctly.


If an error has occurred while uploading the file, the status will change to Batch has failed. There can be various reasons for the batch fail. For example because a specific value is missing or is incorrect. Below you’ll find some suggestions for the processing of the file.

  • The currency is usually euro, the value is EUR. For the American dollar, this is USD.
  • You can find the Website key of a website via My Buckaroo > Websites.
  • With regard to Amount, make sure the figures are seperated with a decimal point instead of a comma.
  • Culture refers to the language used. Read more about it here.
  • The file has to be submitted in .csv format, not in .xls or other format.
  • For certain keys (such as gender, service and action), there are a number of specific values. For more information, contact our development portal.
  • You can never submit the exact same file more than once: if you’re testing something or if an error occurs and you want to submit the file again, make sure the title and/or content are not be identical to the file submitted previously. If you do submit a file that is identical, you will receive an error message.

If everything is processed correctly, the status will change to Batch waiting for approval. After the uploading/processing, the (logged in) user will receive an email containing a confirmation code. By clicking on the batch, a pop-up screen will appear where you can enter this code.

Batch features

Click on the specific batch for batch details. You’ll find more information in the Details column.

  • Submitted: Time and date the file was submitted
  • Number of lines: Number of lines in the csv used for the batch
  • Debit amount: Total debit amount in batch (for example receivables)
  • Credit amount: Total credit amount (for example refunds)
  • File name: Name of the uploaded file
  • File type: CSV (can be opened with Excel)
  • Source: Usually Plaza, but sFTP is another option
Processed batch

Once a batch has been processed and approved, you can click on it to see the results.

  • Original file: The submitted file.
  • Validation results: This file describes per line in the submitted file whether it could be uploaded to the Plaza or not. If everything went according to plan, this is stated in this file. If an error occurred, this is also stated in this file. It is specified what exactly went wrong, so you can make adjustments accordingly.
  • Processing results: An overview of batch lines, including possible lines that didn’t pass validation and the reason why they failed at validation.
Multilevel authorisation

It is possible to set up authorisations. This function enables 4 dual authorisation in order to prevent mistakes. You can find more information on multilevel authorisation here.

Sample files

Below, you’ll find various sample files, including a brief explanation of the content of a specific entry field.


Diacritics are signs written above or below a letter. The diacritical mark above or beneath the letter indicates a difference in pronunciation from the same letter when unmarked or differently marked. An example of a diacritic is the sign above the ‘a’ in the word Fryslân (the Dutch province Frisia). In order to be able to process these signs, Buckaroo uses the UTF-8 encoding. In the various gateways, the UTF-8 encoding is enforced. The UTF-8 encoding also has to be enforced when files are submitted. You should therefore pay attention whether the text editor you’re using saves the text UTF-8 coded. Different encoding will be filtered out by Buckaroo and replaced by the questionmark  ?  in order to enable further data processing. Please pay special attention when diacritics are used in the customer name, street names or other data.