# Sandbox Testing
source: https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/index.md

## Overview {#overview}

The section describes all use cases that can be tested using the Sandbox environment. The Sandbox contains limited-capacity mock APIs, enabling you to try the APIs quickly to assist with initial integration and solution development. The Sandbox returns mock responses for a defined request. Particular values in the request body, such as path parameters or fields, will give specific predefined responses.
Note: At the beginning of each test case, there might be information (in the form of a table) that you must use in the request to execute the test case. The table displays specific values that are preconfigured in the Sandbox. Otherwise, you can send any values in the request, and the Sandbox will always return the same mock response.

The following test cases are provided:


|                                                                                                           Test case                                                                                                           |                                  Test case scenario                                   |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------|
| [Order a Virtual Card -- create client, account contract, and cord contract](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/order-virtual-card/index.md) | Success -- Step 1 Create a Client                                                     |
|                                                                                                                                                                                                                               | Success -- Step 2 Create an Account Contract                                          |
|                                                                                                                                                                                                                               | Success -- Step 3 Create a Card Contract                                              |
|                                                                                                                                                                                                                               | Fail -- Step 1 Create a Client with a duplicated clientNumber                         |
|                                                                                                                                                                                                                               | Fail -- Step 1 Create a Client with a duplicated socialNumber                         |
|                                                                                                                                                                                                                               | Fail -- Step 1 Create a Client with a duplicated taxpayer identifier                  |
|                                                                                                                                                                                                                               | Fail -- Step 2 Create an Account Contract with a duplicated accountContractNumber     |
|                                                                                                                                                                                                                               | Fail -- Step 2 Create an Account Contract with a duplicated cbsNumber                 |
|                                                                                                                                                                                                                               | Fail -- Step 3 Create a Card with an invalid BIN range                                |
|                                                                                                                                                                                                                               | Fail -- Step 3 Create a Card with a duplicated cbsNumber                              |
|                                                                                                                                                                                                                               | Fail -- Step 3 Create a Card with an invalid productionCode                           |
|                                                                                                                                                                                                                               | Fail -- Step 3 Create a Card with an invalid branch code                              |
|                                                                                                                                                                                                                               | Fail -- Step 3 Create a Card with an invalid PAN (Luhn check failed)                  |
| [Order a Physical Card to a Virtual Card](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/order-phy-card-to-virtual-card/index.md)                        | Success                                                                               |
|                                                                                                                                                                                                                               | Fail -- PIN is not set                                                                |
|                                                                                                                                                                                                                               | Fail -- Reissue type not supported                                                    |
|                                                                                                                                                                                                                               | Fail -- Wrong Card status                                                             |
| [Replace a Card](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/replace-card/index.md)                                                                   | Success -- Replace a Card with a Virtual Card                                         |
|                                                                                                                                                                                                                               | Success -- Replace a Card with a Virtual Card that inherits the PIN from the old Card |
|                                                                                                                                                                                                                               | Success -- Replace a Card with a Physical Card                                        |
|                                                                                                                                                                                                                               | Fail -- Reissue type not supported                                                    |
| [Renew a Card](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/renew-card/index.md)                                                                       | Success -- Renew a Card with a Virtual Card                                           |
|                                                                                                                                                                                                                               | Success -- Renew a Card with a Physical Card                                          |
|                                                                                                                                                                                                                               | Fail -- Reissue type not supported                                                    |
| [Activate a Card](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/activate-card/index.md)                                                                 | Success                                                                               |
|                                                                                                                                                                                                                               | Fail -- Activate before personalization process                                       |
| [Display a Card details to the cardholder](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/display-card-details-to-cardholder/index.md)                   | Success                                                                               |
|                                                                                                                                                                                                                               | Fail -- Provide incorrect cardContractId                                              |
| [Set or update authentication method](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/set-update-auth-method/index.md)                                    | Success                                                                               |
|                                                                                                                                                                                                                               | Fail -- Invalid authentication type code                                              |
|                                                                                                                                                                                                                               | Fail -- Invalid authentication parameter name                                         |
| [Verify Card details (PAN, expiry date, and CVC2)](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/set-update-auth-method/index.md)                       | Success                                                                               |
|                                                                                                                                                                                                                               | Success -- PAN is not in the active state                                             |
|                                                                                                                                                                                                                               | Success -- Incorrect CVC2                                                             |
|                                                                                                                                                                                                                               | Success -- Incorrect expiry date                                                      |
|                                                                                                                                                                                                                               | Success -- CVC2 and expiry date not provided                                          |
|                                                                                                                                                                                                                               | Fail -- Not existing Card Contract                                                    |
| [Verify CVC2](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/verify-cvc2/index.md)                                                                       | Success - Correct CVC2                                                                |
|                                                                                                                                                                                                                               | Success -- Incorrect CVC2                                                             |
|                                                                                                                                                                                                                               | Fail -- Invalid card expiry date                                                      |
| [Change a Card status](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/change-card-status/index.md)                                                       | Success                                                                               |
|                                                                                                                                                                                                                               | Fail -- Change a status to the one with the lower priority                            |
|                                                                                                                                                                                                                               | Fail -- Invalid statusCode                                                            |
| [Close an Account](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/close-account/index.md)                                                                | Success                                                                               |
|                                                                                                                                                                                                                               | Fail -- Invalid statusCode                                                            |
| [Open an Event](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/open-event/index.md)                                                                      | Success                                                                               |
|                                                                                                                                                                                                                               | Fail -- Invalid eventCode                                                             |
|                                                                                                                                                                                                                               | Fail -- Amount, currency, and parameterString are filled                              |
| [Set Service Limit Tariff](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/card-lifecycle-management/set-service-limit-tariff/index.md)                                             | Success                                                                               |

