Account Holder Funding Sources
Use the /fundingsources/ach
, /fundingsources/ach/partner
, and /fundingsources/paymentcard
endpoints to create account holder funding sources.
A funding source enables access to funds outside of the Marqeta platform.
For more information on users and businesses, see About Account Holders.
Create ACH source
Copy section link
Action: POST
Endpoint: /fundingsources/ach
Create an ACH funding source for an existing account holder. Specify the account holder of the funding source by passing a user or business token.
When adding an ACH funding source, a small amount is deposited in the bank account as a test. The test deposit should be reflected in the account after two to three business days. You must then make an API call to verify the deposit amount in order to activate the ACH account. See Verify or Update ACH Funding Source on this page for more information.
The response body returns details about the account, including the verification status.
Possible ACH verification status values include VERIFICATION_PENDING
, ACH_VERIFIED
, and ACH_FAILED
.
To use a third-party for account validation when creating an ACH funding source for an existing account holder, see Create ACH source via a partner integration.
Request body
Copy section link
Fields | Description |
---|---|
account_number
string
|
The ACH account number. Allowable Values: 36 char max |
account_type
string
|
The type of account. Allowable Values:
|
bank_name
string
|
The name of the financial institution where the ACH account is held. Allowable Values: 255 char max |
business_token
string
|
Specifies the owner of the funding source.
This token is required if a Allowable Values: 1–36 chars Send a |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. Allowable Values:
Default value: |
name_on_account
string
|
The name on the ACH account. Allowable Values: 1–50 chars |
routing_number
string
|
The routing number for the ACH account. Allowable Values: 9 digits |
token
string
|
The unique identifier of the funding source. If you do not include a token, the system will generate one automatically. This token is necessary for use in other calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. Allowable Values: 1–36 chars |
user_token
string
|
Specifies the owner of the funding source.
This token is required if a Allowable Values: 1–36 chars Send a |
verification_notes
string
|
Free-form text field for holding notes about verification.
This field is returned only if Allowable Values: 255 char max |
verification_override
boolean
|
Allows the ACH funding source to be used regardless of its verification status. Allowable Values:
Default value: |
Response body
Copy section link
Fields | Description |
---|---|
account_suffix
string
|
The last four digits of the account number. Allowable Values: 4 char max |
account_type
string
|
The type of account. Allowable Values:
|
active
boolean
|
Specifies whether the account is active. Allowable Values:
|
bank_name
string
|
The name of the bank holding the account. This field is returned if it exists in the resource. Allowable Values: 255 char max |
business_token
string
|
The unique identifier of the Allowable Values: Existing |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
date_sent_for_verification
datetime
|
Date and time in UTC when either the request for account validation was sent to the third-party partner, or when the funding source was verified by microdeposits.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
date_verified
datetime
|
The date and time when the account was verified, in UTC.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. This field is returned if it exists in the resource. Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
name_on_account
string
|
The name on the ACH account. Allowable Values: 1–50 chars |
token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token |
user_token
string
|
The unique identifier of the Allowable Values: Existing |
verification_notes
string
|
Free-form text field for holding notes about verification.
This field is returned only if Allowable Values: 255 char max |
verification_override
boolean
|
Allows the ACH funding source to be used regardless of its verification status. This field is returned if it exists in the resource. Allowable Values:
Default value: |
verification_status
string
|
The account verification status. This field is returned if it exists in the resource. Allowable Values:
|
Create ACH source via a partner integration
Copy section link
Action: POST
Endpoint: /fundingsources/ach/partner
Create an ACH funding source for an existing account holder by using a third-party partner to handle account validation and provide PII account data. Because you don’t handle any personally identifiable information (PII) yourself, using a third party when creating the funding source enables you to bypass the regulatory and compliance measures related to capturing, storing, and transmitting PII.
With this endpoint, you can create a US-based funding source—either a checking account or a savings account—for a program or user without passing bank account details such as the account number or routing number to Marqeta.
Instead, validating account data and account verification is handled by the third-party partner you specify, and a secure token (i.e., a Plaid processor_token
) is shared across partners.
By using a secure account verification platform to provide immediate verification, you shorten the wait time until the ACH funding source is ready and avoid managing the microdeposit-based account verification process.
To create an ACH funding source for an existing account holder without validating through a third party, see Create ACH source.
Note
This endpoint assumes that you already have established a relationship with both Marqeta and the third-party account validation partner you want to use. In addition, you must explicitly authorize the sharing of information with the third-party partner, and enable Marqeta as a processor for your integration. For more information, contact your Marqeta representative.
Request body
Copy section link
Fields | Description |
---|---|
token
string
|
The unique identifier of the funding source. If you do not include a token, the system will generate one automatically. This token is necessary for use in other calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. Allowable Values: 36 char max |
user_token OR business_token
string
|
Specifies the owner of the funding source. Allowable Values: Existing user or business token. Send a Default value: |
partner_account_link_reference_token
string
|
Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. NOTE: You must include a Allowable Values: 255 max char |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. Allowable Values:
Default value: |
partner
string
|
The name of the partner who will validate this account holder. Allowable Values:
|
Response body
Copy section link
Fields | Description |
---|---|
count
string
|
The number of resources returned. Allowable Values: 1-100 recommended |
start_index
string
|
Specifies the sort order index from which to begin returning data. Allowable Values: Any integer |
end_index
integer
|
The sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of Allowable Values:
|
partner
string
|
The name of the partner who validated the account holder. Allowable Values:
|
partner_account_link_reference_token
string
|
Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. Allowable Values: 255 max char |
created_time
string
|
Date and time when the account holder funding source was created. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.Z |
last_modified_time
string
|
Date and time when the account holder funding source was last modified. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.Z |
token
string
|
The unique identifier of the funding account. Allowable Values: 36 char max |
bank_name
string
|
The name of the financial institution where the ACH account is held. Returned only if supplied by the third-party partner. NOTE: This field is not returned by Allowable Values: 255 char max |
account_suffix
string
|
The last four digits of the account number. Allowable Values: 4 char max |
account_type
string
|
The type of account. Allowable Values:
|
active
boolean
|
Indicates whether the ACH funding source is active. Allowable Values:
|
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. Allowable Values:
|
verification_status
string
|
Indicates the bank account’s verification status. Allowable Values:
|
date_sent_for_verification
string
|
Date and time in UTC when the request for account validation was sent to the specified partner. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.Z |
user_token
string
|
Specifies the owner of the funding source. Allowable Values: Existing user token. |
name_on_account
string
|
The account holder name associated with the ACH account.
Returned when the Allowable Values: 50 char max |
Retrieve ACH source
Copy section link
Action: GET
Endpoint: /fundingsources/ach/{funding_source_token}
Retrieve a specific ACH funding source. The response body returns details about the account, including the verification status.
URL path parameters
Copy section link
Fields | Description |
---|---|
funding_source_token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token. Send a |
Response body
Copy section link
Fields | Description |
---|---|
account_suffix
string
|
The last four digits of the account number. Allowable Values: 4 char max |
account_type
string
|
The type of account. Allowable Values:
|
active
boolean
|
Indicates whether the ACH funding source is active. Allowable Values:
|
bank_name
string
|
The name of the financial institution where the ACH account is held. This field is returned if it exists in the resource. Allowable Values: 255 char max |
business_token
string
|
The unique identifier of the Allowable Values: Existing |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
date_sent_for_verification
datetime
|
Date and time in UTC when either the request for account validation was sent to the third-party partner, or when the funding source was verified by microdeposits.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
date_verified
datetime
|
The date and time when the account was verified, in UTC.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. This field is returned if it exists in the resource. Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
name_on_account
string
|
The account holder name associated with the ACH account. Allowable Values: 1–50 chars |
partner
string
|
The name of the partner who validated the account holder. Returned when a third-party partner was used for account validation. Allowable Values:
|
partner_account_link_reference_token
string
|
Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. Returned when a third-party partner was used for account validation. Allowable Values: 255 max char |
token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token |
user_token
string
|
Specifies the owner of the funding source.
This token is returned if a Allowable Values: Existing |
verification_notes
string
|
Free-form text field for holding notes about verification.
This field is returned only if Allowable Values: 255 char max |
verification_override
boolean
|
Allows the ACH funding source to be used, regardless of its verification status. This field is returned if it exists in the resource. NOTE: When using Allowable Values:
Default value: |
verification_status
string
|
Indicates the bank account’s verification status. This field is returned if it exists in the resource. Allowable Values:
|
Verify or update ACH source
Copy section link
Action: PUT
Endpoint: /fundingsources/ach/{funding_source_token}
Verify or update an ACH funding source.
If you are verifying the ACH source, include the verification amounts in the body of the request.
ACH verification will fail if the verification amounts are not entered in the correct order.
verify_amount1
must match the first deposit amount, and verify_amount2
must match the second.
If you are updating the ACH source, include the active
field instead.
The active
field is the only field you can update.
URL path parameters
Copy section link
Fields | Description |
---|---|
funding_source_token
string
|
Identifies the ACH funding source to verify or update. Allowable Values: Existing ACH funding source token. Send a |
Request body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Indicates whether the ACH funding source is active. Allowable Values:
|
verify_amount1
decimal
|
Verification amount. Allowable Values: Format: 0.00 |
verify_amount2
decimal
|
Verification amount. Allowable Values: Format: 0.00 |
Response body
Copy section link
Fields | Description |
---|---|
account_suffix
string
|
The last four digits of the account number. Allowable Values: 4 char max |
account_type
string
|
The type of account. Allowable Values:
|
active
boolean
|
Specifies whether the account is active. Allowable Values:
|
bank_name
string
|
The name of the bank holding the account. This field is returned if it exists in the resource. Allowable Values: 255 char max |
business_token
string
|
The unique identifier of the Allowable Values: Existing |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
date_sent_for_verification
datetime
|
Date and time in UTC when either the request for account validation was sent to the third-party partner, or when the funding source was verified by microdeposits.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
date_verified
datetime
|
The date and time when the account was verified, in UTC.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. This field is returned if it exists in the resource. Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
name_on_account
string
|
The name on the ACH account. Allowable Values: 1–50 chars |
token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token |
user_token
string
|
The unique identifier of the Allowable Values: Existing |
verification_notes
string
|
Free-form text field for holding notes about verification.
This field is returned only if Allowable Values: 255 char max |
verification_override
boolean
|
Allows the ACH funding source to be used regardless of its verification status. This field is returned if it exists in the resource. Allowable Values:
Default value: |
verification_status
string
|
The account verification status. This field is returned if it exists in the resource. Allowable Values:
|
Retrieve ACH verification amounts
Copy section link
Action: GET
Endpoint: /fundingsources/ach/{funding_source_token}/verificationamounts
In your public or private sandbox environment, retrieve the amounts used to verify the association with your ACH account.
Use this endpoint for testing purposes only. In production, verification amounts are retrieved from the bank statement of the account holder.
URL path parameters
Copy section link
Fields | Description |
---|---|
funding_source_token
string
|
Identifies the ACH funding source for which you want to retrieve verification deposit amounts. Allowable Values: Existing funding source token. Send a |
Response body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Indicates whether the ACH funding source is active. Allowable Values:
|
verify_amount1
decimal
|
Verification amount. Allowable Values: Format: 0.00 |
verify_amount2
decimal
|
Verification amount. Allowable Values: Format: 0.00 |
List sources for business
Copy section link
Action: GET
Endpoint: /fundingsources/business/{business_token}
List funding sources associated with a specific business.
This endpoint supports field filtering.
URL path parameters
Copy section link
Fields | Description |
---|---|
business_token
string
|
Identifies the business whose funding sources you want to retrieve. Allowable Values: Existing Send a |
URL query parameters
Copy section link
Fields | Description |
---|---|
type
string
|
Type of funding source to return: ACH or payment card. Leave unspecified to return both types. Allowable Values:
Default value: |
fields
string
|
Comma-delimited list of fields to return ( Allowable Values: Comma-delimited list of fields, or blank |
Response body
Copy section link
Fields | Description |
---|---|
count
integer
|
The number of resources to retrieve. Allowable Values: 1-100 recommended |
data
array of objects
|
An array of Allowable Values: Valid |
data[].account_suffix
string
|
The last four digits of the account number. This field is returned if it exists in the resource. Allowable Values: 4 char max |
data[].account_type
string
|
The type of account. This field is returned if it exists in the resource. Allowable Values:
|
data[].active
boolean
|
Specifies whether the account is active. This field is returned if it exists in the resource. Allowable Values:
|
data[].business_token
string
|
The unique identifier of the Allowable Values: Existing |
data[].created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].date_sent_for_verification
datetime
|
The date and time when the account was sent for verification, in UTC.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].date_verified
datetime
|
The date and time when the account was verified, in UTC.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].exp_date
string
|
Payment card expiration date. This field is returned if it exists in the resource. Allowable Values: Format: MMyy |
data[].is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. This field is returned if it exists in the resource. Allowable Values:
|
data[].last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].name_on_account
string
|
The name on the account. This field is returned if it exists in the resource. Allowable Values: 1–50 chars |
data[].partner
string
|
The name of the partner who validated the account holder.
Returned when the funding source was created using the Allowable Values:
|
data[].partner_account_link_reference_token
string
|
Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number.
Returned when the Allowable Values: 255 max char |
data[].token
string
|
The unique identifier of the funding source. This field is returned if it exists in the resource. Allowable Values: Existing funding source token |
data[].type
string
|
The funding source type. Allowable Values:
|
data[].user_token
string
|
The unique identifier of the Allowable Values: Existing |
data[].verification_notes
string
|
Free-form text field for holding notes about verification.
This field is returned only if Allowable Values: 255 char max |
data[].verification_override
boolean
|
Allows the ACH funding source to be used regardless of its verification status. Allowable Values:
|
data[].verification_status
string
|
The account verification status. This field is returned if it exists in the resource. Allowable Values:
|
end_index
integer
|
The sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of Allowable Values:
|
start_index
integer
|
The sort order index of the first resource in the returned array. Allowable Values: Any integer |
Create payment card source
Copy section link
Action: POST
Endpoint: /fundingsources/paymentcard
Create a payment card funding source for an existing account holder.
This endpoint returns the card type and the last four digits of the card, and then sets the active
field to true
.
Marqeta retains only a tokenized representation of the card number.
Note
This endpoint is only available to its current users.
Request body
Copy section link
Fields | Description |
---|---|
account_number
string
|
Payment card account number. Allowable Values: 16-digit number |
business_token
string
|
Specifies the owner of the funding source.
This token is required if the Allowable Values: 1–36 chars Send a |
cvv_number
string
|
Payment card CVV2 number. Allowable Values: 3–4 chars |
exp_date
string
|
Payment card expiration date. Allowable Values: Format: MMyy |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls.
If there is only one funding source, the system ignores this field and always uses that source.
If you do not specify this field upon creation, the system sets it to Allowable Values:
Default value: |
postal_code
string
|
Postal code of the account holder (user or business). Allowable Values: 10 char max |
token
string
|
The unique identifier of the funding account. If you do not include a token, the system will generate one automatically. As this token is necessary for use in other calls, we recommend that you define a simple and easy to remember string rather than letting the system generate a token for you. This value cannot be updated. Allowable Values: 1–36 chars |
user_token
string
|
Specifies the owner of the funding source.
This token is required if the Allowable Values: 1–36 chars Send a |
zip
string
|
ZIP code of the account holder (user or business) Allowable Values: 10 char max |
Response body
Copy section link
Fields | Description |
---|---|
account_suffix
string
|
The last four digits of the account number. Allowable Values: 4 char max |
account_type
string
|
The type of payment card account. Allowable Values:
|
active
boolean
|
Specifies whether the account is active. Allowable Values:
|
business_token
string
|
The unique identifier of the Allowable Values: Existing |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
exp_date
string
|
Payment card expiration date. Allowable Values: Format: MMyy |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token |
type
string
|
The funding source type. Allowable Values:
|
user_token
string
|
The unique identifier of the Allowable Values: Existing |
Retrieve payment card source
Copy section link
Action: GET
Endpoint: /fundingsources/paymentcard/{funding_source_token}
Retrieve a specific payment card funding source.
Note
This endpoint is only available to its current users.
URL path parameters
Copy section link
Fields | Description |
---|---|
funding_source_token
string
|
Identifies the payment card funding source you want to retrieve. Allowable Values: Existing funding source token. Send a |
Response body
Copy section link
Fields | Description |
---|---|
account_suffix
string
|
The last four digits of the account number. Allowable Values: 4 char max |
account_type
string
|
The type of payment card account. Allowable Values:
|
active
boolean
|
Specifies whether the account is active. Allowable Values:
|
business_token
string
|
The unique identifier of the Allowable Values: Existing |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
exp_date
string
|
Payment card expiration date. Allowable Values: Format: MMyy |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token |
type
string
|
The funding source type. Allowable Values:
|
user_token
string
|
The unique identifier of the Allowable Values: Existing |
Update payment card source
Copy section link
Action: PUT
Endpoint: /fundingsources/paymentcard/{funding_source_token}
Update a payment card funding source. Only the values of parameters in the request are modified; all others are left unchanged.
Note
This endpoint is only available to its current users.
URL path parameters
Copy section link
Fields | Description |
---|---|
funding_source_token
string
|
Identifies the payment card funding source you want to retrieve. Allowable Values: Existing funding source token. Send a |
Request body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Indicates whether the card funding source is active. Allowable Values:
Default value: |
exp_date
string
|
The expiration date for the payment card. Allowable Values: Format: MMyy |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. Allowable Values:
Default value: |
Response body
Copy section link
Fields | Description |
---|---|
account_suffix
string
|
The last four digits of the account number. Allowable Values: 4 char max |
account_type
string
|
The type of payment card account. Allowable Values:
|
active
boolean
|
Specifies whether the account is active. Allowable Values:
|
business_token
string
|
The unique identifier of the Allowable Values: Existing |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
exp_date
string
|
Payment card expiration date. Allowable Values: Format: MMyy |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token |
type
string
|
The funding source type. Allowable Values:
|
user_token
string
|
The unique identifier of the Allowable Values: Existing |
List sources for user
Copy section link
Action: GET
Endpoint: /fundingsources/user/{user_token}
List funding sources associated with a specific user.
This endpoint supports field filtering.
URL path parameters
Copy section link
Fields | Description |
---|---|
user_token
string
|
Identifies the individual whose funding sources you want to list. Allowable Values: Existing Send a |
URL query parameters
Copy section link
Fields | Description |
---|---|
type
string
|
The type of funding source to retrieve. Leave unspecified to return both types. Allowable Values:
Default value: |
fields
string
|
Comma-delimited list of fields to return ( Allowable Values: Comma-delimited list of fields |
Response body
Copy section link
Fields | Description |
---|---|
count
integer
|
The number of resources to retrieve. Allowable Values: 1-100 recommended |
data
array of objects
|
An array of Allowable Values: Valid |
data[].account_suffix
string
|
The last four digits of the account number. This field is returned if it exists in the resource. Allowable Values: 4 char max |
data[].account_type
string
|
The type of account. This field is returned if it exists in the resource. Allowable Values:
|
data[].active
boolean
|
Specifies whether the account is active. This field is returned if it exists in the resource. Allowable Values:
|
data[].business_token
string
|
The unique identifier of the Allowable Values: Existing |
data[].created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].date_sent_for_verification
datetime
|
The date and time when the account was sent for verification, in UTC.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].date_verified
datetime
|
The date and time when the account was verified, in UTC.
This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].exp_date
string
|
Payment card expiration date. This field is returned if it exists in the resource. Allowable Values: Format: MMyy |
data[].is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source. This field is returned if it exists in the resource. Allowable Values:
|
data[].last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].name_on_account
string
|
The name on the account. This field is returned if it exists in the resource. Allowable Values: 1–50 chars |
data[].partner
string
|
The name of the partner who validated the account holder.
Returned when the funding source was created using the Allowable Values:
|
data[].partner_account_link_reference_token
string
|
Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number.
Returned when the Allowable Values: 255 max char |
data[].token
string
|
The unique identifier of the funding source. This field is returned if it exists in the resource. Allowable Values: Existing funding source token |
data[].type
string
|
The funding source type. Allowable Values:
|
data[].user_token
string
|
The unique identifier of the Allowable Values: Existing |
data[].verification_notes
string
|
Free-form text field for holding notes about verification.
This field is returned only if Allowable Values: 255 char max |
data[].verification_override
boolean
|
Allows the ACH funding source to be used regardless of its verification status. Allowable Values:
|
data[].verification_status
string
|
The account verification status. This field is returned if it exists in the resource. Allowable Values:
|
end_index
integer
|
The sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of Allowable Values:
|
start_index
integer
|
The sort order index of the first resource in the returned array. Allowable Values: Any integer |
Set default source
Copy section link
Action: PUT
Endpoint: /fundingsources/{funding_source_token}/default
Configure either an ACH funding source or a payment card funding source as the default funding source.
A default funding source is used when you omit the funding_source_token
field from funding requests, such as a POST
request to /gpaorders
.
Note that the first funding source you create is automatically set as the default (is_default_source=true
).
URL path parameters
Copy section link
Fields | Description |
---|---|
funding_source_token
string
|
Specifies the funding source to use by default. You can set the default only to an ACH or payment card funding source. Allowable Values: Existing funding source token Send a |
Response body
Copy section link
Fields | Description |
---|---|
account_suffix
string
|
The last four digits of the account number. Allowable Values: 4 char max |
account_type
string
|
The type of payment card account. Allowable Values:
|
active
boolean
|
Specifies whether the account is active. Allowable Values:
|
business_token
string
|
The unique identifier of the Allowable Values: Existing |
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
exp_date
string
|
Payment card expiration date. Allowable Values: Format: MMyy |
is_default_account
boolean
|
If there are multiple funding sources, this field specifies which source is used by default in funding calls. Allowable Values:
|
last_modified_time
datetime
|
The date and time when the resource was last modified, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token |
type
string
|
The funding source type. Allowable Values:
|
user_token
string
|
The unique identifier of the Allowable Values: Existing |