SFTP settlement file access

Overview

Your settlement files can be sent to a SFTP server that's hosted by Affirm. This delivery method may be preferable, as it allows for your servers to access settlement files using a script, and process those files automatically.

In order to start using Affirm's SFTP server for settlement file retrieval, you must first send us your access details so that we can begin the setup process. Once setup is complete, you'll be able to test your connection to the Affirm servers.

Setup

1. Generate and/or copy your SSH RSA public key
2. Note the IP address(es) SFTP will be accessed from
3. Send the above information to Affirm

SSH keys

If you haven't already generated a SSH keypair on your machine, you will need to do so before connecting to Affirm's SFTP server.

1. Generate SSH keys using:
ssh-keygen -t rsa -b 4096
2. Find your SSH folder.

  • You can type this command to open the folder:
    open ~/.ssh
  • Or navigate it in Finder:
    <your_users_home_directory>/.ssh

3. (Optional): You may have to enable hidden folders:

 $ defaults write com.apple.Finder AppleShowAllFiles true
 $ killall Finder

4. Find the public key file: id_rsa.pub

IP Address

We need to whitelist the IP address(es) of the machine that will be accessing our SFTP server. If you're not sure what your IP address is, you can type 'my ip' into Google and it will tell you your IP address.

Send to Affirm

Once you've generated your keys, and collected your IP address, send an email to your Affirm integration contact with your public key file attached and the IP address(es) in the message body.

Testing

Once your Affirm contact has confirmed that your access has been granted you can connect to our SFTP server using a client, or using your terminal:

🚧

You may not see files in the directory right away. If you're able to connect successfully, this is a sufficient test of your access.


Did this page help you?