Fallback Accounts

API used to update the fallback configuration for a bank account
Fallback Accounts
 last updated: 
August 1, 2022

This document describes the API that can be used to update the config section for a specific bank account. Fallbacks are used in overdraft scenarios when funds are being debited from an account. For Cards this would be on authorizations from the card network and for ACH it would be for incoming ACH debits originated outside of Solid. ACH and Card fallbacks can be used independently from each other.

The config object contains the configuration information for a specified account. In this section we are focused on setting up account level fallbacks for ACH and Cards. Fallback account IDs specified must be for accounts of type fallbackAccount.

Required HTTP Headers:
- sd-api-key: {{sd-api-key}}
- sd-person-id: {{sd-person-id}}


  1. PATCH /v1/account/:id/


  1. {
  2.   "fallback": {
  3.     "received": {
  4.       "ach": {
  5.         "enabled": true,
  6.         "fallbackId": "acc-088c937f-a956-4cb8-9278-137858bce3a7"
  7.       },
  8.       "card": {
  9.         "enabled": true,
  10.         "fallbackId": "acc-088c937f-a956-4cb8-9278-137858bce3a7"
  11.       }
  12.     }
  13.   }
  14. }