Create a Shared Secret Key Pair {#restgs-shared-secret-create-intro}
====================================================================

![](/content/dam/documentation/cybs/en-us/topics/platform/rest/getting-started/images/flow-keys-sharedsecret-2-750x175.svg/jcr:content/renditions/original)  
This section describes how to create a shared secret key pair and test that it works. A shared secret key pair consists of a *key ID* and a *shared secret key*, which you must have in order to construct JWT messages and enable MLE.

(Optional) Meta Keys
:
If you are using a portfolio or merchant account, you have the option to create a *meta key* of a shared secret key pair. Meta keys enable an organization administrator to assign a single shared secret key pair to some or all transacting merchants in their organization. The purpose of a meta key is to reduce the time needed to manage an organization's keys. For example, by assigning the same meta key to all of your transacting merchants, you only need to update one key when it expires instead of having to update each transacting merchant's key.
:
For more information about meta keys, see the [Meta Key Creation and Management](https://developer.visaacceptance.com/docs/vas/en-us/security-keys/user/all/ada/security-keys/keys-meta-intro.md "") section in the *Creating and Using Security Keys User Guide*.
{#restgs-shared-secret-create-intro_metakeys-dl}  
acquirer

Merchant Account User: Create a Shared Secret Meta Key {#restgs-shared-secret-meta-merchant}
============================================================================================

This section describes how to create a meta key as a merchant account user in the `Business Center`.
IMPORTANT Only merchant account users can complete this task.  
IMPORTANT If you would like to create meta keys using the API, contact your support team for more information.  
Follow these steps to create a meta key for a shared secret key pair:

1. Log in to the `Business Center`:  
   [`https://businesscentertest.visaacceptance.com`](https://businesscentertest.visaacceptance.com/ebc2/ "")
2. On the left navigation panel, choose ![](/content/dam/documentation/cybs/en-us/common/images/ebc/ebc-icon-pymt-config.svg/jcr:content/renditions/original) **Payment Configuration \&gt; Key Management**.  
   If you are using a portfolio account to create a meta key for one of your merchant accounts, you can switch to a merchant account by clicking **Switch merchant**.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-keymgmt-switch-merchant.jpg/jcr:content/renditions/cq5dam.web.1280.1280.jpeg)  
   The Quick Merchant Switch page appears.  
   Choose the merchant account ID that you want to switch to, and click **Switch**.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-keymgmt-merchant-switch.jpg/jcr:content/renditions/cq5dam.web.1280.1280.jpeg)
3. In the **Merchant ID** search filter, choose your merchant account ID.  
   If you logged in from a portfolio user account or the account (*_acct* ) level, verify that the merchant ID you choose does not contain *_acct* in the ID name.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-keymgmt-merchant-field.jpg/jcr:content/renditions/cq5dam.web.1280.1280.jpeg)
4. Click **+ Generate key**.  
   The Create Key page appears.
5. Choose **REST -- Shared Secret** and click **Generate key**.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-keymgmt-create-key.png/jcr:content/renditions/original)  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-keymgmt-generate-key.png/jcr:content/renditions/original)  
   The Key options window appears.
6. Check the **Create as a Meta-Key** box and click **Continue**.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/meta1.jpg/jcr:content/renditions/cq5dam.web.1280.1280.jpeg)
7. Choose one of these options to assign the key:
   * To assign this key to all accounts in the current portfolio, choose **All current and future Merchant IDs** , click **Create key**, and continue to the Create Key page. All future merchant IDs will be automatically assigned this key. You are done and do not need to proceed with the following steps.
   * To assign this key to a specific merchant or group of merchants, choose **Custom Merchant ID selection** and then click **Create key**. This key is not automatically assigned to any future merchants. Proceed to the following steps.  
     ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/meta2.PNG/jcr:content/renditions/original)
8. Click **+ Add custom merchant ids**. The Add Custom Merchant IDs page appears.  
   By default, all merchant IDs are shown in the Merchant IDs table. To limit the list to a subset of merchant IDs, click **+ Add filter** , choose a search filter from the drop-down menu, and click **Search**.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/meta3.PNG/jcr:content/renditions/original)
9. Check one or more transacting MID account boxes, and click **Submit**.  
   The Key Generation page opens.
10. Click **Create key**.  
    Continue to the Create Key page to view your new key.  
    You can also generate a new key by clicking **+ Generate Key** again.

#### AFTER COMPLETING THE TASK

