5 minute read

February 3, 2020

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 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 the production environment, program funding sources are created by Marqeta and draw funds from the bank account you specify.

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
Copy section link

Action: POST
Endpoint: /fundingsources/program

Develop Now!

Create a program funding source.

Body field details
Copy section link
Copy section link

Fields Description

Fields	Description
active boolean Optional	Indicates whether the program funding source is active. Allowable Values: `true`, `false` Default value: `true`
token string Optional	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 Required	The name of the funding program. Allowable Values: 40 char max

active

boolean
Optional

Indicates whether the program funding source is active.

Allowable Values:

true, false

Default value: true

token

string
Optional

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
Required

The name of the funding program.

Allowable Values:

40 char max

Sample request body
Copy section link
Copy section link

{
  "token": "my_programfundingsource_token",
  "name": "my_programfundingsource_name",
  "active": true
}

Is this helpful?

Sample response body
Copy section link
Copy section link

{
  "name": "my_programfundingsource_name",
  "active": true,
  "token": "my_programfundingsource_token",
  "account": "12.003.001.000147",
  "created_time": "2015-11-25T20:46:04Z",
  "last_modified_time": "2015-11-25T20:46:04Z"
}

Is this helpful?

Retrieve program source
Copy section link
Copy section link

Action: GET
Endpoint: /fundingsources/program/{token}

Develop Now!

Retrieve a specific program funding source.

URL path parameters
Copy section link
Copy section link

Fields Description

Fields	Description
token string Required	Identifies the program funding source you want to retrieve. Allowable Values: Existing program funding source token. Send a `GET` request to `/fundingsources/user/{user_token}` to retrieve existing funding source tokens for a user or to `/fundingsources/business/{business_token}` to retrieve existing funding source tokens for a business.

token

string
Required

Identifies the program funding source you want to retrieve.

Allowable Values:

Existing program funding source token.

Send a GET request to /fundingsources/user/{user_token} to retrieve existing funding source tokens for a user or to /fundingsources/business/{business_token} to retrieve existing funding source tokens for a business.

Sample response body
Copy section link
Copy section link

{
  "name": "my_programfundingsource_name",
  "active": true,
  "token": "my_programfundingsource_token",
  "account": "12.003.001.000147",
  "created_time": "2015-11-25T20:46:04Z",
  "last_modified_time": "2015-11-25T20:46:04Z"
}

Is this helpful?

Update program source
Copy section link
Copy section link

Action: PUT
Endpoint: /fundingsources/program/{token}

Develop Now!

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
Copy section link

Fields Description

Fields	Description
token string Required	Identifies the program funding source to update. Allowable Values: Existing program funding source token. Send a `GET` request to `/fundingsources/user/{user_token}` to retrieve existing funding source tokens for a user or to `/fundingsources/business/{business_token}` to retrieve existing funding source tokens for a business.

token

string
Required

Identifies the program funding source to update.

Allowable Values:

Existing program funding source token.

Body field details
Copy section link
Copy section link

Fields Description

Fields	Description
name string Optional	The name of the program funding source. Allowable Values: 40 char max
active boolean Optional	Indicates whether the program funding source is active. Allowable Values: `true`, `false`

name

string
Optional

The name of the program funding source.

Allowable Values:

40 char max

active

boolean
Optional

Indicates whether the program funding source is active.

Allowable Values:

true, false

Sample request body
Copy section link
Copy section link

{
    "name": "your_programfundingsource_name",
    "active": false
}

Is this helpful?

Sample response body
Copy section link
Copy section link

{
  "name": "your_programfundingsource_name",
  "active": false,
  "token": "my_programfundingsource_token",
  "account": "12.003.001.000147",
  "created_time": "2015-11-25T20:46:04Z",
  "last_modified_time": "2015-11-25T21:33:59Z"
}

Is this helpful?

Create ACH program source
Copy section link
Copy section link

Action: POST
Endpoint: /fundingsources/program/ach

Create an ACH program funding source.

Body field details
Copy section link
Copy section link

Fields Description

Fields	Description
token string Optional	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 Required	The ACH account number. Allowable Values: 36 char max
name_on_account string Required	The name on the ACH account. Allowable Values: 40 char max
routing_number string Required	The routing number for the ACH account. Allowable Values: 9 digits
account_type string Required	The type of account. Allowable Values: checking, savings
is_default_account boolean Optional	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: `true`, `false` Default value: `false`
verification_override boolean Optional	Allows the ACH funding source to be used regardless of its verification status. Allowable Values: `true`, `false` Default value: `false`
verification_notes string Optional	Free-form text field for holding notes about verification. This field is returned only if `verification_override=true`. Allowable Values: 255 char max

token

string
Optional

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
Required

The ACH account number.

Allowable Values:

36 char max

name_on_account

string
Required

The name on the ACH account.

Allowable Values:

40 char max

routing_number

string
Required

The routing number for the ACH account.

Allowable Values:

9 digits

account_type

string
Required

The type of account.

Allowable Values:

checking, savings

is_default_account

boolean
Optional

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:

true, false

Default value: false

verification_override

boolean
Optional

Allows the ACH funding source to be used regardless of its verification status.

Allowable Values:

true, false

Default value: false

verification_notes

string
Optional

Free-form text field for holding notes about verification. This field is returned only if verification_override=true.

Allowable Values:

255 char max

Sample request body
Copy section link
Copy section link

{
  "name_on_account": "John Smith",
  "account_number": "0888271159",
  "routing_number": "121000357",
  "account_type": "checking",
  "is_default_account": "true",
  "verification_override": "true",
  "verification_notes": "testing"
}

Is this helpful?

Sample response body
Copy section link
Copy section link

{
  "token": "edc04df4-510c-46c7-a6e5-cc5d82fe78fa",
  "name_on_account": "John Smith",
  "account_type": "checking",
  "account_suffix": "1156",
  "is_default_account": "true",
  "active": "true",
  "verification_status": "ACH_VERIFIED",
  "created_time": "2019-03-27T18:40:27Z",
  "last_modified_time": "2019-03-27T18:40:27Z"
}

Is this helpful?

Program Funding Sources

Note

Create program source Copy section linkCopy section link

Develop Now!

Body field details Copy section linkCopy section link

Sample request body Copy section linkCopy section link

Sample response body Copy section linkCopy section link

Retrieve program source Copy section linkCopy section link

Develop Now!

URL path parameters Copy section linkCopy section link

Sample response body Copy section linkCopy section link

Update program source Copy section linkCopy section link

Develop Now!

URL path parameters Copy section linkCopy section link

Body field details Copy section linkCopy section link

Sample request body Copy section linkCopy section link

Sample response body Copy section linkCopy section link

Create ACH program source Copy section linkCopy section link

Body field details Copy section linkCopy section link

Sample request body Copy section linkCopy section link

Sample response body Copy section linkCopy section link

Related Materials

Have any feedback on this page?

Create program source
Copy section link
Copy section link

Body field details
Copy section link
Copy section link

Sample request body
Copy section link
Copy section link

Sample response body
Copy section link
Copy section link

Retrieve program source
Copy section link
Copy section link

URL path parameters
Copy section link
Copy section link

Sample response body
Copy section link
Copy section link

Update program source
Copy section link
Copy section link

URL path parameters
Copy section link
Copy section link

Body field details
Copy section link
Copy section link

Sample request body
Copy section link
Copy section link

Sample response body
Copy section link
Copy section link

Create ACH program source
Copy section link
Copy section link

Body field details
Copy section link
Copy section link

Sample request body
Copy section link
Copy section link

Sample response body
Copy section link
Copy section link