JotForm User Guide / Advanced Features /

How to integrate CyberSource with JotForm

How to integrate CyberSource with JotForm

With a robust payment processing platform and fraud detection service, CyberSource has made it easy for merchants and organizations worldwide to securely collect money online.   


CyberSource, a Visa subsidiary, currently accepts payments from customers and donors in more than 190 countries and territories around the world. 


Even after payments are sent, CyberSource’s Decision Manager tool uses more than 300 detectors, such as biometrics and IP geolocation, to determine in seconds whether transactions are legitimate. The payment processor also allows merchants to customize their fraud protection settings to take into account unique circumstances, such as seasonal buying trends and product launches.

CyberSource, through its Secure Acceptance service, complies with the European Union’s new PSD2 regulation by authenticating payments using 3D Secure 2.0

This added layer of security, designed specifically for merchants that do business in Europe, relies on information gathered from cardholders and their devices, such as a one-time password, fingerprint scan, IP address, or geolocation data. Once provided, this information is compared with customer data that banks have on file.   

You must contact CyberSource to enable 3D Secure 2.0 and get the Cardinal credentials needed for 3D Secure 2.0 to work in JotForm’s integration.


How to install JotForm’s CyberSource integration


  1. Once you set up the CyberSource integration and add the payment field to your form, click on the Payment Settings icon. 


 


  1. In the CyberSource Integration menu that appears, enter the Merchant ID and Transaction Key information provided by CyberSource.


Pro tip: Use the scroll bar on the right side of the integration menu to navigate up and down. Using the arrow keys on your keyboard will only allow you to scroll up or down on your form and may cause you to lose unsaved changes in the integration menu. 


  1. Select the currency you want to use from the Currency dropdown menu. 



  1. Under Bill to, click on the dropdown menu and select the existing form field you want to use to fill in billing information. 



  1. Click on the Billing Address dropdown menu and select the form field you want to use to fill in billing information. 



  1. Use the Payment Type dropdown menu to indicate whether you want to sell products, sell subscriptions, collect an amount the customer chooses, or collect donations. 


  1. Regardless of which Payment Type selection you make, you’ll be asked in the Additional Gateway Settings menu whether you want to enable 3D Secure 2.0. If your business is based in Europe or if you have customers there, you must use the Yes-No toggle switch to select “Yes.”


If you enable 3D Secure 2.0, you must enter your Cardinal API Key, Cardinal API Identifier, and Cardinal OrgUnit ID in the fields that appear. 


Note: You must contact CyberSource to enable 3D Secure 2.0 and get the necessary Cardinal credentials for the JotForm integration to work. 


Note: If you selected User Defined Amount in the Payment Type field, continue to Step 8. If you selected Collect Donations, skip to Step 11. If you selected Sell Subscriptions, skip to Step 14. If you selected Sell Products, skip to Step 21. 


  1. If you selected User Defined Amount, you can change the Payment Box Sub Label field that appears below the payment box in your form. 



Use the Yes-No toggle switch in the Suggest an Amount field to indicate whether customers can enter a customized payment amount in the payment box. As an alternative, you can use the Get Price From dropdown menu to link the amount in the payment box with another field on your form. 


  1. If you turn on the Suggest an Amount option, you must enter an amount into the Suggested Amount field below the Yes-No toggle switch and indicate whether it should be the minimum amount that customers can pay.



  1. Click on the Additional Gateway Settings dropdown menu and use the Yes-No toggle switches to indicate whether you want to


  • Show the total price on your form

  • Test the CyberSource integration in sandbox mode

  • Enable authorization-only transactions


Note: Enabling Sandbox Mode will allow you to test the CyberSource integration on your form. After testing the integration, disable Sandbox Mode by clicking on the Yes-No toggle switch so it reflects a “No” selection. Test credit cards offered by CyberSource will allow you to test various scenarios that may arise while payments are processed. 



Once you’ve made all of your selections in the Additional Gateway Settings menu, click the Save button to finish setting up the integration. 


  1. If you selected Collect Donations in the Payment Type field, you can change the Payment Box Sub Label field that appears below the payment box in your form.



