POST//
Create a payment source from which to make payments.
Request body
| Fields | Description |
|---|---|
| token string Optional | Unique identifier of the payment source. Allowable Values: 36 char max |
| user_token string Optional | Unique identifier of the user making the payment. Allowable Values: 36 char max Existing user token |
| business_token string Optional | Unique identifier of the business making the payment. Allowable Values: 36 char max Existing business token |
| account_token string Required | Unique identifier of the credit account receiving the payment. Allowable Values: 36 char max Existing account token |
| source_type string Required | Type of payment source. Allowable Values: CHECKING, SAVINGS, SECURE_ACCOUNT_FUND, OTHER, EXTERNAL |
| name string Required | Name of the individual or business who owns the payment source. Allowable Values: 255 char max |
| account_number string Required | Account number of the payment source. Allowable Values: 255 char max |
| routing_number string Optional | Routing number of the payment source. This field is only optional when the value for source_type is SECURE_ACCOUNT_FUND.Allowable Values: 255 char max |
| owner string Optional | Type of payment source owner. Allowable Values: INDIVIDUAL, BUSINESS |
| verification_override boolean Required | Whether to override the verification process. Allowable Values: true, false |
| verification_notes string Optional | Additional information on the verification. Allowable Values: 255 char max |
| bank_name string Optional | Name of the bank associated with the routing number. Allowable Values: 255 char max |
Sample request body
JSON
{
"token": "my_payment_source_token_6789",
"account_token": "my_account_token_12",
"user_token": "user5678",
"source_type": "CHECKING",
"name": "John Jacob",
"owner": "INDIVIDUAL",
"account_number": "4567_payment_source_account_number",
"routing_number": "56789_payment_source_routing_number",
"verification_override": true
}
Response body
| Fields | Description |
|---|---|
| token string Conditionally returned | Unique identifier of the payment source. Allowable Values: 36 char max |
| account_token string Conditionally returned | Unique identifier of the credit account receiving the payment. Allowable Values: 36 char max Existing account token |
| user_token string Conditionally returned | Unique identifier of the user making the payment. Allowable Values: Existing user token |
| business_token string Conditionally returned | Unique identifier of the business making the payment. Allowable Values: Existing business token |
| created_time datetime Conditionally returned | 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 Conditionally returned | 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 Conditionally returned | Type of payment source. Allowable Values: CHECKING, SAVINGS, SECURE_ACCOUNT_FUND, OTHER, EXTERNAL |
| name string Conditionally returned | Name of the individual or business who owns the payment source. Allowable Values: 255 char max |
| owner string Conditionally returned | Type of payment source owner. Allowable Values: INDIVIDUAL, BUSINESS |
| verification_status string Conditionally returned | Status of the verification for the payment source. Allowable Values: ACH_VERIFIED, PENDING |
| verification_notes string Conditionally returned | 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 Conditionally returned | Last four digits of the payment source account number. Allowable Values: 4 char max |
| routing_number string Conditionally returned | Routing number of the payment source. Allowable Values: 255 char max |
| bank_name string Conditionally returned | Name of the bank associated with the routing number. Allowable Values: 255 char max |
| status string Conditionally returned | Current status of the payment source. Allowable Values: ACTIVE, PENDING, INACTIVE |
Sample response body
JSON
{
"token": "my_payment_source_token_6789",
"account_token": "my_account_token_12",
"user_token": "user5678",
"created_time": "2025-05-19T19:19:24Z",
"last_modified_time": "2025-05-19T19:19:24Z",
"source_type": "CHECKING",
"name": "John Jacob",
"owner": "INDIVIDUAL",
"verification_status": "ACH_VERIFIED",
"account_suffix": "5678",
"routing_number": "payment_source_routing_number",
"status": "ACTIVE"
}