CyberSource Hosted SDK Installation

1. Log in to your CyberSource merchant account.

2. Go to Account Management, then Transaction Security Keys. In the Transaction Security Keys page click on Security Keys for the Simple Order API link.

3. Click on the Generate Key button.

4. Then click the Generate Certificate Request button.

5. Once the key has been generated, copy it to your sdk directory under the keys folder. The extension of the key must be .p12 and the filename should be the same as your merchant ID.   

   

6. Go to Tools & Settings, then Profiles under Secure Acceptance.

7. Click on the Create New Profile button.

8. Fill out the profile information and select Web/Mobile for the Integration Method.

9. Fill out the contact information and click the Create button. You are redirected to the new profile page.

10. Click on the Security link.

11. Click on the Create New Key button.

12. Enter a name for the new key and click on the Generate Key button.

    

Admin Console Setup

1. In the AspDotNetStorefront admin console, go to Configuration > Site Setup Wizard.

2. In the Payment Gateway section, click the configure link next to the CyberSource entry.

3. Enter the value you obtained from CyberSource for the Merchant ID.

4. Enter the filename (with extension) that you saved in step 7 above for the Key Filename and the full path to the SDK folder you saved that key in for the Keys Directory.

   

5. Enter the value you obtained from CyberSource for the Profile ID.

6. Enter the value you obtained from CyberSource for the Access Key.

7. Enter the value you obtained from CyberSource for the Secret Key.

   

8. Click Save and Close.

9. Finally, click the radio button next to CyberSource and then click the Save button.

External Billing Address Entry

CyberSource Hosted can be configured to allow the shopper to enter their billing address offsite. The following configuration options help to make this functionality more visible and intuitive to the shopper.

Configuration

Setting: RATEX.CyberSourceHosted.CheckoutBillingAddressEnabled

• This configuration setting controls whether the billing address is collected on-site or during CyberSource checkout.

When true, and using CyberSource Hosted as the payment method, the billing address is entered at checkout before continuing offsite to CyberSource.

When false, and using CyberSource Hosted as the payment method, the billing address is entered at CyberSource and prompt "checkout.cybersource.nobillingaddress" is displayed at checkout. Configurations must be set at CyberSource to collect the billing address offsite.

Prompt: checkout.cybersource.nobillingaddress

• This prompt will display as a notification to the shopper during checkout if setting "RATEX.CyberSourceHosted.CheckoutBillingAddressEnabled" is false and the billing address is entered at CyberSource.

The default message for this notification is "You may change your billing address after clicking 'Place Order'.".

Frequently Asked Questions

Q: What CyberSource API should I use for transaction keys?

A: Security Keys for the Simple Order API (SOAP).

Q: When I try to void a transaction, it always fails with the following error even if the capture has not been done: "The capture or credit is not voidable because the capture or credit information has already been submitted to your processor. Or, you requested a void for a type of transaction that cannot be voided."

A: A transaction can only be voided if CyberSource has not yet submitted the debit or credit information to your processor. Usually CyberSource submits that type of information to your processor once a day, so your window for successfully performing a void is relatively small. CyberSource will decline your void request if the debit or credit information has already been sent to the processor.

CyberSource supports the void service for the following processors:

• Chase Paymentech Solutions
• TeleCheck

When you void a transaction, the transaction is at the end of its life. You cannot undo a void, and you cannot perform a follow-on credit for a debit that has been voided.

Q: Can I use my Bank of America account through CyberSource?

A: Yes, CyberSource supports Bank of America accounts. See here for more information.

For more information about CyberSource error messages, go to the CyberSource page where they have a list of reason codes for the errors and contact CyberSource support directly if you are experiencing these, they should be able to assist you further.