|                                                                                       Test case                                                                                        |                       Test case scenario                        |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------|
| [Set a PIN for a Full PAN Issuer](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/pin-management/set-pin-for-full-pan-issuer/index.md)       | Success                                                         |
|                                                                                                                                                                                        | Failure -- Invalid PIN block                                    |
|                                                                                                                                                                                        | Fail -- Incorrect Card expiry date                              |
| [Set a PIN for a PAN-less Issuer](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/pin-management/set-pin-for-panless-issuer/index.md)        | Success                                                         |
|                                                                                                                                                                                        | Failure -- Invalid PIN block                                    |
|                                                                                                                                                                                        | Fail -- Incorrect Card expiry date                              |
| [Order a PIN Reprint](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/pin-management/order-pin-reprint/index.md)                             | Success                                                         |
| [Verify a PIN for a Full PAN Issuer](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/pin-management/verify-pin-for-full-pan-issuer/index.md) | Success                                                         |
|                                                                                                                                                                                        | Success -- Incorrect PIN                                        |
|                                                                                                                                                                                        | Success -- Incorrect PIN block                                  |
|                                                                                                                                                                                        | Fail -- Incorrect Card expiry date                              |
| [Verify a PIN for a PAN-less Issuer](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/pin-management/verify-pin-for-panless-issuer/index.md)  | Success                                                         |
|                                                                                                                                                                                        | Success -- Incorrect PIN                                        |
|                                                                                                                                                                                        | Success -- Incorrect PIN block                                  |
|                                                                                                                                                                                        | Fail -- Incorrect Card expiry date                              |
| [Display a PIN](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/pin-management/display-pin/index.md)                                         | Success                                                         |
|                                                                                                                                                                                        | Fail -- PIN not found                                           |
|                                                                                                                                                                                        | Fail -- Incorrect Card expiry date                              |
| [Clear the online PIN try counter](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/pin-management/clear-online-pin-try-counter/index.md)     | Success -- Clear the online PIN try counter for a Client        |
|                                                                                                                                                                                        | Success -- Clear the online PIN try counter for a Card Contract |