Use the Yes-No toggle switch in the Suggest an Amount field to indicate whether customers can enter a customized payment amount in the payment box. As an alternative, you can use the Get Price From dropdown menu to link the amount in the payment box with another field on your form.



  1. If you turn on the Suggest an Amount option, you must enter an amount into the Suggested Amount field below the Yes-No toggle switch and indicate whether it should be the minimum amount that customers can pay.



  1. Click on the Additional Gateway Settings menu, and use the Yes-No toggle switches to indicate whether you want to 


  • Test the CyberSource integration in sandbox mode

  • Enable authorization-only transactions


Note: Enabling Sandbox Mode will allow you to test the CyberSource integration on your form. After testing the integration, you should disable Sandbox Mode by clicking on the Yes-No toggle switch so it reflects a “No” selection. Test credit cards offered by CyberSource will allow you to test various scenarios that may arise while payments are processed. 



Once you’ve made all of your selections in the Additional Gateway Settings menu, click the Save button to finish setting up the integration.


  1. If you selected Sell Subscriptions in the Payment Type field, you must click on the Additional Gateway Settings menu and use the Yes-No toggle switches to indicate whether you want to


  • Test the integration in sandbox mode

  • Enable authorization-only transactions 

  • Allow customers to click on an image and preview it 

  • Use decimals when CyberSource calculates or displays prices


Note: Enabling Sandbox Mode will allow you to test the CyberSource integration on your form. After testing the integration, you should disable Sandbox Mode by clicking on the Yes-No toggle switch so it reflects a “No” selection. Test credit cards offered by CyberSource will allow you to test various scenarios that may arise while payments are processed.



  1. If you want to use decimals for prices displayed on your form, you must select either periods or commas. Once you’ve made all of your selections, click the Continue button. 



  1. In the Payment Settings menu that appears, click the Create New Subscription button to add a subscription to your CyberSource payment form. 



Pro tip: Use the gear icon to return to the CyberSource Integration menu at any time to change your settings. 



  1. Get started by adding a name for your new subscription and setting a price for it. 



  1. Use the Subscription Period dropdown menu to indicate how often customers will be billed.



  1. Click the Choose a File button under Image to add an image for the subscription. You can also upload a file from your computer by using the Upload File button or by dragging and dropping it from your files into the upload field. 



  1. Use the Yes-No toggle switches to determine whether you want to


  • Set a variable price for your subscription

  • Set an initial amount that customers will pay for a subscription 

  • Select this specific subscription as the default option 



Once you’ve made all of your selections, click the Save button to finish setting up the integration.


  1. If you selected Sell Products in the Payment Type field, use the Yes-No toggle switches to indicate whether you want to


  • Show the total price for a customer’s selections 

  • Let users select multiple products 

  • Test the integration in sandbox mode

  • Enable authorization-only transactions 

  • Allow customers to click on an image and preview it 

  • Use decimals when CyberSource calculates or displays prices  


Note: Enabling Sandbox Mode will allow you to test the CyberSource integration on your form. After testing the integration, you should disable Sandbox Mode by clicking on the Yes-No toggle switch so it reflects a “No” selection. Test credit cards offered by CyberSource will allow you to test various scenarios that may arise while payments are processed.  



  1. If you want to use decimals for prices displayed on your form, you must select periods or commas. Once you’ve made all of your selections, click the Continue button. 



  1. In the Payment Settings menu that appears, click the Create New Product button to add a product to your CyberSource payment form. 



Pro tip: Use the gear icon to return to the CyberSource Integration menu at any time to change your settings.



  1. Get started by adding a name for your new item and setting a price for it.



  1. Click the Choose a File button under the Image field to add an image for the product. You can also upload a file from your computer by using the Upload File button or by dragging and dropping it from your files into the upload field. 



  1. Use the Yes-No toggle switches to indicate whether you want to


  • Make this product a required purchase before your form can be submitted 

  • Use this specific product as a default option when customers fill out your form



Note: If this product is required for a purchase, it will be selected by default on your payment form. 


  1. If you want customers to have the option to buy a product in multiple quantities, click the Add button in the Add a Quantity Selector field. In the menu that appears, click on the dropdown menu and select whether you’d like the product quantity option on your form to appear as a dropdown menu or text box.   



If you selected Text Box from the list of menu options, you can change the Label field to show how the quantity option should read on your form. 


 


You can also set a default quantity number for customers as they’re filling out your form.



If you selected Dropdown from the list of menu options, you can change the Label field to show how the quantity option should read on your form. You must also set a maximum and minimum amount in the Range field for the number of items that individual customers can purchase. 