To test your shared secret key pair, see [Test Your Shared Secret Key Pair](/docs/vas/en-us/platform/developer/all/rest/rest-getting-started/restgs-http-message-intro/restgs-security-key-pair-intro/restgs-security-key-pair-test-task.md "").  
acquirer

Portfolio User: Create a Shared Secret Meta Key {#restgs-shared-secret-meta-port}
=================================================================================

This section describes how to create a meta key as a portfolio user in the `Business Center`. IMPORTANT Only portfolio account users can complete this task.  
IMPORTANT If you would like to create meta keys using the API, contact your support team for more information.  
Follow these steps to create a meta key for a shared secret key pair:

1. Log in to the `Business Center`:  
   [`https://businesscentertest.visaacceptance.com`](https://businesscentertest.visaacceptance.com/ebc2/ "")
2. On the left navigation panel, choose ![](/content/dam/documentation/cybs/en-us/common/images/ebc/ebc-icon-pymt-config.svg/jcr:content/renditions/original) **Payment Configuration \&gt; Key Management**.{#restgs-shared-secret-meta-port_d13e35}
3. In the **Merchant Id** field, choose your portfolio ID if it is not already chosen by default.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-keymgmt-merchant-id.jpg/jcr:content/renditions/cq5dam.web.1280.1280.jpeg)
4. Click **+ Generate key**.  
   The Create Key page appears.
5. Choose **REST -- Shared Secret** and click **Generate key**.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-keymgmt-create-key.png/jcr:content/renditions/original)  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-keymgmt-generate-key.png/jcr:content/renditions/original)  
   The Key options page appears. {#restgs-shared-secret-meta-port_d11e59}
   {#restgs-shared-secret-meta-port_d11e59}
6. Check the **Create as a Meta-Key** box and click **Continue**.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/meta1.jpg/jcr:content/renditions/cq5dam.web.1280.1280.jpeg)
7. Choose one of these options to assign the key:
   * To assign this key to all accounts in the current portfolio, choose **All current and future Merchant IDs** , click **Create key**, and continue to the Create Key page. All future merchant IDs will be automatically assigned this key. You are done and do not need to proceed with the following steps.
   * To assign this key to a specific merchant or group of merchants, choose **Custom Merchant ID selection** and then click **Create key**. This key is not automatically assigned to any future merchants. Proceed to the following steps.  
     ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/meta2.PNG/jcr:content/renditions/original)
8. Click **+ Add custom merchant ids**. The Add Custom Merchant IDs page appears.  
   By default, all merchant IDs are shown in the Merchant IDs table. To limit the list to a subset of merchant IDs, click **+ Add filter** , choose a search filter from the drop-down menu, and click **Search**.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/meta3.PNG/jcr:content/renditions/original)
9. Check one or more transacting MID account boxes, and click **Submit**.  
   The Key Generation page opens.
10. Click **Create key**.  
    Continue to the Create Key page to view your new key.  
    You can also generate a new key by clicking **+ Generate Key** again.

#### AFTER COMPLETING THE TASK

To test your shared secret key pair, see [Test Your Shared Secret Key Pair](/docs/vas/en-us/platform/developer/all/rest/rest-getting-started/restgs-http-message-intro/restgs-security-key-pair-intro/restgs-security-key-pair-test-task.md "").