|                                                                                                        Test case                                                                                                        |                                  Test case scenario                                  |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|
| [Update Client data](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/update-client-data/index.md)                                                             | Success                                                                              |
|                                                                                                                                                                                                                         | Fail -- Duplicated social number                                                     |
|                                                                                                                                                                                                                         | Fail -- Duplicated taxpayer identifier                                               |
| [Update Account Contract data](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/update-acc-contract-data/index.md)                                             | Success                                                                              |
|                                                                                                                                                                                                                         | Fail -- Duplicated cbsNumber                                                         |
|                                                                                                                                                                                                                         | Fail -- Not an Account Contract                                                      |
| [Update Card Contract data](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/update-card-contract-data/index.md)                                               | Success                                                                              |
|                                                                                                                                                                                                                         | Fail -- Duplicated cbsNumber                                                         |
| [Relink Account Contract to another Client](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/relink-acc-con-to-another-client/index.md)                        | Success                                                                              |
| [Relink Subaccount to another parent Account Contract and Client](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/relink-subacct-to-parent-acct-con/index.md) | Success                                                                              |
| [Relink Card Contract to another Client](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/relink-card-con-to-another-client/index.md)                          | Success                                                                              |
| [Relink Card Contract to another Account Contract](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/relink-card-con-to-acct-con/index.md)                      | Success                                                                              |
| [Add or update Custom Data](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/add-update-custom-data/index.md)                                                  | Success -- Add Custom Data for a Client                                              |
|                                                                                                                                                                                                                         | Success -- Remove Custom Data for a Client                                           |
|                                                                                                                                                                                                                         | Success -- Add Custom Data for a Contract                                            |
|                                                                                                                                                                                                                         | Success -- Remove Custom Data for a Contract                                         |
| [Add an Address](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/add-address/index.md)                                                                        | Success -- Create additional Address for a Client                                    |
|                                                                                                                                                                                                                         | Success -- Create an Address for a Contract                                          |
| [Update an Address](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/update-address/index.md)                                                                  | Success -- Update a Client's Address                                                 |
|                                                                                                                                                                                                                         | Fail -- Update additional Address for a Client -- invalid address type               |
|                                                                                                                                                                                                                         | Fail -- Update additional Address for a Client -- disabling already disabled address |
|                                                                                                                                                                                                                         | Success -- Update an Address for a Contract                                          |
|                                                                                                                                                                                                                         | Fail -- Update an Address for a Contract -- invalid address type                     |
|                                                                                                                                                                                                                         | Fail -- Update an Address for a Contract -- disabling already disabled address       |

