Skip to main content
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

FieldsDescription
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

FieldsDescription
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

FieldsDescription
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

FieldsDescription
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

FieldsDescription
token

string

Required		Unique identifier of the Commando Mode control set transition.

Allowable Values:

Existing Commando Mode control set transition token

​
Response body

FieldsDescription
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

FieldsDescription
commandomode_token

string

Required		Unique identifier of the Commando Mode control set.

Allowable Values:

Existing Commando Mode control set token

​
URL query parameters

FieldsDescription
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

FieldsDescription
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"
    }
  ]
}

Related topics

Commando Mode AddendumControl Center in the Marqeta DashboardError Handling in EuropeErrorsDashboard Overview and Quick Start