Create Bank Account (Plaid)

Sandbox Only

Please note that this endpoint is currently only available for testing in the Sandbox environment and may undergo changes as we continue to improve the feature.

POST https://api.sfox.com/v1/bank-account/plaid-processor

sFOX and Plaid have partnered to enable end users to instantly link and verify a bank account. sFOX will use the Plaid processor_token provided to securely retrieve bank account details from Plaid and enable ACH transfers.

• Requires a User Auth Token for authentication. Requests attempted using an Enterprise API Key will result in an error.

• There is a limit of one linked bank account per sFOX account. If you would like to link a different bank account, you must first disconnect the currently linked bank.

Body Parameters

Name	Type	Description
data required	[object]	The Plaid processor_tokens and associated processors
processor required	string	The processor associated with this token. Possible values: sfox, dwolla
token required	string	The processor_token retrieved from Plaid.

Example Requests

Shell

curl -X POST 'https://api.sfox.com/v1/bank-accounts/plaid-processor' \
  -H 'Content-type: application/json' \
  -H "Authorization: Bearer ${USER_AUTH_TOKEN}" \
  -d '{ 
      "data": [{
        "processor": "sfox",
        "token": "${PLAID_PROCESSOR_TOKEN}"
      }
   }'  

NodeJS

const axios = require('axios');

const payload = JSON.stringify({
    "data": [
      {
        "processor": "sfox",
        "token": "${PLAID_PROCESSOR_TOKEN}"
      }
    ]
})

const config = {
  method: 'post',
  url: 'https://api.sfox.com/v1/bank-accounts/plaid-processors',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${process.env.USER_AUTH_TOKEN}`
  },
  data: data
}

axios(config)
  .then(response => {
    console.log(response.status)
    console.log(response.data)
  }).catch(err => {
    console.error(err.response.status)
    console.error(err.response.data)
  });

Python

import requests
import os

data = requests.post(
  "https://api.sfox.com/v1/bank-accounts/plaid-processors",
  headers={
    "Authorization": f"Bearer {os.environ['USER_AUTH_TOKEN']}"
  },
  json={
    "data": [
      {
        "processor": "sfox",
        "token": "PLAID_PROCESSOR_TOKEN"
      }
    ]
  }
)
print(data.status_code)
print(data.json())