Skip to main content
This integration is currently in beta and the exact mapping of fields might still change.
To enable settlement reporting for dLocal, please follow this guide to enable SFTP access. Settlement reporting needs to be set up with dLocal with the following considerations:
  1. The report must be a Settlement - Cross-border Payins Model report.
  2. The report must be in CSV format to be delivered via SFTP.
  3. Please contact support to get a list of IP addresses for dLocal to whitelist.
  4. The report filename must follow the naming convention <merchant_name>_cross_border_report_YYYYMMDD_HHMMSS.csv.
After SFTP access has been set up, SFTP credentials are received from dLocal. These credentials are used when enabling settlement reporting in the dLocal connector configuration in the dashboard. To set up these credentials, please go to the “Connections” tab, select the dLocal connector and navigate to the “Settlement” tab. Here settlement reporting can be enabled, after which prompts are provided to fill out the following:
  1. The SFTP username.
  2. The SFTP SSH key.
  3. The SFTP address, as a URL that starts with sftp://, for example sftp://sftp.example.com:22. The port is optional and defaults to 22. An address without the sftp:// scheme isn’t recognized, and settlement reports aren’t imported.
  4. The filename prefix, which is the expected report filename without the _YYYMMDD_HHMMSS.csv part, for example <merchant_name>_cross_border_report.
  5. The SFTP directory where the reports are stored, for example /reports/payins, or / if they are stored in the root folder. Defaults to /reports if unset.
Below is the mapping of dLocal’s report to the consolidated settlement report. This data is pulled from dLocal’s Settlement - Cross-border Payins Model report.

​
Notes

  • Timestamp columns do not contain any timezone info, so they are assumed to be in the UTC timezone.

​
Journal type mapping

Fields marked as not a dLocal field are populated from internal data and not from the imported payment service report.