/
20 minute read
March 17, 2023

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
Copied

Is this helpful?

Yes
No

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
Copied

Is this helpful?

Yes
No

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
Copied

Is this helpful?

Yes
No

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
Copied

Is this helpful?

Yes
No

Subscribe to our developer newsletter