Braintree

This guide will help you connect Braintree settlement, payment, and fee data to your Payrails account. Payrails ingests Braintree data over two channels:

• API — transaction, payment, and dispute data (requires Braintree API credentials, below).
• SFTP fee reports — Braintree's Disbursement Fee Report (DFR) and AIB Transaction Fee Report, which carry detailed fee data the API does not expose. These require Braintree Dropzone (SFTP) credentials.

Providing both gives the most complete fee reporting in Payrails.

Prerequisites

• A Braintree account with admin access.
• (For fee reports) A Braintree Dropzone provisioned for your account — the DFR is delivered for US/Fiserv-acquired accounts, the AIB report for EU-acquired accounts. If you're unsure whether your Dropzone is set up, ask your Braintree/Fiserv contact.

Part A — API credentials

We recommend creating a limited-access set of API keys for Payrails reporting.

Step 1: Log into the Braintree production environment as an admin

Step 2: Create a new role

1. Follow the Braintree documentation to create a new role.
2. Assign the following permissions under "Rights Granted":
   1. Transactions
   2. Download Transactions with Masked Payment Data
   3. Reporting
   4. Create, Run, and Download Reports
   5. View Dashboard Graphs
   6. Read-only Access
   7. View Merchant Accounts
   8. View Payment Methods
   9. View Transactions
   10. View Verifications
   11. Download Files
   12. Statements
   13. View statements
   14. Search
   15. Search Transactions
   16. Search Verifications

Step 3: Create a new user and generate API keys

1. Follow the Braintree documentation to create a new user with:
   1. API Access enabled.
   2. The role created in Step 2 assigned.
   3. All merchant accounts you want to send data for selected.
2. Log in as this user and store the credentials:
   1. Public key
   2. Private key

Step 4: Share the API credentials with Payrails

1. Share your API credentials securely with Payrails — use a shared secrets manager/vault (1Password Shared Vaults, AWS Secrets Manager, GCP Secret Manager).
2. If a shared vault isn't possible, share them via a PGP-encrypted file.

Part B — SFTP fee-report credentials (DFR + AIB)

The DFR and AIB reports are delivered to a Braintree Dropzone over SFTP. To let Payrails collect them, share your Dropzone credentials.

Step 1: Confirm your Dropzone is provisioned

Confirm with your Braintree/Fiserv contact that your account has a Dropzone delivering the Disbursement Fee Report (US/Fiserv) and/or the AIB Transaction Fee Report (EU). These reports are scheduled deliveries — no action is needed in the Braintree Control Panel.

Step 2: Obtain your Dropzone (SFTP) username and password

Your Dropzone uses password-based SFTP at dropzone.braintreepayments.com. You only need the username and password (the host and port are standard). If you've previously connected with a tool like Cyberduck or FileZilla, these are the same credentials.

Step 3: Share the API credentials with Payrails

1. Share your API credentials securely with Payrails — use a shared secrets manager/vault (1Password Shared Vaults, AWS Secrets Manager, GCP Secret Manager).
2. If a shared vault isn't possible, share them via a PGP-encrypted file.

What Payrails ingests, and the fee detail you unlock

With the API credentials, Payrails ingests your transactions, payment-level fees, and disputes. Adding the Dropzone fee reports additionally surfaces detailed fee categories in your Payrails fee reporting and dashboards, including:

• Scheme (card-network) fees, including scheme fees charged on declined transactions.
• Cross-border / international fees.
• EU acquiring fees (from the AIB report) — often the only source of this detail for EU-acquired volume.
• Chargeback fees.

These complement the interchange and processing fees already available via the API, giving a complete view of your Braintree cost of payments in Payrails.