Program Funding Sources
Use the /fundingsources/program
endpoint to create a program funding source.
A program funding source represents a bank account from which funds are drawn for Managed Just-in-Time (JIT) Funding transactions. For more information about JIT Funding, see About Just-in-Time Funding.
In a public or private sandbox environment, each program funding source you create simulates funds for use in test transactions. In production environments, program funding sources are created by Marqeta and draw funds from a bank account you set up in conjunction with Marqeta.
Note
Your program funding source must be approved by Marqeta and the issuing bank. If you are using a third-party service to collect user funds, Marqeta and the issuing bank require specific reporting to ensure compliance with applicable rules and regulations. Contact Marqeta for more information.
Create program source
Copy section link
Action: POST
Endpoint: /fundingsources/program
Create a program funding source.
Request body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Indicates whether the program funding source is active. Allowable Values:
Default value: |
name
string
|
The name of the program funding source. Allowable Values: 1–50 chars |
token
string
|
The unique identifier of the funding source. 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 |
Response body
Copy section link
Fields | Description |
---|---|
account
string
|
The account identifier. Allowable Values: 255 char max |
active
boolean
|
Indicates whether the program funding source is active. This field is returned if it exists in the resource. Allowable Values:
|
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
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
string
|
The name of the program funding source. Allowable Values: 1–50 chars |
token
string
|
The unique identifier of the funding source. Allowable Values: 1–36 chars |
Create ACH program source
Copy section link
Action: POST
Endpoint: /fundingsources/program/ach
Create an ACH program funding source.
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 bank holding the account. Allowable Values: 255 char max |
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 |
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.
NoteSet this field totrue if you can attest that you have verified the account on your own and that it will not be returned by the Federal Reserve.
Allowable Values:
Default value: |
Response body
Copy section link
Fields | Description |
---|---|
account_suffix
string
|
The ACH account identifier appended to the bank account number. Allowable Values: 255 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 |
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
|
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 |
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. 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 |
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:
|
verification_status
string
|
The account verification status. This field is returned if it exists in the resource. Allowable Values: 255 char max |
List ACH program sources
Copy section link
Action: GET
Endpoint: /fundingsources/program/ach
List ACH program funding sources.
URL query parameters
Copy section link
Fields | Description |
---|---|
count
integer
|
The number of resources to retrieve. Allowable Values: 1-10 |
start_index
integer
|
The sort order index of the first resource in the returned array. Allowable Values: Any integer |
fields
string
|
Comma-delimited list of fields to return ( Allowable Values: Comma-delimited list of fields, or blank |
sort_by
string
|
Field on which to sort.
Use any field in the resource model, or one of the system fields Allowable Values:
|
Response body
Copy section link
Fields | Description |
---|---|
count
integer
|
The number of resources to retrieve. Allowable Values: 1-10 |
data
array of objects
|
An array of Allowable Values: Valid |
data[].account_suffix
string
|
The ACH account identifier appended to the bank account number. Allowable Values: 255 char max |
data[].account_type
string
|
The type of account. Allowable Values:
|
data[].active
boolean
|
Specifies whether the account is active. Allowable Values:
|
data[].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 |
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[].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:
|
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 ACH account. Allowable Values: 1–50 chars |
data[].token
string
|
The unique identifier of the funding source. Allowable Values: Existing funding source token |
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. This field is returned if it exists in the resource. Allowable Values:
|
data[].verification_status
string
|
The account verification status. This field is returned if it exists in the resource. Allowable Values: 255 char max |
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 |
Retrieve program source
Copy section link
Action: GET
Endpoint: /fundingsources/program/{token}
Retrieve a specific program funding source, whether active or inactive.
URL path parameters
Copy section link
Fields | Description |
---|---|
token
string
|
The unique identifier of the program funding source. Allowable Values: Existing program funding source token |
Response body
Copy section link
Fields | Description |
---|---|
account
string
|
The account identifier. Allowable Values: 255 char max |
active
boolean
|
Indicates whether the program funding source is active. This field is returned if it exists in the resource. Allowable Values:
|
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
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
string
|
The name of the program funding source. Allowable Values: 1–50 chars |
token
string
|
The unique identifier of the funding source. Allowable Values: 1–36 chars |
Update program source
Copy section link
Action: PUT
Endpoint: /fundingsources/program/{token}
Update a program funding source. Only the values of parameters specified in the request are modified; all others are left unchanged.
URL path parameters
Copy section link
Fields | Description |
---|---|
token
string
|
The unique identifier of the program funding source. Allowable Values: Existing program funding source token |
Request body
Copy section link
Fields | Description |
---|---|
active
boolean
|
Indicates whether the program funding source is active. Allowable Values:
Default value: |
name
string
|
The name of the program funding source. Allowable Values: 1–50 chars |
Response body
Copy section link
Fields | Description |
---|---|
account
string
|
The account identifier. Allowable Values: 255 char max |
active
boolean
|
Indicates whether the program funding source is active. This field is returned if it exists in the resource. Allowable Values:
|
created_time
datetime
|
The date and time when the resource was created, in UTC.
Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
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
string
|
The name of the program funding source. Allowable Values: 1–50 chars |
token
string
|
The unique identifier of the funding source. Allowable Values: 1–36 chars |