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 subnetwork value of GATEWAY_JIT indicates 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_JIT indicates that the transaction was funded while Commando Mode was in effect. In addition, the standin_approved_by field has a value of COMMANDO_AUTO or COMMANDO_MANUAL when 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

Action: GET
Endpoint: /commandomodes Retrieve a list of Commando Mode control sets. This endpoint supports field filtering and pagination.

URL query parameters

Fields	Description
count integer Optional	Number of Commando Mode control sets to retrieve. Allowable Values: 1-10 Default value: 5
start_index integer Optional	Sort order index of the first resource in the returned array. Allowable Values: Any integer Default value: 0
sort_by string Optional	Field on which to sort. Use any field in the resource model, or one of the system fields `lastModifiedTime` or `createdTime`. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. Allowable Values: `createdTime`, `lastModifiedTime`, or any field in the resource model Default value: `-lastModifiedTime`

Response body

Fields	Description
count integer Conditionally returned	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 Conditionally returned	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 Conditionally returned	Defines program behavior when Commando Mode is enabled. Allowable Values: Existing `commando_mode_enables` object
data[].commando_mode_enables.auth_controls array of strings Conditionally returned	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 Conditionally returned	If set to `true`, transactions conducted while Commando Mode is enabled proceed even when the card is suspended. If set to `false`, transactions conducted while Commando Mode is enabled are declined if the card is suspended. Allowable Values: `true`, `false`
data[].commando_mode_enables.program_funding_source string Returned	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 Conditionally returned	This field is not currently in use. Allowable Values: N/A
data[].commando_mode_enables.velocity_controls array of strings Conditionally returned	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 `velocity_window` specified in that velocity control. For example, a `velocity_window` of `DAY` is one calendar day starting at 00:00:00 UTC. If a Commando Mode event occurs at 11:59:59 UTC, the `DAY` window includes all transactions that occurred between 00:00:00 and 11:59:59 on that calendar day. Allowable Values: One or more existing velocity control tokens
data[].created_time datetime Returned	Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ
data[].current_state object Conditionally returned	Describes the Commando Mode control set’s `current_state` object. Allowable Values: Existing `current_state` object
data[].current_state.channel string Returned	Mechanism that changed the Commando Mode control set’s state. Allowable Values: `API`, `SYSTEM`
data[].current_state.commando_enabled boolean Returned	Indicates whether Commando Mode is enabled. - If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode. - If `commando_enabled` is `true` and `COMMANDO_AUTO` is configured, Commando Mode is ready to intervene only when a transaction times out or encounters an error. Allowable Values: `true`, `false`
data[].current_state.reason string Conditionally returned	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 Conditionally returned	Identifies the user who last changed the Commando Mode control set’s state. Allowable Values: 255 char max
data[].last_modified_time datetime Returned	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 Conditionally returned	Unique identifier of the associated program gateway funding source. Allowable Values: Existing program gateway funding source token
data[].real_time_standin_criteria object Conditionally returned	Specifies which event types automatically enable Commando Mode. Allowable Values: Existing `real_time_standin_criteria` object
data[].real_time_standin_criteria.enabled boolean Conditionally returned	If set to `true`, Commando Mode is automatically enabled by events defined in the `real_time_standin_criteria` object. If set to `false`, Auto Commando Mode is not enabled. Allowable Values: `true`, `false`
data[].real_time_standin_criteria.include_application_errors boolean Conditionally returned	If set to `true`, an application error (any non-connection, non-timeout error) automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. Allowable Values: `true`, `false`
data[].real_time_standin_criteria.include_connection_errors boolean Conditionally returned	If set to `true`, a non-timeout connection error automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. Allowable Values: `true`, `false`
data[].real_time_standin_criteria.include_response_timeouts boolean Conditionally returned	If set to `true`, a gateway response slower than 3000ms automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. Allowable Values: `true`, `false`
data[].token string Conditionally returned	Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token
end_index integer Conditionally returned	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 Conditionally returned	A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist. This field is returned if there are resources in your returned array. Allowable Values: `true`, `false`
start_index integer Conditionally returned	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

Sample response body

JSON

{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "token": "commando_mode_1",
      "program_gateway_funding_source_token": "pgm_gateway_src_1",
      "current_state": {
        "commando_enabled": false,
        "reason": "New Commando Mode created",
        "channel": "SYSTEM"
      },
      "commando_mode_enables": {
        "program_funding_source": "pgm_funding_src_1",
        "velocity_controls": [
          "vel_control_1"
        ]
      },
      "created_time": "2023-02-14T18:48:10Z",
      "last_modified_time": "2023-02-14T18:48:10Z"
    }
  ]
}

