Commando Mode
Commando Mode is a fallback measure that ensures Gateway JIT-funded cards continue to function in the event that your system fails. If your system cannot respond to the JIT Funding request, the Marqeta platform makes a decision in your place based on defined business rules. The Marqeta platform stores any unsent webhooks for later transmission, ensuring that the card state and account balances on your system correspond with activity that occurred while Commando Mode was in effect.
You can identify transactions that were funded while Commando Mode was in effect by examining the subnetwork field of the transaction record.
-
A
subnetworkvalue ofGATEWAY_JITindicates that the transaction was funded through normal Gateway JIT Funding and that Commando Mode was not in effect at the time. -
A value of
MANAGED_JITindicates that the transaction was funded while Commando Mode was in effect. In addition, thestandin_approved_byfield has a value ofCOMMANDO_AUTOorCOMMANDO_MANUALwhen Commando Mode is enabled for a transaction.
When COMMANDO_MANUAL is configured, all transactions are processed via Commando Mode.
When COMMANDO_AUTO is configured, Commando Mode is enabled only when a transaction times out or encounters an error.
While Commando Mode is a form of Stand-in Processing (STIP), it is different than network STIP.
Network STIP occurs when the card network cannot communicate with the Marqeta platform.
Transactions handled by network STIP include the standin_approved_by field with a value of NETWORK.
Commando Mode and Managed JIT Funding are functionally equivalent. See About Just-in-Time Funding for more information.
Note
Commando Mode requires additional configuration. To configure Commando Mode control sets, contact your Marqeta representative.
List Commando Mode control sets
Copy section link
Action: GET
Endpoint: /commandomodes
Retrieve a list of Commando Mode control sets.
This endpoint supports field filtering and pagination.
URL query parameters
Copy section link
| Fields | Description |
|---|---|
count
integer
|
Number of Commando Mode control sets to retrieve. Allowable Values: 1-10 Default value: |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: Any integer Default value: |
sort_by
string
|
Field on which to sort.
Use any field in the resource model, or one of the system fields Allowable Values:
Default value: |
Response body
Copy section link
| Fields | Description |
|---|---|
count
integer
|
Number of Commando Mode control sets to retrieve. This field is returned if there are resources in your returned array. Allowable Values: 1-10 |
data
array of objects
|
Array of Commando Mode control set objects. Objects are returned as appropriate to your query. Allowable Values: Valid array of one or more Commando Mode control set objects |
data[].commando_mode_enables
object
|
Defines program behavior when Commando Mode is enabled. Allowable Values: Existing |
data[].commando_mode_enables.auth_controls
array of strings
|
Unique identifiers of the authorization controls enabled while in Commando Mode. Allowable Values: Valid array of one or more existing authorization control tokens |
data[].commando_mode_enables.ignore_card_suspended_state
boolean
|
If set to Allowable Values:
|
data[].commando_mode_enables.program_funding_source
string
|
Unique identifier of the program funding source that substitutes for the program gateway funding source upon Commando Mode enablement. Allowable Values: 36 char max |
data[].commando_mode_enables.use_cache_balance
boolean
|
This field is not currently in use. Allowable Values: N/A |
data[].commando_mode_enables.velocity_controls
array of strings
|
Unique identifiers of the velocity controls enabled while in Commando Mode. Velocity controls that are enabled in Commando Mode are inactive until a Commando Mode event occurs.
When Commando Mode velocity controls are activated, they conform to the Allowable Values: One or more existing velocity control tokens |
data[].created_time
datetime
|
Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].current_state
object
|
Describes the Commando Mode control set’s Allowable Values: Existing |
data[].current_state.channel
string
|
Mechanism that changed the Commando Mode control set’s state. Allowable Values:
|
data[].current_state.commando_enabled
boolean
|
Indicates whether Commando Mode is enabled.
Allowable Values:
|
data[].current_state.reason
string
|
Describes the reason why the current state of the Commando Mode control set was last changed. Allowable Values: 255 char max |
data[].current_state.username
string
|
Identifies the user who last changed the Commando Mode control set’s state. Allowable Values: 255 char max |
data[].last_modified_time
datetime
|
Date and time when the resource was last updated, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].program_gateway_funding_source_token
string
|
Unique identifier of the associated program gateway funding source. Allowable Values: Existing program gateway funding source token |
data[].real_time_standin_criteria
object
|
Specifies which event types automatically enable Commando Mode. Allowable Values: Existing |
data[].real_time_standin_criteria.enabled
boolean
|
If set to Allowable Values:
|
data[].real_time_standin_criteria.include_application_errors
boolean
|
If set to Allowable Values:
|
data[].real_time_standin_criteria.include_connection_errors
boolean
|
If set to Allowable Values:
|
data[].real_time_standin_criteria.include_response_timeouts
boolean
|
If set to Allowable Values:
|
data[].token
string
|
Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token |
end_index
integer
|
Sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of This field is returned if there are resources in your returned array. Allowable Values:
|
start_index
integer
|
Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
Retrieve Commando Mode control set
Copy section link
Action: GET
Endpoint: /commandomodes/{token}
Retrieve a specific Commando Mode control set.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
token
string
|
Unique identifier of the Commando Mode control set you want to retrieve. Allowable Values: Existing Commando Mode control set token |
Response body
Copy section link
| Fields | Description |
|---|---|
commando_mode_enables
object
|
Defines program behavior when Commando Mode is enabled. Allowable Values: Existing |
commando_mode_enables.auth_controls
array of strings
|
Unique identifiers of the authorization controls enabled while in Commando Mode. Allowable Values: Valid array of one or more existing authorization control tokens |
commando_mode_enables.ignore_card_suspended_state
boolean
|
If set to Allowable Values:
|
commando_mode_enables.program_funding_source
string
|
Unique identifier of the program funding source that substitutes for the program gateway funding source upon Commando Mode enablement. Allowable Values: 36 char max |
commando_mode_enables.use_cache_balance
boolean
|
This field is not currently in use. Allowable Values: N/A |
commando_mode_enables.velocity_controls
array of strings
|
Unique identifiers of the velocity controls enabled while in Commando Mode. Velocity controls that are enabled in Commando Mode are inactive until a Commando Mode event occurs.
When Commando Mode velocity controls are activated, they conform to the Allowable Values: One or more existing velocity control tokens |
created_time
datetime
|
Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
current_state
object
|
Describes the Commando Mode control set’s Allowable Values: Existing |
current_state.channel
string
|
Mechanism that changed the Commando Mode control set’s state. Allowable Values:
|
current_state.commando_enabled
boolean
|
Indicates whether Commando Mode is enabled.
Allowable Values:
|
current_state.reason
string
|
Describes the reason why the current state of the Commando Mode control set was last changed. Allowable Values: 255 char max |
current_state.username
string
|
Identifies the user who last changed the Commando Mode control set’s state. Allowable Values: 255 char max |
last_modified_time
datetime
|
Date and time when the resource was last updated, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
program_gateway_funding_source_token
string
|
Unique identifier of the associated program gateway funding source. Allowable Values: Existing program gateway funding source token |
real_time_standin_criteria
object
|
Specifies which event types automatically enable Commando Mode. Allowable Values: Existing |
real_time_standin_criteria.enabled
boolean
|
If set to Allowable Values:
|
real_time_standin_criteria.include_application_errors
boolean
|
If set to Allowable Values:
|
real_time_standin_criteria.include_connection_errors
boolean
|
If set to Allowable Values:
|
real_time_standin_criteria.include_response_timeouts
boolean
|
If set to Allowable Values:
|
token
string
|
Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token |
Retrieve Commando Mode transition
Copy section link
Action: GET
Endpoint: /commandomodes/transitions/{token}
Retrieve a specific Commando Mode control set transition.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
token
string
|
Unique identifier of the Commando Mode control set transition. Allowable Values: Existing Commando Mode control set transition token |
Response body
Copy section link
| Fields | Description |
|---|---|
commando_mode_token
string
|
Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token |
created_time
datetime
|
Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
name
string
|
Identifies the user who changed the Commando Mode control set’s state. Allowable Values: 255 char max |
token
string
|
Unique identifier of the Command Mode control set transition object. Allowable Values: Existing Commando Mode control set transition object token |
transition
object
|
Describes the Commando Mode control set’s Allowable Values: Existing |
transition.channel
string
|
Mechanism that changed the Commando Mode control set’s state. Allowable Values:
|
transition.commando_enabled
boolean
|
Indicates whether Commando Mode is enabled.
Allowable Values:
|
transition.reason
string
|
Describes the reason why the current state of the Commando Mode control set was last changed. Allowable Values: 255 char max |
transition.username
string
|
Identifies the user who last changed the Commando Mode control set’s state. Allowable Values: 255 char max |
type
string
|
Specifies the type of event that triggered the Commando Mode transition, such as a Allowable Values: 255 char max |
List Commando Mode transitions set
Copy section link
Action: GET
Endpoint: /commandomodes/{commandomode_token}/transitions
Retrieve a list of Commando Mode transitions for a specific control set.
This endpoint supports field filtering and pagination.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
commandomode_token
string
|
Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token |
URL query parameters
Copy section link
| Fields | Description |
|---|---|
count
integer
|
Number of Commando Mode control set transitions to retrieve. Allowable Values: 1-10 Default value: |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: Any integer Default value: |
sort_by
string
|
Field on which to sort.
Use any field in the resource model, or one of the system fields Allowable Values:
Default value: |
Response body
Copy section link
| Fields | Description |
|---|---|
count
integer
|
Number of Commando Mode control set transition objects to retrieve. Allowable Values: 1-10 |
data
array of objects
|
Array of Commando Mode control set transition objects. Allowable Values: Valid array of one or more Commando Mode control set transition objects |
data[].commando_mode_token
string
|
Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token |
data[].created_time
datetime
|
Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].name
string
|
Identifies the user who changed the Commando Mode control set’s state. Allowable Values: 255 char max |
data[].token
string
|
Unique identifier of the Command Mode control set transition object. Allowable Values: Existing Commando Mode control set transition object token |
data[].transition
object
|
Describes the Commando Mode control set’s Allowable Values: Existing |
data[].transition.channel
string
|
Mechanism that changed the Commando Mode control set’s state. Allowable Values:
|
data[].transition.commando_enabled
boolean
|
Indicates whether Commando Mode is enabled.
Allowable Values:
|
data[].transition.reason
string
|
Describes the reason why the current state of the Commando Mode control set was last changed. Allowable Values: 255 char max |
data[].transition.username
string
|
Identifies the user who last changed the Commando Mode control set’s state. Allowable Values: 255 char max |
data[].type
string
|
Specifies the type of event that triggered the Commando Mode transition, such as a Allowable Values: 255 char max |
end_index
integer
|
Sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
Value of Allowable Values:
|
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: Any integer |