Welcome to Zuora Product Documentation

Explore our rich library of product information

Set up and configure a Helix payment gateway instance

Learn how to set up and configure a Helix payment gateway instance, including prerequisites, configuration procedures, and testing guidelines.

Set up and configure a Helix payment gateway instance by using the information in this article, including prerequisites, configuration procedure, descriptions of the configuration fields, and references for testing the payment gateway.

Configuration fields

Basic Information

  • Name : Specify a name for the gateway instance.

  • Use Gateway Test Environment : If you want the transactions to be processed by using the Helix test service endpoint, select this checkbox.

For more information about fields in the Basic Information section, see Common fields .

Credentials

  • Merchant Id : Enter the Merchant Id obtained from the J.P. Morgan Merchant_Payments API project.

  • Client Id : Enter the Client Id provided by J.P. Morgan during onboarding.

  • Resource Id : Enter the Resource Id provided by J.P. Morgan during onboarding.

  • Key Store : Upload the keystore file with .p12 as the extension. For how to generate the keystore file, see Prerequisites .

  • Key Store Password : Enter the Key Store password.

Rules

  • Cards Accepted : Select the credit cards that you accept.

  • Default Authorization Amount : Specify the minimum default amount used to process a payment. The default value of this field is 1.

  • Verify new payment method : If you want the payment methods to be verified when creating them, select this checkbox. By default, this checkbox is selected.

  • Verify updated payment method : If you want the payment methods to be verified when updating them, select this checkbox. By default, this checkbox is selected.

For more information about fields in the Rules section, see Common fields .

Test the configuration

For basic guidance on how to test payment gateway integrations within a sandbox environment, see Test payment gateway integration .

You can use the test card information and testing scenarios provided by the gateway vendor to test your integration. See J.P. Morgan’s documentation for details.

  • Overview of Helix payment gateway integration

  • Field mappings for credit card transactions through Helix