On This Page
FILTER BY TAG

Create a Shared Secret Key Pair

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 section in the
Creating and Using Security Keys User Guide
.

Step 2A: Create a Shared Secret Key Pair

Follow these steps to create a shared secret key pair:
  2. On the left navigation panel, choose
    Payment Configuration > Key Management
    .
  3. Click
    + Generate key
     on the Key Management page.
  4. Under REST APIs, choose
    REST – Shared Secret
     and then click
    Generate key
    .
    The REST API Shared Secret Key page appears.
  5. Click
    Download key
     .
    The
    .pem
     file downloads to your desktop.
    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.
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.

Step 2B: Test Your Shared Secret Key Pair

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
.
  2. On the left navigation panel, click .
  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.
  8. Go to the Developer Center's API Reference and navigate to
    Payments >
    POST
     Process a Payment
    .
  9. Click
    Send
    .
    A message confirms that your request was successful with the status code 201.
  10. Log in to the
    Business Center
    :
  11. On the left navigation panel, choose
    Transaction Management > 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.
RELATED TO THIS PAGE