|                                                                                                                      Test case                                                                                                                      |                     Test case scenario                      |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------|
| [Retrieve Client data](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-client-data/index.md)                                                    | Success                                                     |
| [Retrieve Account Contract data](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-acc-contract-data/index.md)                                    | Success                                                     |
| [Retrieve a list of Card Plastics](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-list-of-card-plastics/index.md)                              | Success                                                     |
| [Retrieve CVC2](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-cvc2/index.md)                                                                  | Success                                                     |
|                                                                                                                                                                                                                                                     | Fail - Invalid expiry date                                  |
| [Retrieve a list of Account Contracts for a Client](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-list-acct-con-for-client/index.md)          | Success                                                     |
|                                                                                                                                                                                                                                                     | Success - No Account Contracts linked to a Client           |
| [Retrieve a list of Card Contracts for a Client](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-list-card-con-for-client/index.md)             | Success                                                     |
|                                                                                                                                                                                                                                                     | Success - No Card Contracts linked to a Client              |
| [Retrieve technical Accounts](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-technical-acc/index.md)                                           | Success                                                     |
|                                                                                                                                                                                                                                                     | Success - Invalid technical account code                    |
| [Retrieve Contract tree structure summary](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-con-tree-struct-sum/index.md)                        | Success -- Tree structure for a top Account Contract        |
|                                                                                                                                                                                                                                                     | Success -- Tree structure for a Subaccount                  |
|                                                                                                                                                                                                                                                     | Success -- Tree structure for a Card Contract               |
|                                                                                                                                                                                                                                                     | Success -- No tree structure                                |
| [Retrieve Account Contract or Card Contract status](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-acc-con-card-con-status/index.md)           | Success -- Retrieve Account Contract status                 |
|                                                                                                                                                                                                                                                     | Success - Retrieve Card Contract status                     |
| [Retrieve Subaccounts](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-subaccounts/index.md)                                                    | Success                                                     |
|                                                                                                                                                                                                                                                     | Success -- No Subaccounts                                   |
| [Retrieve a list of Card Contracts for an Account Contract](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-list-card-con-for-acc-con/index.md) | Success                                                     |
|                                                                                                                                                                                                                                                     | Success -- No Card Contracts linked to the Account Contract |
| [Retrieve Custom Data](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-custom-data/index.md)                                                    | Success -- Retrieve Custom Data for a Client                |
|                                                                                                                                                                                                                                                     | Fail -- Invalid Client's tag name                           |
|                                                                                                                                                                                                                                                     | Success -- Retrieve Custom Data for a Contract              |
|                                                                                                                                                                                                                                                     | Fail -- Invalid Contract's tag name                         |
| [Retrieve Addresses](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-addresses/index.md)                                                        | Success -- Retrieve additional Addresses for a Client       |
|                                                                                                                                                                                                                                                     | Success -- No additional Addresses for a Client             |
|                                                                                                                                                                                                                                                     | Success -- Retrieve Addresses for a Contract                |
|                                                                                                                                                                                                                                                     | Success -- No Addresses for a Contract                      |
| [Retrieve financial information](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-financial-info/index.md)                                       | Success                                                     |
| [Retrieve Contract's balances](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-con-balances/index.md)                                           | Success                                                     |
| [Retrieve authentication parameter's value](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-auth-param-value/index.md)                          | Success                                                     |
|                                                                                                                                                                                                                                                     | Fail -- Invalid authentication parameter name               |
|                                                                                                                                                                                                                                                     | Fail -- Invalid authentication type code                    |
| [Retrieve Tariffs configuration](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/data-management/query-cms-to-get-particular-data/retrieve-auth-param-value/index.md)                                     | Success                                                     |
|                                                                                                                                                                                                                                                     | Success -- No tariffs                                       |

|                                                                                       Test case                                                                                       |               Test case scenario               |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|
| [Set Classifier](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/classifiers-and-parameters-management/set-classifier/index.md)             | Success -- Set Classifier for a Client         |
|                                                                                                                                                                                       | Success -- Set Classifier for a Contract       |
|                                                                                                                                                                                       | Fail -- Invalid Contract's classifier code     |
|                                                                                                                                                                                       | Fail -- Invalid Contract's classifier value    |
| [Retrieve Classifiers](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/classifiers-and-parameters-management/retrieve-classifiers/index.md) | Success -- Retrieve Classifiers for a Client   |
|                                                                                                                                                                                       | Success -- No Classifiers for a Client         |
|                                                                                                                                                                                       | Success -- Retrieve Classifiers for a Contract |
|                                                                                                                                                                                       | Success -- No Classifiers for a Contract       |
| [Set Parameter](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/classifiers-and-parameters-management/set-parameter/index.md)               | Success                                        |
| [Retrieve Parameters](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/classifiers-and-parameters-management/retrieve-parameters/index.md)   | Success                                        |
|                                                                                                                                                                                       | Success -- No parameter codes                  |

|                                                                                                       Test case                                                                                                        |                     Test case scenario                     |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------|
| [Post a Debit Transaction](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/post-debit-trans/index.md)                                       | Success                                                    |
|                                                                                                                                                                                                                        | Fail -- Not unique reference number                        |
|                                                                                                                                                                                                                        | Fail -- Insufficient funds                                 |
|                                                                                                                                                                                                                        | Fail -- Blockade by the usage limit maximum amount         |
| [Post a Credit Transaction](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/post-credit-trans/index.md)                                     | Success                                                    |
|                                                                                                                                                                                                                        | Fail -- Not unique reference number                        |
|                                                                                                                                                                                                                        | Fail -- Blockade by the usage limit maximum amount         |
| [Charge a Fee](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/charge-fee/index.md)                                                         | Success                                                    |
|                                                                                                                                                                                                                        | Fail -- Incorrect feeTypeId                                |
|                                                                                                                                                                                                                        | Fail -- Not unique reference number                        |
| [Release blocked funds (cancel pending Transaction)](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/release-blocked-funds/index.md)        | Success                                                    |
|                                                                                                                                                                                                                        | Success -- Release funds failure                           |
| [Reverse a Transaction](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/reverse-a-trans/index.md)                                           | Success                                                    |
|                                                                                                                                                                                                                        | Fail -- No serviceClassCode linked to the Transaction      |
|                                                                                                                                                                                                                        | Fail -- No transactionType linked to the Transaction       |
|                                                                                                                                                                                                                        | Fail -- Reverse not allowed for the given serviceClassCode |
|                                                                                                                                                                                                                        | Fail -- Reverse not allowed for the given transactionType  |
|                                                                                                                                                                                                                        | Fail -- Incorrect Transaction status                       |
| [Retrieve Transactions](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/retrieve-transactions/index.md)                                     | Success                                                    |
|                                                                                                                                                                                                                        | Success -- No Transactions                                 |
| [Retrieve Transaction Documents](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/retrieve-trans-docs/index.md)                              | Success                                                    |
|                                                                                                                                                                                                                        | Success -- No Transaction Documents                        |
| [Retrieve Transaction Documents by ID, ARN, RRN or SRN](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/retrieve-trans-docs-by-id/index.md) | Success -- Retrieve Transaction Document by transaction id |
|                                                                                                                                                                                                                        | Success -- Retrieve Transaction Document by ARN            |
|                                                                                                                                                                                                                        | Success -- Retrieve Transaction Document by RRN            |
|                                                                                                                                                                                                                        | Success -- Retrieve Transaction Document by SRN            |
|                                                                                                                                                                                                                        | Success -- No Transaction Documents                        |
| [Retrieve Transaction's Fees](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/transactions-and-fees-management/retrieve-trans-fees/index.md)                                 | Success                                                    |
|                                                                                                                                                                                                                        | Success -- No Fees                                         |

|                                                                                               Test case                                                                                               |            Test case scenario            |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------|
| [Update Usage Limit](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/usage-limits-management/update-usage-limit/index.md)                                   | Success -- Update Usage Limit parameters |
|                                                                                                                                                                                                       | Fail -- Invalid usage limit code         |
| [Enable or disable Usage Limit](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/usage-limits-management/enable-disable-usage-limit/index.md)                | Success - Enable usage limit             |
|                                                                                                                                                                                                       | Success -- Disable usage limit           |
|                                                                                                                                                                                                       | Fail -- Invalid Usage Limit code         |
| [Reset Usage Limit counters](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/usage-limits-management/reset-usage-limit-counters/index.md)                   | Success                                  |
|                                                                                                                                                                                                       | Fail -- Invalid Usage Limit code         |
| [Restore Usage Limit original values](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/usage-limits-management/restore-usage-limit-original-values/index.md) | Success                                  |
|                                                                                                                                                                                                       | Fail -- Invalid Usage Limit code         |
| [Retrieve Usage Limits details](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/usage-limits-management/retrieve-usage-limits-details/index.md)             | Success                                  |

|                                                                                     Test case                                                                                      |                          Test case scenario                          |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
| [Retrieve clientId](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/cms-identifiers-search/retrieve-clientid/index.md)                   | Success -- Retrieve clientId by the client number                    |
|                                                                                                                                                                                    | Success -- Retrieve clientId by the identification document number   |
|                                                                                                                                                                                    | Success -- Retrieve clientId by the social number                    |
|                                                                                                                                                                                    | Success -- Retrieve clientId by the taxpayer identifier              |
|                                                                                                                                                                                    | Fail -- No Client found                                              |
| [Retrieve accountContractId](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/cms-identifiers-search/retrieve-accountcontractid/index.md) | Success -- Retrieve accountContractId by the account contract number |
|                                                                                                                                                                                    | Success -- Retrieve accountContractId by the CBS number              |
|                                                                                                                                                                                    | Fail -- No Account Contract found                                    |
| [Retrieve cardContractId](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/cms-identifiers-search/retrieve-cardcontractid/index.md)       | Success -- Retrieve cardContractId by the card contract number       |
|                                                                                                                                                                                    | Success -- Retrieve cardContractId by the CBS number                 |
|                                                                                                                                                                                    | Fail -- No Card Contract found                                       |

<br />

## API configuration {#api-configuration}

There is a predefined API configuration of the Sandbox containing the following:

* characters allowed in the requests
* `cardContractnumber` (PAN) masking pattern used in all API responses
* input patterns for fields containing e-mail, phone, or fax number
* available dictionaries' values

|            Global parameter             |                                                                                                                                      Value                                                                                                                                      |
|-----------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| PAN masking pattern                     | XXXXXX____XXXX                                                                                                                                                                                                                                                                  |
| Allowed default characters              | abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.,\&#'@+\\\\-\*_=; /1234567890                                                                                                                                                                                              |
| Allowed characters for embossedData     | ABCDEFGHIJKLMNOPQRSTUVWXYZ /1234567890                                                                                                                                                                                                                                          |
| Allowed characters for technical fields | abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ\*#+= /1234567890\\\\-_%;                                                                                                                                                                                                   |
| Technical fields                        | `accountContractNumber`, `accountContractSubtypeCode`, `addressType`, `AuthenticationParameter.name`, `authenticationTypeCode`, `balanceCode`, `cardContractId`, `cbsNumber`, `classifierCode`, `classifierValue`, `clientType`,                                                |
|                                         | `customData`, `eventCode`, `feeCode`, `feeTypeId`, `language`, `maritalStatus`, `orderDepartment`, `parameterCode`, `productCode`, `productionCode`, `reissueType`, `serviceGroupCode`, `statusCode`, `tagName`, `tariffCode`, `title`, `transactionTypeCode`, `usageLimitCode` |
| Pattern for email                       | \^\\\\S+@\\\\S+$                                                                                                                                                                                                                                                                |
| Pattern for phone number                | \^00\[0-9\]{8,19}$                                                                                                                                                                                                                                                              |
| Pattern for fax number                  | \^00\[0-9\]{8,19}$                                                                                                                                                                                                                                                              |

|      Dictionary name       |            Value             |
|----------------------------|------------------------------|
| accountCntractProductCode  | STD-DEBCH-EUR                |
| accountContractStatusCode  | 00                           |
|                            | 00c                          |
| addressType                | PIN                          |
|                            | STMT                         |
| cardContractProductCode    | STD-MCDEBVF-EUR              |
| cardContractStatusCode     | 00                           |
|                            | 04                           |
|                            | 05                           |
|                            | 41                           |
|                            | 43                           |
|                            | 57                           |
|                            | 59                           |
| clientType                 | PR                           |
| credit transactionTypeCode | PT_1                         |
| debit transactionTypeCode  | FP                           |
| eventCode                  | MDES_TKN_DEACTIVATE          |
| language                   | ENG                          |
| maritalStatus              | DD                           |
|                            | DM                           |
|                            | DS                           |
|                            | DX                           |
| orderDepartment            | Department                   |
| reissueType                | REISSUE                      |
|                            | RENEW                        |
|                            | RENEW_D                      |
|                            | REPLACE                      |
|                            | REPLACE_D                    |
|                            | REPLACE_WITH_PIN_INHERITANCE |
| serviceGroupCode           | 021                          |
| title                      | MR                           |
| usageLimitCode             | DAILY_TOTAL                  |
|                            | MONTHLY_TOTAL                |

## Global error test cases {#global-error-test-cases}

There are globally predefined primary CMS objects identifiers (cardContractId, accountContractId, and so on) which allow getting typical errors during the processing of the request.

| Path parameter name | Path parameter available value |           reasonCode            |                Description                |
|---------------------|--------------------------------|---------------------------------|-------------------------------------------|
| client_id           | 20001                          | CLIENT_DOES_NOT_EXIST           | Client with id 20001 not found.           |
| contract_id         | 10001                          | CONTRACT_DOES_NOT_EXIST         | Contract with id 10001 not found.         |
| account_contract_id | 10001                          | ACCOUNT_CONTRACT_DOES_NOT_EXIST | Account contract with id 10001 not found. |
| card_contract_id    | 10001                          | CARD_CONTRACT_DOES_NOT_EXIST    | Card contract with id 10001 not found.    |
| transaction_id      | 99001                          | TRANSACTION_DOES_NOT_EXIST      | Transaction with id 99001 not found.      |

For example, to get the `reasonCode CLIENT_DOES_NOT_EXIST` error, you should define the `client_id` parameter with the `20001` value in the request. That rule applies to any API endpoints with `client_id` unless it is described differently in the particular test case.

There are also two global error test cases mocked in the Sandbox related to the `PATCH` methods (used in update client, account contract, or card contract test cases).

| `If-Match` header value |          `reasonCode`          |
|-------------------------|--------------------------------|
| "INVALID_IF_MATCH"      | `INVALID_ETAG`                 |
| "TIMEOUT_IF_MATCH"      | `ETAG_SYNCHRONIZATION_TIMEOUT` |

