Funding Sources

Learn how to make funds available to your cards.

Funding Source Schema

{
  "created": String,
  "token": String,
  "type": String,
  "state": String,
  "nickname": String,
  "account_name": String,
  "last_four": String
}
createdAn ISO 8601 string representing when this funding source was added to the Privacy account. This may be null
tokenA globally unique identifier for this Funding Source
typeType of funding source, see Enumerations for list
stateState of funding source, see Enumerations for list
nicknameThe nickname given to the Funding Source or null if it has no nickname
account_nameAccount name identifying the funding source. This may be null
last_fourThe last 4 digits of the account (e.g. bank account, debit card) associated with this funding account. This may be null

List Funding Sources

API Reference: List funding sources

List all funding sources under the program associated with the calling API key. An account_token can be passed in as a query parameter to filter for only the funding sources associated with a single account.

GET https://api.privacy.com/v1/funding_sources

Sample Request

curl 'https://api.privacy.com/v1/funding_sources?account_token=b68b7424-aa69-4cbc-a946-30d90181b621' \
  -H 'Accept: application/json' \
  -H "Authorization: api-key YOUR_API_KEY"

Sample Response

{
   "data": [
      { 
        "created": "2020-07-08 17:57:36",
        "token": "b0f0d91a-3697-46d8-85f3-20f1a585cbea",
        "type": "DEPOSITORY_CHECKING",
        "state": "ENABLED",
        "nickname": "",
        "account_name": "Sandbox",
        "last_four": "5263"
      },
        "created": "2021-01-01 16:42:21",
        "token": "b013627e-c678-4d6a-9b22-4741e377d604a",
        "type": "DEPOSITORY_CHECKING",
        "state": "ENABLED",
        "nickname": "",
        "account_name": "Sandbox2",
        "last_four": "1234"
      }
    ],
  "total_entries": 2,
  "total_pages": 1,
  "page": 1
}

Enumerations

FundingSource.state

ENABLEDThe funding source is available to use for card creation and transactions
PENDINGThe funding source is still being verified e.g. bank micro-deposits verification

FundingSource.type

CARD_DEBITDebit card
DEPOSITORY_CHECKINGBank checking account
DEPOSITORY_SAVINGSBank savings account