Skip to content

Payeezy

The JustOn Self-Service Extension can integrate with Payeezy as a payment provider. The implementation supports payments via credit card.

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).

Info

Payeezy can use multi-pay tokens to pre-authorize and execute subsequent financial transactions without the need to prompt users for card or account numbers. The JustOn Self-Service Extension supports Payeezy multi-pay tokens, exposing the feature as Future Payments option. For details about payment data tokenization, see TransArmor/Tokenization in the Payeezy Knowledge Base.

Note

The Payeezy implementation is currently unable to handle credit cards that require the 3-D Secure protocol. It is therefore not possible to use Payeezy to collect payments in the European Economic Area (EEA) due to restrictions imposed by the Revised Payment Services Directive (PSD2) and the mandatory Strong Customer Authentication (SCA).

JustOn recommends to use Stripe, PayPal or CyberSource for the European market instead.

Configuring Payeezy Integration

To configure the Payeezy integration with the JustOn Self-Service Extension:

  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 payment provider and click New to create a new configuration, or click Edit next to an existing configuration to modify it.

    You can create one active payment configuration per tenant and payment provider. Before creating a new configuration for a tenant/provider combination that already exists, you must deactivate the existing configuration.

  3. Select the tenants for which the configuration is applicable.

    If there is no tenant selected, this configuration is used by default for all tenants.

  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.

    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.
    Enable Future Payments Select this checkbox if you want to enable the future payments feature. When checked, the future payment option is visible on the payment form, allowing the user to opt for it.
    Future Payments Active Select this checkbox if you want to activate the future payments feature by default. This creates a corresponding payment instrument, which is saved on the account.
    JustOn recommends to activate this setting in combination with Future Payments Changeable to allow users to opt out.
    Future Payments Changeable Select this checkbox if you want users to be able to override the Future Payments Active value in the payment form.
    Be aware that this setting has no effect once users have opted to use future payments. If required or on users' request, you deactivate individual payment instruments manually.

    When editing existing configurations, key and secret values are not displayed. Key and secret values remain unchanged as long as you leave the corresponding fields empty.

  6. Click Add for new configurations or, respectively, Save for existing configurations.

Info

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