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 the 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 all rules and regulations. Contact Marqeta for more information.
Create program source
Copy section link
Action: POST
Endpoint: /fundingsources/program
Create a program funding source.
Body field details
Copy section link
| Fields | Description |
|---|---|
active
boolean
|
Indicates whether the program funding source is active. Allowable Values:
Default value: |
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: 36 char max |
name
string
|
The name of the program funding source. Allowable Values: 40 char max |
List program sources
Copy section link
Action: GET
Endpoint: /fundingsources/program
Retrieve all program funding sources associated with a program. Returned as a collection.
This endpoint supports field filtering and sorting and pagination.
Note
This endpoint only returns active funding sources. To view the details of an inactive funding source, send aGET request to /fundingsources/program/{token} instead.
Body field details
Copy section link
| Fields | Description |
|---|---|
program
string
|
Program whose active funding sources you want to view. Allowable Values: 40 char max |
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
|
Identifies the program funding source you want to retrieve. Allowable Values: Existing program funding source token. Send a |
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
|
Identifies the program funding source to update. Allowable Values: Existing program funding source token. Send a |
Body field details
Copy section link
| Fields | Description |
|---|---|
name
string
|
The name of the program funding source. Allowable Values: 40 char max |
active
boolean
|
Indicates whether the program funding source is active. Allowable Values:
|
Create ACH program source
Copy section link
Action: POST
Endpoint: /fundingsources/program/ach
Create an ACH program funding source.
Body field details
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 |
account_number
string
|
The ACH account number. Allowable Values: 36 char max |
name_on_account
string
|
The name on the ACH account. Allowable Values: 40 char max |
routing_number
string
|
The routing number for the ACH account. Allowable Values: 9 digits |
account_type
string
|
The type of account. Allowable Values: checking, savings |
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: |
verification_override
boolean
|
Allows the ACH funding source to be used regardless of its verification status. Allowable Values:
Default value: |
verification_notes
string
|
Free-form text field for holding notes about verification.
This field is returned only if Allowable Values: 255 char max |