Skip to content

Payment Provider Integration

The JustOn Self-Service Extension includes a payment page. Use this page to provide your users the option to complete their checkout process, directly paying for their purchases. To this end, the JustOn Self-Service Extension can integrate with payment service providers.

Payment Page Setup

To set up the payment page as part of the JustOn Self-Service Extension, follow the instructions given in Site Setup and Access Settings.

Provider-Specific Setup

Depending on the payment provider you use, you must specifically configure the account access. To this end, the JustOn Self-Service Extension provides the Payment Provider Setup page.

The setup page is divided into two sections:

  • The first section lists the existing configurations and lets you disable/enable or delete them.
  • The second section allows you to add a new configuration.

To configure your payment provider:

  1. Open the Payment Provider Setup page.
    Open the Payment Provider Setup page directly, or navigate to Visualforce Pages > PaymentProviderSetup in Setup, and open the preview.
  2. Select the tenants for which the configuration is applicable.
    If there is no tenant selected, this configuration is used by default for all tenants.
  3. Select the payment provider.
  4. Specify a name for this configuration setting.
    Make sure to use a descriptive name that helps to unequivocally identify the configuration setting.
  5. Specify the provider-specific configuration.
    For details, see
    Configuring PayPal Integration
    Configuring Payeezy Integration
    Configuring CyberSource Integration
  6. Click Add.

PayPal

Creating PayPal Account

In order to use PayPal as a payment provider, you need a valid PayPal business account. To create it, navigate to the PayPal website and follow PayPal's instructions.

PayPal supports sandbox and live operation modes.

Configuring PayPal Integration

To configure the PayPal integration with the JustOn Self-Service Extension, you need the following information:

Field Required
Account ID
API Password
API Username
Signature

For more details, see the API access setting in your PayPal profile.

Payeezy

Creating Payeezy Account

In order to use Payeezy as a payment provider, you need a valid Payeezy account. To create it, navigate to the Payeezy website and follow Payeezy's instructions.

The JustOn Self-Service Extension integrates with the PAYEEZY.JS REST API. For details about how to set up and configure PAYEEZY.JS, refer to the Payeezy integration documentation, and select PAYEEZY.JS > View Guide.

Payeezy supports sandbox and live operation modes as well as multiple merchant configurations. See merchant as a registered (sub) division of your organization (similar to the JustOn tenant).

Configuring Payeezy Integration

To configure the Payeezy integration with the JustOn Self-Service Extension, you need the following information:

Field Required Notes
API Key Find this information in your Payeezy API settings.
API Secret Find this information in your Payeezy API settings.
Merchant Token Find this information in your Payeezy Merchant settings.
Merchant JS Security Key Find this information in your Payeezy Merchant settings.
Use Sandbox (checkbox) Select this checkbox if the API key and API secret are taken from a Sandbox API.

Info

If you use multiple tenants, create a Payeezy merchant for each tenant. Consequently, you need an individual Payeezy configuration for each merchant.

CyberSource

Creating CyberSource Account

In order to use CyberSource as a payment provider, you need a valid CyberSource account. CyberSource supports test and live operation modes. Depending on the mode, log in to the CyberSource Business Center to create and set up an account:

Configuring CyberSource Profile

JustOn uses the CyberSource Secure Acceptance Web/Mobile payment interface. After creating an account, you must create and configure a corresponding profile. Refer to the CyberSource Secure Acceptance Web/Mobile Quick Start Guide for a step-by-step description of how to create and configure profiles. The required setup steps include

  • Creating an account
  • Creating a profile
  • Adding payment methods
  • Creating security keys

In addition, you must apply the following JustOn-specific settings to your profile in the CyberSource Business Center:

Merchant Notifications
  1. Activate the Merchant POST URL checkbox.
  2. Specify the POST URL.
    The URL is made up of the Salesforce Force.com site URL, the port 443 and the Visual Force page ONBSE1.CyberSourceNotification, like
    https://INSTANCE.force.com:443/ONBSE1__CyberSourceNotification

Info

Find the required Force.com site URL on the Sites page in Setup. Type Sites in the Quick Find box, or navigate to User Interface > Sites and Domains > Sites.

Customer Response Pages
  1. Select Hosted by You for the Transaction Response Page and the Custom Cancel Response Page.
  2. Provide the response page URL.
    The URL is made up of the Salesforce Force.com site URL, the port 443 and the Visual Force page ONBSE1.CyberSourceBuyerReturn, like
    https://INSTANCE.force.com:443/ONBSE1__CyberSourceBuyerReturn

Info

Find the required Force.com site URL on the Sites page in Setup. Type Sites in the Quick Find box, or navigate to User Interface > Sites and Domains > Sites.

Payment Form

The Payment Form allows to configure which billing information is displayed on the checkout form. Depending on the configured payment methods and the billing address, most of the fields are required for a successful payment, like the State field, which is required if the country is US or CA.

JustOn passes all required data to the checkout form as far as the data is available on the invoice.

Info

In order to avoid failing payments due to missing data, JustOn recommends to make the following billing information fields on the invoice editable and required. This forces the user to enter missing data.

Invoice Field CyberSource Billing Information Field
Email First Name First Name
Email Last Name Last Name
Account Name Company
Billing Street Street Address 1
Billing City City
Billing State Code State
Billing Country Code Country
Email Email Address

CyberSource requires two-character country and state codes. To simplify the address data handling, JustOn recommends to use the built-in Salesforce picklists for countries and states. For details, see Let Users Select State and Country from Picklists in the Salesforce Help.

Configuring CyberSource Integration

To configure the CyberSource integration with the JustOn Self-Service Extension, you need the following profile information. Find it in the CyberSource Business Center in Tools & Settings > Secure Acceptance > Profiles.

Field Required Notes
Profile ID General Settings
Access Key Security - select a key
Secret Key Security - select a key
Use Test Mode (checkbox) Select this checkbox if the API key and API secret are taken from a test account.