Retrieve Commando Mode control set

Action: GET
Endpoint: /commandomodes/{token} Retrieve a specific Commando Mode control set.

URL path parameters

Fields	Description
token string Required	Unique identifier of the Commando Mode control set you want to retrieve. Allowable Values: Existing Commando Mode control set token

Response body

Fields	Description
commando_mode_enables object Conditionally returned	Defines program behavior when Commando Mode is enabled. Allowable Values: Existing `commando_mode_enables` object
commando_mode_enables.auth_controls array of strings Conditionally returned	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 Conditionally returned	If set to `true`, transactions conducted while Commando Mode is enabled proceed even when the card is suspended. If set to `false`, transactions conducted while Commando Mode is enabled are declined if the card is suspended. Allowable Values: `true`, `false`
commando_mode_enables.program_funding_source string Returned	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 Conditionally returned	This field is not currently in use. Allowable Values: N/A
commando_mode_enables.velocity_controls array of strings Conditionally returned	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 `velocity_window` specified in that velocity control. For example, a `velocity_window` of `DAY` is one calendar day starting at 00:00:00 UTC. If a Commando Mode event occurs at 11:59:59 UTC, the `DAY` window includes all transactions that occurred between 00:00:00 and 11:59:59 on that calendar day. Allowable Values: One or more existing velocity control tokens
created_time datetime Returned	Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ
current_state object Conditionally returned	Describes the Commando Mode control set’s `current_state` object. Allowable Values: Existing `current_state` object
current_state.channel string Returned	Mechanism that changed the Commando Mode control set’s state. Allowable Values: `API`, `SYSTEM`
current_state.commando_enabled boolean Returned	Indicates whether Commando Mode is enabled. - If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode. - If `commando_enabled` is `true` and `COMMANDO_AUTO` is configured, Commando Mode is ready to intervene only when a transaction times out or encounters an error. Allowable Values: `true`, `false`
current_state.reason string Conditionally returned	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 Conditionally returned	Identifies the user who last changed the Commando Mode control set’s state. Allowable Values: 255 char max
last_modified_time datetime Returned	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 Conditionally returned	Unique identifier of the associated program gateway funding source. Allowable Values: Existing program gateway funding source token
real_time_standin_criteria object Conditionally returned	Specifies which event types automatically enable Commando Mode. Allowable Values: Existing `real_time_standin_criteria` object
real_time_standin_criteria.enabled boolean Conditionally returned	If set to `true`, Commando Mode is automatically enabled by events defined in the `real_time_standin_criteria` object. If set to `false`, Auto Commando Mode is not enabled. Allowable Values: `true`, `false`
real_time_standin_criteria.include_application_errors boolean Conditionally returned	If set to `true`, an application error (any non-connection, non-timeout error) automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. Allowable Values: `true`, `false`
real_time_standin_criteria.include_connection_errors boolean Conditionally returned	If set to `true`, a non-timeout connection error automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. Allowable Values: `true`, `false`
real_time_standin_criteria.include_response_timeouts boolean Conditionally returned	If set to `true`, a gateway response slower than 3000ms automatically enables Commando Mode when `real_time_standin_criteria.enabled` is also `true`. Allowable Values: `true`, `false`
token string Conditionally returned	Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token

Sample response body

JSON

{
  "token": "commando_mode_1",
  "program_gateway_funding_source_token": "pgm_gateway_src_1",
  "current_state": {
    "commando_enabled": false,
    "reason": "New Commando Mode created",
    "channel": "SYSTEM"
  },
  "commando_mode_enables": {
    "program_funding_source": "pgm_funding_src_1",
    "velocity_controls": [
      "vel_control_1"
    ]
  },
  "created_time": "2023-02-14T18:48:10Z",
  "last_modified_time": "2023-02-14T18:48:10Z"
}

Retrieve Commando Mode transition

Action: GET
Endpoint: /commandomodes/transitions/{token} Retrieve a specific Commando Mode control set transition.

URL path parameters

Fields	Description
token string Required	Unique identifier of the Commando Mode control set transition. Allowable Values: Existing Commando Mode control set transition token

Response body

