Configure Payment Service

You must log in with Opti ID to use this feature. Email Optimizely Support to have your commerce instance added to Opti ID.

With Optimizely Commerce's Payment Service, you can add payment gateway providers for your ecommerce. This uses Spreedly's iFrame to offer more flexibility and stability:

• Use a payment platform without implementing new code.
• Access more payment gateway options.
• Implement multiple payment services on a single website.

Although Payment Service supports multiple gateways for a single site, there is currently a limit of one gateway per site in Optimizely Configured Commerce. Work with your partner if you want to customize this.

Enable Payment Service

Configured Commerce

To use the Payment Service, contact Optimizely Support to have the keys for a Payment Service instance added to your commerce environment.

After the keys are added and you restart the site, you can see the admin pages for Payment Service to continue the configuration.

Commerce Connect

To use the Payment Service, contact your Customer Success Manager to have a Payment Service instance added to Turnstile. They can then provide the instance keys that must be added to appsetting.json in Commerce Connect.

"PaymentServiceOptions": {
			"PaymentServiceIsEnabled": true,
			"PaymentServiceUrl": "https://xxx.xxx/",
			"AppKey": "xxxxx”,
			"SecretKey": "xxxxx”,
			"AuthenticationType": "HMAC”,
			"EnvironmentKey": "xxx",
			"SigningSecret": "xxx",
			"EnvironmentName": "abc"
			}

The supported authentication types are HMAC and OBO.

If the EnvironmentKey is empty, provide an EnvironmentName and add the following code to the Configure function of the Setup.cs file. The environment was automatically established during start-up and running.

app.SetupPaymentService();

After the keys are added and you restart the site, you can see the admin pages for Payment Service to continue the configuration.

Add gateways

1. Go to Administration > Payment Service in Configured Commerce or Commerce Administration > Settings > Payment Service in Commerce Connect.
2. Click Add Gateway.

   

3. Select the gateway from the drop-down list. The form populates additional fields depending on the gateway.
4. (Optional) Enter a Description.
5. (Optional) Select your Merchant Profile Key if you have already created a merchant profile.
6. Select whether to use this gateway in your Sandbox Site.
7. Fill in any additional information for your gateway.
8. Click Create. 

Enable 3DS authentication

To enable 3DS authentication, create a merchant profile and an SCA provider.

You cannot perform a new 3DS authorization or sales transaction through the Admin Console in Configured Commerce.

Add a merchant profile

 Information for the merchant profile fields comes from your payment provider.

1. Go to Administration > Payment Service > Merchant Profiles in Configured Commerce or Commerce Administration > Settings > Payment Service > Merchant Profiles.
2. Click Add Merchant Profile.

   

3. (Optional) Enter a Description.
4. Enter a Sub-Merchant Key.
5. Select a credit card from the drop-down list.
6. Enter the Acquirer Merchant ID.
7. Enter the Merchant Name.
8. Enter a Country Code.
9. Enter the MCC. The MCC is the Merchant Category Code, which classifies the type of goods or services that the business sells. See Spreedly's documentation for information.

Add an SCA provider

You must create a merchant profile first to add a Strong Customer Authentication (SCA) provider.

1. Go to Administration > Payment Service > SCA Providers in Configured Commerce or Commerce Administration > Settings > Payment Service > SCA Providers in Commerce Connect.
2. Click Add SCA Provider.

   

3. Select a Merchant Profile.
4. Enter the Type.
5. Select whether to use this SCA Provider in your sandbox.
6. Select a Credit Card from the drop-down list.
7. Enter the Acquirer BIN.
8. Enter the Merchant Url.
9. Enter the Merchant Brand Id.
10. Enter the Merchant Password.
11. Click Create. You can also click Cancel to exit without saving.

After you create the SCA provider, the SCA Provider Key displays. Copy this key because this is the only time this information is displayed. If you lose it, you must create another SCA provider.

Enter credentials under settings

Configured Commerce

When you have completed the previous steps, go to Administration > Settings > Spreedly and enter the following information:

1. Enter the gateway token from Add gateways. This can be website-specific.
2. Toggle on 3DS Enabled.
3. Enter the SCA Provider Key and Signing Secret from Add an SCA provider.

Commerce Connect

When you have completed the previous steps, go to Commerce Administration > Settings > Payments, click Create, and enter the following information:

1. Enter the Name.
2. Enter the System Keyword.
3. Enter the Description.
4. Select a Language.
5. Select a Class Name.
6. Select a Payment Class.
7. Select whether to use this payment in IsActive.
8. Select whether to use this payment in IsDefault.
9. Click Save. You can also click Cancel to exit without saving.

Select the payment method you just created and go to the Parameters tab. Click Add parameter.

1. Enter the parameter name as GatewayToken.
2. Enter the parameter value with the key that was created.

   

3. Click Save. You can also click Cancel to exit without saving.

Go to the payment method you just created. Go to Markets and select the active markets. Click Save if you made changes.

If you want to use 3DS, create two parameters with the following:

• ThreeDsIsEnabled – True
• ScaProviderKey – The key that was created

Click Save. You can also click Cancel to exit without saving.

You can create other methods and sort by IsActive, IsDefault then Ordering values.

How it works

The following flowchart demonstrates the payment service process during cart submission.