Payment Sources
Use the payment sources endpoint to link an external payment source to an account on Marqeta’s credit platform. This enables account holders to use the linked payment source to make payments toward their account balance.
Create payment source
Copy section link
Action: POST
Endpoint: /credit/paymentsources
Create a payment source from which to make payments.
Request body
Copy section link
| Fields | Description |
|---|---|
token
string
|
Unique identifier of the payment source. Allowable Values: 36 char max |
user_token
string
|
Unique identifier of the user making the payment. Allowable Values: Existing user token |
account_token
string
|
Unique identifier of the credit account receiving the payment. Allowable Values: 36 char max Existing account token |
source_type
string
|
Type of payment source. Allowable Values:
|
name
string
|
Name of the individual or business who owns the payment source. Allowable Values: 255 char max |
account_number
string
|
Account number of the payment source. Allowable Values: 255 char max |
routing_number
string
|
Routing number of the payment source. Allowable Values: 255 char max |
owner
string
|
Type of payment source owner. Allowable Values:
|
verification_override
boolean
|
Whether to override the verification process. Allowable Values:
|
verification_notes
string
|
Additional information on the verification. Allowable Values: 255 char max |
Response body
Copy section link
| Fields | Description |
|---|---|
token
string
|
Unique identifier of the payment source. Allowable Values: 36 char max |
account_token
string
|
Unique identifier of the credit account receiving the payment. Allowable Values: 36 char max Existing account token |
user_token
string
|
Unique identifier of the user making the payment. Allowable Values: Existing user token |
created_time
datetime
|
Date and time when the payment source was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
last_modified_time
datetime
|
Date and time when the payment source was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
source_type
string
|
Type of payment source. Allowable Values:
|
name
string
|
Name of the individual or business who owns the payment source. Allowable Values: 255 char max |
owner
string
|
Type of payment source owner. Allowable Values:
|
verification_status
string
|
Status of the verification for the payment source. Allowable Values:
|
verification_notes
string
|
Additional information on the verification (for example, an external verification identifier that’s outside Marqeta’s credit platform). Allowable Values: 255 char max |
account_suffix
string
|
Last four digits of the payment source account number. Allowable Values: 4 char max |
routing_number
string
|
Routing number of the payment source. Allowable Values: 255 char max |
status
string
|
Current status of the payment source. Allowable Values:
|
List payment sources
Copy section link
Action: GET
Endpoint: /credit/paymentsources
Retrieve an array of payment sources.
This endpoint supports sorting and pagination.
URL query parameters
Copy section link
| Fields | Description |
|---|---|
account_token
string
|
The unique identifier of the credit account associated with the payment source. Allowable Values: Existing account token |
user_token
string
|
The unique identifier of the user associated with the payment source. Allowable Values: Existing user token |
count
integer
|
The number of resources to retrieve. Allowable Values: 1–100 |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: 0 min |
sort_by
string
|
Field on which to sort.
Prefix the field name with a hyphen ( NOTE:
You must sort using system field names such as Allowable Values:
|
Response body
Copy section link
| Fields | Description |
|---|---|
count
integer
|
Number of resources returned. Allowable Values: 1-10 |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: Any integer |
end_index
integer
|
Sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of Allowable Values:
|
data
array of objects
|
List of payment sources. Allowable Values: Valid array of one or more payment source objects |
data[].token
string
|
Unique identifier of the payment source. Allowable Values: 36 char max |
data[].account_token
string
|
Unique identifier of the credit account receiving the payment. Allowable Values: 36 char max Existing account token |
data[].user_token
string
|
Unique identifier of the user making the payment. Allowable Values: Existing user token |
data[].created_time
datetime
|
Date and time when the payment source was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].last_modified_time
datetime
|
Date and time when the payment source was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].source_type
string
|
Type of payment source. Allowable Values:
|
data[].name
string
|
Name of the individual or business who owns the payment source. Allowable Values: 255 char max |
data[].owner
string
|
Type of payment source owner. Allowable Values:
|
data[].verification_status
string
|
Status of the verification for the payment source. Allowable Values:
|
data[].verification_notes
string
|
Additional information on the verification (for example, an external verification identifier that’s outside Marqeta’s credit platform). Allowable Values: 255 char max |
data[].account_suffix
string
|
Last four digits of the payment source account number. Allowable Values: 4 char max |
data[].routing_number
string
|
Routing number of the payment source. Allowable Values: 255 char max |
data[].status
string
|
Current status of the payment source. Allowable Values:
|
Retrieve payment source
Copy section link
Action: GET
Endpoint: /credit/paymentsources/{token}
Retrieve a payment source.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
token
string
|
The unique identifier of the payment source to retrieve. Send a Allowable Values: Existing payment source token |
Response body
Copy section link
| Fields | Description |
|---|---|
token
string
|
Unique identifier of the payment source. Allowable Values: 36 char max |
account_token
string
|
Unique identifier of the credit account receiving the payment. Allowable Values: 36 char max Existing account token |
user_token
string
|
Unique identifier of the user making the payment. Allowable Values: Existing user token |
created_time
datetime
|
Date and time when the payment source was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
last_modified_time
datetime
|
Date and time when the payment source was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
source_type
string
|
Type of payment source. Allowable Values:
|
name
string
|
Name of the individual or business who owns the payment source. Allowable Values: 255 char max |
owner
string
|
Type of payment source owner. Allowable Values:
|
verification_status
string
|
Status of the verification for the payment source. Allowable Values:
|
verification_notes
string
|
Additional information on the verification (for example, an external verification identifier that’s outside Marqeta’s credit platform). Allowable Values: 255 char max |
account_suffix
string
|
Last four digits of the payment source account number. Allowable Values: 4 char max |
routing_number
string
|
Routing number of the payment source. Allowable Values: 255 char max |
status
string
|
Current status of the payment source. Allowable Values:
|
Update payment source
Copy section link
Action: PUT
Endpoint: /credit/paymentsources/{token}
Update details of a payment source.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
token
string
|
The unique identifier of the payment source to retrieve. Send a Allowable Values: Existing payment source token |
Request body
Copy section link
| Fields | Description |
|---|---|
status
string
|
Current status of the payment source. Allowable Values:
|
Response body
Copy section link
| Fields | Description |
|---|---|
token
string
|
Unique identifier of the payment source. Allowable Values: 36 char max |
account_token
string
|
Unique identifier of the credit account receiving the payment. Allowable Values: 36 char max Existing account token |
user_token
string
|
Unique identifier of the user making the payment. Allowable Values: Existing user token |
created_time
datetime
|
Date and time when the payment source was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
last_modified_time
datetime
|
Date and time when the payment source was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
source_type
string
|
Type of payment source. Allowable Values:
|
name
string
|
Name of the individual or business who owns the payment source. Allowable Values: 255 char max |
owner
string
|
Type of payment source owner. Allowable Values:
|
verification_status
string
|
Status of the verification for the payment source. Allowable Values:
|
verification_notes
string
|
Additional information on the verification (for example, an external verification identifier that’s outside Marqeta’s credit platform). Allowable Values: 255 char max |
account_suffix
string
|
Last four digits of the payment source account number. Allowable Values: 4 char max |
routing_number
string
|
Routing number of the payment source. Allowable Values: 255 char max |
status
string
|
Current status of the payment source. Allowable Values:
|