Reports Where Your Stack Already Lives
Subscribe to scheduled report delivery over SFTP, Slack, or email. Daily settlement drops into your finance ERP. Monthly statements arrive in your merchants' inboxes. Payment events surface in your ops Slack channel. No polling, no missed runs, no manual exports — Surfboard pushes the data to where it's needed.
Push, Don't Poll
Webhooks are excellent for real-time, transactional events. They're a poor fit for the workflows finance teams actually run — daily reconciliations, monthly statements, weekly file drops to ERPs that expect SFTP. The Notifications API is the scheduled, batched, channel-flexible counterpart built for those workflows specifically.
Three delivery channels (SFTP, Slack, email), six event types (daily/monthly reports, payment completion, daily/weekly/monthly file transfers), and the ability to combine multiple channels in a single subscription. Notifications round out the eventing surface so you don't have to build separate plumbing for finance and engineering.
Built for enterprise finance integration
Banks, NetSuite, SAP, Workday, Xero, Visma, Fortnox — the systems your CFO already runs against expect SFTP. Surfboard ships the SFTP channel with managed public keys, configurable separators, and per-subscription remote directories so you can plug in without forcing your finance stack to learn webhooks.
How Notifications Work
Subscribe to an event
POST /merchants/:merchantId/notifications/reports
{
"event": "DAILY_FILE_TRANSFER",
"sftpInfo": {
"host": "sftp.your-erp.com",
"user": "surfboard-feed",
"port": 22,
"remoteDirectory": "/inbound/payments",
"separator": "SEMICOLON"
}
}
Surfboard returns the credentials you need
{
"status": "SUCCESS",
"data": [
{
"notificationId": "839dd1b8113ff82af3",
"NotificationChannel": "SFTP",
"publicKey": "ssh-rsa AAAA..."
}
]
}
Reports arrive on schedule
What you can build
Notifications cover the gap between real-time eventing and the scheduled, batch-oriented data delivery that finance, ops, and ERP integrations actually require.
1. SFTP File Drops for Banks & ERPs
Banks, large acquirers, NetSuite, SAP, Workday, Visma, Fortnox — most enterprise finance systems ingest data through SFTP, not webhooks. Subscribe to scheduled file transfers and Surfboard pushes daily, weekly, or monthly reports straight into your inbound directory.
- Daily, weekly, or monthly cadence
- Configurable CSV separator (comma, semicolon, pipe, tab)
- Surfboard-managed public key for secure auth
- Custom remote directory per subscription
Built for the integration patterns enterprise finance actually uses.
2. Slack Channels for Operational Awareness
Your ops team lives in Slack. Subscribe a Slack channel to DAILY_REPORTS or PAYMENT_COMPLETED events and the team gets settlement summaries and live payment notifications without leaving the tool.
Useful for high-touch merchant accounts where the partner wants visibility into transaction flow in near-real-time.
3. Email Statements for Merchants
Subscribe a merchant's accounting email to monthly reports and they receive a clean statement on schedule. No portal log-in, no manual export, no support ticket asking for last month's settlement.
Especially valuable for SMB merchants who don't run their own integration but still want the data in their inbox.
4. Multi-Channel by Design
One subscription can fan out to all three channels. SFTP for the ERP, Slack for the ops team, email for the merchant — all driven by the same event, all consistent in content.
email— single recipient or aliasslackUrl— incoming webhook URLsftpInfo— host, user, port, remote directory, separator
5. Partner-Level vs. Merchant-Level Subscriptions
Subscribe at the partner level for cross-merchant operational alerts (your finance team wants every merchant's daily report in one drop). Subscribe at the merchant level when each merchant needs their own delivery destination. Both supported, both configurable through the same Notifications surface.
6. Distinct from Real-Time Webhooks
Webhooks are for code that needs to react in milliseconds — order created, payment authorized, NFC tag identified. Notifications are for the systems that consume on a schedule — finance pipelines, ERPs, monthly reporting, audit trails.
Two different interaction models, two different APIs, both first-class in the platform.
Three channels, six event types
File drops on a schedule. Surfboard manages the public key. CSV separator and remote directory configurable per subscription.
Incoming webhook URL. Reports and event summaries land in the channel of your choice.
Direct delivery to merchants, finance aliases, or operational inboxes.
DAILY_REPORTS · MONTHLY_REPORTS ·
PAYMENT_COMPLETED · DAILY_FILE_TRANSFER ·
WEEKLY_FILE_TRANSFER · MONTHLY_FILE_TRANSFER Subscribe at the level that fits
Partner-level subscriptions push consolidated data across every merchant in your portfolio. Merchant-level subscriptions deliver per-merchant reports to per-merchant destinations. Both supported through dedicated endpoints, both manageable through the same lifecycle (fetch, subscribe, unsubscribe).
Six endpoints in total — list, subscribe, and unsubscribe at both the partner and merchant levels.
Subscribe to your first feed
One POST is enough to start receiving scheduled reports. Combine multiple channels in the same subscription. Surfboard returns the public key you need to authorize SFTP delivery on your server.
// Subscribe a merchant to daily SFTP file transfer
POST /merchants/:merchantId/notifications/reports
{
"event": "DAILY_FILE_TRANSFER",
"sftpInfo": {
"host": "sftp.your-erp.com",
"user": "surfboard-feed",
"port": 22,
"remoteDirectory": "/inbound/payments",
"separator": "SEMICOLON"
},
"slackUrl": "https://hooks.slack.com/services/T.../B.../...",
"email": "finance@your-merchant.com"
}