Step 2A: Create a Shared Secret Key Pair {#restgs-shared-secret-create-task}
============================================================================

Follow these steps to create a shared secret key pair:

1. Log in to the `Business Center`:
   * **Test:** [`https://businesscentertest.visaacceptance.com`](https://businesscentertest.visaacceptance.com/ebc2/ "")
   * **Production:** [`https://businesscenter.visaacceptance.com`](https://businesscenter.visaacceptance.com/ebc2/ "")
     {#restgs-shared-secret-create-task_step-1}
     {#restgs-shared-secret-create-task_step-1}
   2. On the left navigation panel, choose ![](/content/dam/documentation/cybs/en-us/common/images/ebc/ebc-icon-pymt-config.svg/jcr:content/renditions/original) Payment Configuration \&gt; Key Management.  
      ![](/content/dam/documentation/cybs/en-us/topics/platform/rest/getting-started/images/left-navigation.png/jcr:content/renditions/original) {#restgs-shared-secret-create-task_step-2}
      {#restgs-shared-secret-create-task_step-2}
   3. Click + Generate key on the Key Management page.  
      ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/generate-key.png/jcr:content/renditions/original) {#restgs-shared-secret-create-task_step-3}
      {#restgs-shared-secret-create-task_step-3}
   4. Under REST APIs, choose **REST -- Shared Secret** and then click **Generate key**.  
      ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-keys-create-key.png/jcr:content/renditions/original)  
      ![](/content/dam/documentation/cybs/en-us/topics/platform/rest/getting-started/images/generate-key-bttn.png/jcr:content/renditions/original)  
      The REST API Shared Secret Key page appears. {#restgs-shared-secret-create-task_d17e26}
      {#restgs-shared-secret-create-task_d17e26}
2. Click **Generate key** after reviewing the key details.  
   ![](/content/dam/documentation/cybs/en-us/topics/payments-processing/payment-services/sec-keys/images/security-key-confirm-key.png/jcr:content/renditions/original) {#restgs-shared-secret-create-task_d17e46}
   {#restgs-shared-secret-create-task_d17e46}
   6. Click **Download key** ![](/content/dam/documentation/cybs/en-us/common/images/ebc/ebc-bttn-download.svg/jcr:content/renditions/original) .  
      The *.pem* file downloads to your desktop.  
      ![](/content/dam/documentation/cybs/en-us/topics/platform/rest/getting-started/images/shared-secret-key-download.png/jcr:content/renditions/original)  
      The **Key** value is your *key ID* and the **Shared Secret** value is your *shared secret key*.

   > IMPORTANT
   > Securely store the key credentials and *.pem* file in your system. These credentials are required in order to implement certain products, and you must be able to access them.
   > {#restgs-shared-secret-create-task_d17e55}
   > {#restgs-shared-secret-create-task_d17e55}

{#restgs-shared-secret-create-task_d17e18}  
To create or submit another key, click **Generate another key**. To view all of your created keys, go to the Key Management page.

**What to do next**
:
To test your shared secret key pair, see [Step 2B: Test Your Shared Secret Key Pair](/docs/vas/en-us/platform/developer/all/rest/rest-getting-started/restgs-http-message-intro/restgs-security-key-pair-intro/restgs-security-key-pair-test-task.md "").

Step 2B: Test Your Shared Secret Key Pair {#restgs-shared-secret-test}
======================================================================

After creating your shared secret key pair, you must verify that your key pair can successfully process API requests. Follow these steps to validate your key pair in the Developer Center and the `Business Center`.

1. Go to the Developer Center's API Reference page:  
   [https://developer.visaacceptance.com/api-reference-assets/index.html#static-home-section](https://developer.visaacceptance.com/api-reference-assets/index.md#static-home-section "")
2. On the left navigation panel, click **[API Endpoints \& Authentication](https://developer.visaacceptance.com/api-reference-assets/index.md#static-api-endpoints-section "")**.
3. Under Authentication and Sandbox Credentials, go to the Authentication Type drop-down menu and choose **HTTP Signature**.
4. Enter your organization ID in the **Organization ID** field.
5. Enter your key ID in the **Key** field.
6. Enter your shared secret key in the **Shared Secret Key** field.
7. Click **Update Credentials**.  
   A confirmation message displays stating that your credentials are successfully updated.  
   ![](/content/dam/documentation/cybs/en-us/topics/platform/rest/getting-started/images/restgs-dev-center-http.png/jcr:content/renditions/original)
8. Go to the Developer Center's API Reference and navigate to **Payments \&gt; `POST` Process a Payment**.
9. Click **Send**.  
   ![](/content/dam/documentation/cybs/en-us/topics/platform/rest/getting-started/images/restgs-dev-center-ex.png/jcr:content/renditions/original)  
   A message confirms that your request was successful with the status code 201.  
   ![](/content/dam/documentation/cybs/en-us/topics/platform/rest/getting-started/images/rstgs-success-201.png/jcr:content/renditions/original)
10. Log in to the `Business Center`:  
    [`https://businesscentertest.visaacceptance.com`](https://businesscentertest.visaacceptance.com/ebc2/ "")
11. On the left navigation panel, choose ![](/content/dam/documentation/cybs/en-us/common/images/ebc/ebc-icon-trxn-mgmt.svg/jcr:content/renditions/original) **Transaction Management \&gt; Transactions**.
12. Under Search Results, verify that the request ID from the test authorization response is listed in the Request ID column.  
    If the test authorization was successful, a success message is present in the corresponding Applications column.  
    ![](/content/dam/documentation/cybs/en-us/topics/platform/rest/getting-started/images/restgs-verify-key-pair.png/jcr:content/renditions/original)

