Getting Started with REST

This section describes how to use this guide and where to find further information.
Visit the
Cybersource
documentation hub
to find additional technical documentation.
Audience and Purpose
This guide provides information about how to set up a merchant account.
Customer Support
For support information about any service, visit the Support Center:

Recent Revisions to This Document

24.01

Initial release of the Creating a Merchant Account.

Your Merchant Account

Get ready to quickly enable payments with
Cybersource
First things first, you should have received an email from
Cybersource
. The email was delivered with the subject line:
Action Required
This email will include two important items:
  • Your Organization ID: <org-id>
  • Your unique log in link you to create your user account
If you haven't received this email, ???????

Create a Merchant Account

To create your merchant account, you will need to:
Sign-up for a merchant account
Validate account information
Create a shared secret key
Enable a digital payment type
Test your account

Sign Up for a Merchant Account

  • You will need your sign up letter that provides your Account ID and personalized log-in URL.
  1. Enter the Organization ID included in the welcome email and the email address that received the welcome email. Click Submit.

    ADDITIONAL INFORMATION

    The Create User Name screen will open.
    WARNING
    Do not click the Back button. If you click the back button, your set up session will be closed and you will need to ask for a new set up URL before you can continue.
  2. Enter your first name, last name, and a username for the account. This username will be used when you log in to the
    Business Center
    , so make a note of this name. click Next Step.

    ADDITIONAL INFORMATION

    The Create Password screen will open.
  3. Enter a password and click Create User.

    ADDITIONAL INFORMATION

    IMPORTANT
    Do not navigate away from this page. It takes up to two minutes to create the user account.
    Once the account is created, you will receive a message that the user account was successfully created.

Validate Merchant Information

  • You must have a merchant account.
  • You will need the following log in information:
    • Organization ID
    • Username
    • Password
  1. Log in to the
    Business Center
    test site.

    ADDITIONAL INFORMATION

    The
    Business Center
    will open to the Welcome Page.
  2. Navigate to the Account Information Screen.

    ADDITIONAL INFORMATION

    To navigate to the Account Information screen, click the Account Management Icon and select Account Information.
  3. Verify that your account information is accurate. Make any changes as necessary.

Generate a Shared Secret

  1. If not already, log in to the
    Business Center
    test site.
  2. Switch to the test account view.

    ADDITIONAL INFORMATION

    To switch to the test account view, Click the Switch View button, and select your test account transacting MID.
    When you first log in to the
    Business Center
    , you see the account view. You need to switch your test account view before you can generate keys to test your implementation.
  3. Navigate to the Account Information Screen.

    ADDITIONAL INFORMATION

  4. Open the Key Management Page.

    ADDITIONAL INFORMATION

    Click the Payment Configuration icon and select Key Management.
  5. Select the Generate Key button:

    ADDITIONAL INFORMATION

    The Create Key tool will open.
  6. Select REST - Shared Secret and click Generate Key.

    ADDITIONAL INFORMATION

    A REST API Shared Secret Key will be shown.
  7. Download a copy of the key to your local system.

    ADDITIONAL INFORMATION

    To download a copy of the key, select Download key. Your browser will place the file in your download folder.
    IMPORTANT
    Once you close the REST API Shared Secret Key screen, the shared secret value cannot be retrieved from the system. You should download the key to your desktop so that you can retrieve the shared secret value later to test payment transactions.

Enable Payment Types

For testing purposes, you need to enable at least one Digital Payment Solution. The most straight forward solution is Google Pay, so that will be the solution we will use.
  1. If not already, log in to the
    Business Center
    test site.

    ADDITIONAL INFORMATION

  2. Switch to the test account view.

    ADDITIONAL INFORMATION

    To switch to the test account view, Click the Switch View button, and select your test account transacting MID.
  3. Select Payment Configuration, Digital Payment Solutions.

    ADDITIONAL INFORMATION

    The Digital Payments Configuration Page will open.
  4. Select Configure Google Pay.

    ADDITIONAL INFORMATION

    The Google Pay configuration page will open.
  5. Enter your business name and click Update.

    ADDITIONAL INFORMATION

    Once you click update, you should see Google Pay's status as Available and Enabled.

Test Your Merchant Account

Once you have enabled your merchant account and created your shared-secret REST key, you should now test your system to ensure it works as expected.
  1. Navigate to the
    Cybersource
    developer center.

    ADDITIONAL INFORMATION

  2. Select API Endpoints & Authentication.

    ADDITIONAL INFORMATION

    The API Endpoint and Authentication Details page will open.
  3. Scroll down to the Authentication and Sandbox Credentials box.
  4. Set the following information and click Update Credentials:

    ADDITIONAL INFORMATION

    • Authentication Type:
      HTTP Signature.
    • Organization ID:
      Your test account transacting MID.
      This value can be found in the the
      Business Center
      . For more information, see: Generate a Shared Secret, step 2.
    • Key:
      The key value of the Shared Secret key previously generated.
    • Secret Key:
      HTTP Signature Shared Secret Key from the Shared Secret Key previously downloaded.
    The image shows a downloaded shared secret key file opened in a text editor.
    After you enter the shared key credentials, you will see: Success: Successfully updated credentials for HTTP Signature.
  5. Scroll down and select Digital Acceptance, Flex Microform, Microform Integration, Generate Capture Context.

    ADDITIONAL INFORMATION

    The capture context request text will open.
  6. If your credentials were set up correctly, you should receive: Success: HTTP Status Code 201.

    ADDITIONAL INFORMATION

RESULT

Once you have successfully created a capture context, you have verified that your account is set up correctly. You are now ready to move to the next step.

Next Steps

Now that you have signed up, configured and validated your merchant account, you are ready to start adding payment services.