/
15 minute read
March 28, 2022

Commando Mode

Hidden

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

The number of Commando Mode control sets to retrieve.

Allowable Values:

1-10

start_index

integer
Optional

The sort order index of the first resource in the returned array.

Allowable Values:

Any integer

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:

lastModifiedTime, createdTime, or any field in the resource model

Response body
Fields Description

count

integer
Conditionally returned

The number of Commando Mode control sets to retrieve.

Allowable Values:

1-10

data

array of objects
Conditionally returned

An array of Commando Mode control set objects.

Allowable Values:

Valid data array

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

The unique identifiers of the authorization controls enabled while in Commando Mode.

Allowable Values:

Valid auth_controls array

data[].commando_mode_enables.ignore_card_suspended_state

boolean
Conditionally returned

If true, transactions conducted while in Commando Mode proceed even when the card is suspended; if 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

The 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 in use.

Allowable Values:

N/A

data[].commando_mode_enables.velocity_controls

array of strings
Conditionally returned

The unique identifiers of the velocity controls enabled while in Commando Mode.

Allowable Values:

Valid velocity_controls array

data[].created_time

datetime
Returned

The date and time when the resource was created, in UTC.

Allowable Values:

Format: yyyy-MM-ddTHH:mm:ssZ

data[].current_state

object
Conditionally returned

The current state of the Commando Mode control set.

Allowable Values:

Existing current_state object

data[].current_state.channel

string
Returned

The 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

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

The user who last changed the Commando Mode control set’s state.

Allowable Values:

255 char max

data[].last_modified_time

datetime
Returned

The 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

The 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

The event types that automatically enable Commando Mode.

Allowable Values:

Existing real_time_standin_criteria object

data[].real_time_standin_criteria.enabled

boolean
Conditionally returned

If true, Commando Mode is automatically enabled by events defined in the real_time_standin_criteria object; if false, Auto Commando Mode is not enabled.

Allowable Values:

true, false

data[].real_time_standin_criteria.include_application_errors

boolean
Conditionally returned

If 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 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 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

The unique identifier of the Commando Mode control set.

Allowable Values:

Existing Commando Mode control set token

end_index

integer
Conditionally returned

The sort order index of the last resource in the returned array.

Allowable Values:

Any integer

is_more

boolean
Conditionally returned

A value of true indicates that more unreturned resources exist.

Allowable Values:

true, false

start_index

integer
Conditionally returned

The 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

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

The 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

The unique identifiers of the authorization controls enabled while in Commando Mode.

Allowable Values:

Valid auth_controls array

commando_mode_enables.ignore_card_suspended_state

boolean
Conditionally returned

If true, transactions conducted while in Commando Mode proceed even when the card is suspended; if 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

The 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 not in use.

Allowable Values:

N/A

commando_mode_enables.velocity_controls

array of strings
Conditionally returned

The unique identifiers of the velocity controls enabled while in Commando Mode.

Allowable Values:

Valid velocity_controls array

created_time

datetime
Returned

The date and time when the resource was created, in UTC.

Allowable Values:

Format: yyyy-MM-ddTHH:mm:ssZ

current_state

object
Conditionally returned

The current state of the Commando Mode control set.

Allowable Values:

Existing current_state object

current_state.channel

string
Returned

The 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

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

The 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

The 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 true, Commando Mode is automatically enabled by events defined in the real_time_standin_criteria object; if false, Auto Commando Mode is not enabled.

Allowable Values:

true, false

real_time_standin_criteria.include_application_errors

boolean
Conditionally returned

If 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 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 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

The 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

The 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

The unique identifier of the Commando Mode control set.

Allowable Values:

Existing Commando Mode control set token

created_time

datetime
Returned

The 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

The unique identifier of the Command Mode control set transition object.

Allowable Values:

Existing Commando Mode control set transition object token

transition

object
Conditionally returned

The current state of the Commando Mode control set.

Allowable Values:

Existing current_state object

transition.channel

string
Returned

The 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

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

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

The unique identifier of the Commando Mode control set.

Allowable Values:

Existing Commando Mode control set token

URL query parameters
Fields Description

count

integer
Optional

The number of Commando Mode control set transitions to retrieve.

Allowable Values:

1-10

start_index

integer
Optional

The sort order index of the first resource in the returned array.

Allowable Values:

Any integer

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:

lastModifiedTime, createdTime, or any field in the resource model

Response body
Fields Description

count

integer
Conditionally returned

The number of Commando Mode control set transition objects to retrieve.

Allowable Values:

1-10

data

array of objects
Conditionally returned

An array of Commando Mode control set transition objects.

Allowable Values:

Valid data array

data[].commando_mode_token

string
Conditionally returned

The unique identifier of the Commando Mode control set.

Allowable Values:

Existing Commando Mode control set token

data[].created_time

datetime
Returned

The date and time when the resource was created, in UTC.

Allowable Values:

Format: yyyy-MM-ddTHH:mm:ssZ

data[].name

string
Conditionally returned

The user who changed the Commando Mode control set’s state.

Allowable Values:

255 char max

data[].token

string
Conditionally returned

The 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

The current state of the Commando Mode control set.

Allowable Values:

Existing current_state object

data[].transition.channel

string
Returned

The 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

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

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

The sort order index of the last resource in the returned array.

Allowable Values:

Any integer

is_more

boolean
Conditionally returned

A value of true indicates that more unreturned resources exist.

Allowable Values:

true, false

start_index

integer
Conditionally returned

The 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
Join our developer newsletter