Fields	Description
commando_mode_token string Conditionally returned	Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token
created_time datetime Returned	Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ
name string Conditionally returned	Identifies the user who changed the Commando Mode control set’s state. Allowable Values: 255 char max
token string Conditionally returned	Unique identifier of the Command Mode control set transition object. Allowable Values: Existing Commando Mode control set transition object token
transition object Conditionally returned	Describes the Commando Mode control set’s `current_state` object. Allowable Values: Existing `current_state` object
transition.channel string Returned	Mechanism that changed the Commando Mode control set’s state. Allowable Values: `API`, `SYSTEM`
transition.commando_enabled boolean Returned	Indicates whether Commando Mode is enabled. - If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode. - If `commando_enabled` is `true` and `COMMANDO_AUTO` is configured, Commando Mode is ready to intervene only when a transaction times out or encounters an error. Allowable Values: `true`, `false`
transition.reason string Conditionally returned	Describes the reason why the current state of the Commando Mode control set was last changed. Allowable Values: 255 char max
transition.username string Conditionally returned	Identifies the user who last changed the Commando Mode control set’s state. Allowable Values: 255 char max
type string Conditionally returned	Specifies the type of event that triggered the Commando Mode transition, such as a `connection_error` or `response_timeout`. Allowable Values: 255 char max

Sample response body

JSON

{
  "token": "commando_mode_1_transition",
  "commando_mode_token": "commando_mode_1",
  "transition": {
    "commando_enabled": true,
    "reason": "Lost connection",
    "channel": "API",
    "user_name": "rhowse"
  },
  "created_time": "2023-02-14T18:48:10Z"
}

List Commando Mode transitions set

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

Fields	Description
commandomode_token string Required	Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token

URL query parameters

Fields	Description
count integer Optional	Number of Commando Mode control set transitions to retrieve. Allowable Values: 1-10 Default value: 5
start_index integer Optional	Sort order index of the first resource in the returned array. Allowable Values: Any integer Default value: 0
sort_by string Optional	Field on which to sort. Use any field in the resource model, or one of the system fields `lastModifiedTime` or `createdTime`. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. Allowable Values: `createdTime`, `lastModifiedTime`, or any field in the resource model Default value: `-createdTime`

Response body

Fields	Description
count integer Conditionally returned	Number of Commando Mode control set transition objects to retrieve. Allowable Values: 1-10
data array of objects Conditionally returned	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 Conditionally returned	Unique identifier of the Commando Mode control set. Allowable Values: Existing Commando Mode control set token
data[].created_time datetime Returned	Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ
data[].name string Conditionally returned	Identifies the user who changed the Commando Mode control set’s state. Allowable Values: 255 char max
data[].token string Conditionally returned	Unique identifier of the Command Mode control set transition object. Allowable Values: Existing Commando Mode control set transition object token
data[].transition object Conditionally returned	Describes the Commando Mode control set’s `current_state` object. Allowable Values: Existing `current_state` object
data[].transition.channel string Returned	Mechanism that changed the Commando Mode control set’s state. Allowable Values: `API`, `SYSTEM`
data[].transition.commando_enabled boolean Returned	Indicates whether Commando Mode is enabled. - If `commando_enabled` is `true` and `COMMANDO_MANUAL` is configured, all transactions are processed via Commando Mode. - If `commando_enabled` is `true` and `COMMANDO_AUTO` is configured, Commando Mode is ready to intervene only when a transaction times out or encounters an error. Allowable Values: `true`, `false`
data[].transition.reason string Conditionally returned	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 Conditionally returned	Identifies the user who last changed the Commando Mode control set’s state. Allowable Values: 255 char max
data[].type string Conditionally returned	Specifies the type of event that triggered the Commando Mode transition, such as a `connection_error` or `response_timeout`. Allowable Values: 255 char max
end_index integer Conditionally returned	Sort order index of the last resource in the returned array. Allowable Values: Any integer
is_more boolean Conditionally returned	Value of `true` indicates that more unreturned resources exist. Allowable Values: `true`, `false`
start_index integer Conditionally returned	Sort order index of the first resource in the returned array. Allowable Values: Any integer

Sample response body

JSON

{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "token": "commando_mode_1_transition",
      "commando_mode_token": "commando_mode_1",
      "transition": {
        "commando_enabled": true,
        "reason": "Lost connection",
        "channel": "API"
      },
      "user_name": "rhowse",
      "created_time": "2023-02-14T18:48:10Z"
    }
  ]
}

​List Commando Mode control sets

​URL query parameters

​Response body

​Sample response body

​Retrieve Commando Mode control set

​URL path parameters

​Response body

​Sample response body

​Retrieve Commando Mode transition

​URL path parameters

​Response body

​Sample response body

​List Commando Mode transitions set

​URL path parameters

​URL query parameters

​Response body

​Sample response body

List Commando Mode control sets

URL query parameters

Response body

Sample response body

Retrieve Commando Mode control set

URL path parameters

Response body

Sample response body

Retrieve Commando Mode transition

URL path parameters

Response body

Sample response body

List Commando Mode transitions set

URL path parameters

URL query parameters

Response body

Sample response body