If you want to implement special prices based on the quantity of products a customer buys, you can customize that option by turning on the Yes-No toggle switch for the Special Pricing Per Quantity field. Use the provided table to change prices based on the corresponding product quantity that a customer selects.  



Once you’ve made your selections and adjusted your settings, click the Save Quantity button to save your product quantity preferences. 


  1. If you want customers to buy variations of your product, such as different colors or sizes, click the Add button in the Add a Product Option field. 


In the Product Option menu that appears, use the required Label field to indicate the product options that are available. You can also use the Yes-No toggle switches to create secondary products from your provided options and a special pricing scheme for people who buy a product in multiple quantities. 



Use the Populate Options from Presets dropdown menu to create a list of product options based on those used by other merchants. 


You can also create a product options list that’s unique to your business by typing each option into the provided table. 



Once you’ve created your product options list, click the Save Option button to save your preferences. 


  1. After setting all the options and details for your product, click the Save Product button in the Product Settings menu. 


  


  1. In the Payment Settings menu that appears, click the Create New Product button under the Products tab to add details for any additional products you’re selling, and repeat Steps 24 to 29. 


Note: Go to Step 37 if you want to charge for shipping. Go to Step 40 if you want to include charges for taxes. 


  1. Use the Coupons tab in the Payment Settings menu to create promotional offers for the products you’ll be selling. Click on the Create Coupon button to get started. 




  1. If you want to create a promotional offer, go to the Coupon Code tab to type in a unique code that customers can provide during the checkout process. Use the Coupon Limit dropdown menu to cap a coupon’s use based on a specific expiration date or number of uses. 


If you want to cap a coupon’s use based on a specific expiration date, enter it into the text box that appears. 



If you prefer to void a coupon after a specific number of uses, select that option in the Coupon Limit menu and enter the amount into the Coupon Limit Use Count text box that appears.  



  1. Use the Discount Type dropdown menu to indicate whether you want to offer a percentage or fixed amount discount for customers.


If you offer a discount at a certain percentage, enter it into the text box that appears.


If you want to offer a discount for a fixed amount of money, enter it into the text box that appears.



  1. Use the Apply Discount to dropdown menu to select whether your coupon should be applied to certain products, shipping costs, or the subtotal of a purchase.  



If you want a coupon to be applied to certain products, select which products will be eligible for a discount in the dropdown menu that appears. 



If you want a coupon to be applied to a customer’s shipping costs or the subtotal of an order, enter the minimum order amount that must be met before a discount can be applied. 



  1. If you’d like to customize any of the prompts that customers receive when they use a coupon, click on the Edit button under Edit Global Coupon Text



Once you’ve made all of your desired changes to the coupon prompts in the menu that appears, click the Save button at the bottom of the menu. 



  1. After all of your coupon preferences are set, click on the Save button at the bottom of the Payment Settings menu.



  1. If you want to account for shipping costs in your payment form, click on the Shipping tab in the Payment Settings menu. Use the Yes-No toggle switch to select whether you want customers to pay for shipping costs. 



  1. If you want to base shipping charges on the number of items a customer purchases, use the Shipping Text in Form text box to indicate how the charge will appear on your form. Enter the shipping costs per item and amount ordered using the table provided at the bottom of the menu. 



  1. If you want to set a flat rate for shipping products to customers, use the Flat Charge Rate text box to enter the amount you want to charge. Use the Shipping Text in Form text box to indicate how the charge will appear on your form. 



  1. If you want to want to include any tax-related charges on your form, click on the Tax tab in the Payment Settings menu. 


Use the Base Tax Rate text box to enter the tax rate that will be applied to nonexempt items, which can be selected in the Exempted Products dropdown menu. Use the Tax Text on the Form text box to select how the charge will appear on your payment form.





In the Set Tax Options from a Location Field dropdown menu, select a field on your form that can be used to enable location-based tax surcharges during the checkout process.



  1. Once you’ve made all of your selections and set all of your preferences in the Payment Settings menu, click on the gear icon to return to the main CyberSource Integration menu. 



  1. If it looks like everything is in order, click on the Continue button at the bottom of the CyberSource Integration menu to activate the integration on your form. 


 

Do you have any questions about JotForm’s CyberSource integration or suggestions on how we can make it better? We’d love to hear from you in the comments section below.


Send Comment