Privacy Developer API

Account
Account Holder
Card
Funding
Transaction
Status
- API status checkget

Privacy Developer API

Account
Account Holder
Card
Funding
Transaction
Status
- API status checkget

Verify bank account

post https://api.privacy.com/v1/funding_sources/{funding_source_token}/verify

Verify a bank account as a funding source by providing received micro-deposit amounts.

Path Params

funding_source_token

uuid

required

Body Params

account_token

uuid

Only required for multi-account users. Token identifying the account that the bank account will be associated with. Only applicable if using account enrollment. See Managing Accounts for more information.

micro_deposits

array of integers

required

An array of dollar amounts (in cents) received in two credit transactions.

micro_deposits*

Responses

Response body

object

account_name

string

Account name identifying the funding source. This may be null.

created

date-time

required

An ISO 8601 string representing when this funding source was added to the Privacy account. This may be null. UTC time zone.

last_four

string

required

length between 4 and 4

The last 4 digits of the account (e.g. bank account, debit card) associated with this FundingAccount. This may be null.

nickname

string

length between 1 and 255

The nickname given to the FundingAccount or null if it has no nickname.

state

string

required

State of funding source.

Funding source states:

ENABLED - The funding account is available to use for card creation and transactions.
PENDING - The funding account is still being verified e.g. bank micro-deposits verification.

ENABLED PENDING

token

uuid

required

A globally unique identifier for this FundingAccount.

type

string

required

Types of funding source:

DEPOSITORY_CHECKING - Bank checking account.
DEPOSITORY_SAVINGS - Bank savings account.

DEPOSITORY_CHECKING DEPOSITORY_SAVINGS

Response body

object

message

string

required

Explanation of error response.

debugging_request_id

uuid

required

Identifier to help debug an error.


User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: api-key [api-key]	The Authorization header is not formatted properly
Insufficient privileges. Issuing API key required	Write access requires an Issuing API key. Please contact api@privacy.com
Insufficient privileges to create unlocked cards.	Creating unlocked cards requires an additional privilege

Response body

object

message

string

required

Explanation of error response.

debugging_request_id

uuid

required

Identifier to help debug an error.

Response body

object

message

string

required

Explanation of error response.

debugging_request_id

uuid

required

Identifier to help debug an error.


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

Response body

object

message

string

required

Explanation of error response.

debugging_request_id

uuid

required

Identifier to help debug an error.

Updated over 1 year ago

Update bank account

Transaction

Did this page help you?

Language

Credentials

Header

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.privacy.com/v1/funding_sources/funding_source_token/verify \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated over 1 year ago

Update bank account

Transaction

Did this page help you?

Privacy Developer API
Account
Update accountpatch
Get accountget
List accountsget
Account Holder
Create webhook for KYC/KYB eventspost
Check the current status of a KYC or KYB evaluationget
Resubmit account holder informationpost
Get account holder document upload statusget
Get account holder document uploadsget
Initiate account holder document uploadpost
Create an individual or business account holderpost
Card
Embedded card UIget
Reissue cardpost
Provision card (Digital Wallet)post
Update cardpatch
Get cardget
Create cardpost
List cardsget
Funding
Verify bank accountpost
Update bank accountpatch
Add funding sourcepost
List funding sourcesget
Transaction
Get transactionget
List transactionsget
Simulate void transactionpost
Simulate returnpost
Simulate clearing transactionpost
Simulate authorizationpost
Status
API status checkget

Privacy Developer API
Account
Update accountpatch
Get accountget
List accountsget
Account Holder
Create webhook for KYC/KYB eventspost
Check the current status of a KYC or KYB evaluationget
Resubmit account holder informationpost
Get account holder document upload statusget
Get account holder document uploadsget
Initiate account holder document uploadpost
Create an individual or business account holderpost
Card
Embedded card UIget
Reissue cardpost
Provision card (Digital Wallet)post
Update cardpatch
Get cardget
Create cardpost
List cardsget
Funding
Verify bank accountpost
Update bank accountpatch
Add funding sourcepost
List funding sourcesget
Transaction
Get transactionget
List transactionsget
Simulate void transactionpost
Simulate returnpost
Simulate clearing transactionpost
Simulate authorizationpost
Status
API status checkget

200OK

400A parameter in the query given in the request does not match the valid queries for the endpoint.

404The specified resource was not found.