Documentation

Worldpay

Worldpay is file-based, not API-based. You schedule Scheduled Secure Reports (SSR) to be delivered daily as .CSV to your merchant FTP account, and Athia connects to that account daily to download, parse and map the reports. There is no API polling and no webhook. The provider-side prerequisites are a joint effort: your Athia team tells you which reports to schedule and supplies the IP addresses to allowlist, and you configure the Scheduled Secure Reports and the allowlist in your own Worldpay dashboard, because only you have access to it. Once the reports are landing on your FTP account and the allowlist is in place, you complete the connection yourself.

📘

Worldpay may require allowlisting Athia's IP addresses before it will accept the connection. Request the current list from your Athia team before you configure anything.

What you get

Each report is scheduled separately in SSR, all in .CSV.

ReportCadenceWhat it carries
Session ReportDailyTransaction reconciliation
Declined Transaction ReportDailyDeferred, declined and duplicate transactions
Declined Plan Requests ReportDailyDeclined recurring plans
Chargeback Financial ReportDailyChargebacks and adjustments
Chargeback Status ReportDaily / monthlyChargeback activity
Chargeback Win/Loss ReportDailyWon and lost cases
Issuer Insights ReportWeekly, FridayThe previous week's data
Net Settled Sales by Transaction ReportDailySettled transactions by activity and settlement date
Activity and Settlement ReportsDaily / monthlySummarized financials by activity and settlement date
Fee ReportDaily / monthlyWorldpay and passthrough fees by activity and settlement date
Visa Fixed Acquirer Network Fee ReportMonthly, on the 8thThe prior month's FANF fees
EMDR ReportDailyCanadian transactions, three days prior

Before you start

  • Access to a Worldpay account with permission to configure Scheduled Secure Reports (SSR) and manage merchant FTP accounts.
  • The reports above scheduled in SSR, in .CSV, delivered to your merchant FTP account. Worldpay's SSR Reference Guide covers the field-level detail of each report.
  • Your merchant FTP account details to hand — account name, host, port, username and password.
  • Athia's IP addresses allowlisted if your account requires it.

Athia enforces SFTP/FTPS. A plain FTP endpoint will not be accepted.

Credentials Athia asks for

FieldRequiredWhat it is / where to find it
NameYesYour label for this connection — identify the Worldpay merchant account
FTP Account NameYesThe merchant FTP account SSR delivers to
URL / HostYesThe FTP host Athia connects to, over SFTP or FTPS
PortYesThe port for that host
UsernameYesThe FTP account username
PasswordYesThe matching password

Setting up the connection

  1. Ask your Athia team which reports to schedule, then, in your Worldpay dashboard, open the Scheduled Secure Reports (SSR) service and schedule them, in .CSV, to your merchant FTP account.
  2. Set up or retrieve the merchant FTP account details — FTP Account Name, URL / Host, Port, Username, Password.
  3. Ask your Athia team for the current Athia IP addresses and allowlist them if Worldpay requires it.
  4. In Athia, go to Settings → Connections → + Add Connection and select Worldpay.
  5. On Configure Connector, enter a Name. There is no Schedule field.
  6. On Enter Credentials, enter the FTP account name, host, port, username and password.
  7. Choose Verify Connection. Athia performs an FTP ping and retrieves a sample file.

The connection then shows as ACTIVE and the first sync starts. For several merchant accounts, schedule the reports for each and create one connection per account with its own FTP details.

Webhook

Worldpay uses no webhooks. Reports arrive as files on your FTP account, so there is no destination URL to register and no event selection to make. If API-based webhooks are enabled on your account, raise it with your Athia team.

Sync cadence

The schedule is fixed to daily — there is no Schedule field to choose. Athia connects to the FTP account once a day and processes whatever SSR has delivered.

Limits and things to know

  • You only get what you scheduled. A report you did not configure in SSR is simply absent — there is no API to fall back on.
  • Report cadence is Worldpay's, not yours. Issuer Insights lands weekly on Friday, FANF monthly on the 8th, and EMDR carries data from three days prior. Read those series on their own clock.
  • SFTP/FTPS only. Athia refuses plain FTP.
  • IP allowlisting is a prerequisite, not a fix. If your account enforces it, verification fails until the allowlist is in place.
  • One connection per merchant account, each with its own FTP details.
  • Card data is minimized. Field-level detail on what Athia stores is in Athia Data Dictionary.

Troubleshooting

What you seeLikely causeWhat to do
Verification fails with access deniedAthia's IPs not allowlisted, or wrong FTP username or passwordGet the current IP list from your Athia team and allowlist it, then re-check the credentials
Verification fails on the host or portEndpoint is plain FTP, or the port is wrong for SFTP/FTPSSupply an SFTP or FTPS endpoint and its port
Connection is ACTIVE but no data after the first syncNo reports scheduled yet, or SSR delivers to a different FTP accountConfirm in SSR that the reports are scheduled, in .CSV, to the account Athia connects to
Some report types are missingThose reports were never scheduled in SSRAdd them in SSR; they appear on the next daily delivery
Chargeback or fee figures lag the transactionsExpected — those reports run on their own cadenceReconcile chargebacks and fees on settlement date, not activity date
Data stops arriving for one merchant accountThat account's FTP password changed or its reports were unscheduledUpdate the credential on that connection and confirm its SSR schedules

Related

Updated 1 day ago

Did this page help you?