eWay Updating Cybersource Merchant Key

CyberSource: Simple Order API Security Keys

Generating Transaction Keys

The CyberSource Simple Order API secures online transactions through public key cryptography. Before you can send requests for CyberSource services using the Simple Order API, you need to create a security key for your CyberSource merchant account in the Business Center.

Steps To generate a security key:

1. Log in to CyberSource's Electronic Business Center (EBC2).
   • Production Environment
2. Choose Payment Configuration > Key Management.
3. Click the blue +Generate Key button on the right side of the page.
4. Under Recommended Key Type Select the bullet for Simple Order API
5. Click Generate key button in lower right.
6. Click the Download key button
7. Set a Password (this password will be entered in eWay)
8. Click Generate Key button
9. File will save in your Downloads folder. 

   • When downloading the certificate file, ensure that you keep the most recent version. If there are multiple local copies of the certificate (e.g., `unitedwaysb.pk12` and `unitedwaysb(2).pk12`), rename the most current file by removing any numbers in parentheses. The correct file name should not contain any numbers or parentheses (e.g., `unitedwaysb.pk12`).

10. Front the left-hand navigation menu, select Key Management

11. Search for Key Type set to "Simple Order"
12. Note the expiration date for the Simple Order item 

Uploading Transaction Keys into OPPS

Steps to upload the generated security key:

1. Log in to Campaign Management (OPPS admin).
   • admin.unitedeway.org
2. Click + in front of the Organization node
3. Go to the Merchant tab (envelope icon)
4. If CyberSource merchant already exists, click the View icon (envelope icon) on the right. Otherwise, click Add a new merchant account.
5. Complete the following fields:
   1. • Merchant type: CyberSource
      • Merchant ID: <your CyberSource merchant ID>
      • Password/Confirm Password: use the password set while download the key from Cybersource (from step 7 above)
      • Payment Processor: <your payment processor for CyberSource>
        • (Options: Vital, First Data South, FDI Nashville, GPN)
      • Expiry Date: (optional) mm/dd/yyyy from CyberSource Step 11, above
      • Merchant Key: click upload files and choose your .p12 file from CyberSource Step 8, and open.
   2. Click Save / Update
   3. In the merchant list, click the green traffic light to change it to red, which will activate the account for use