Creating a Payment gateway connector

To create a Payment gateway connector:

1. Sign in to the Operator Control Panel on the root Reseller level.
2. On the Navigation Bar, go to Payment Gateway Connectors (see Navigation). The list of Payment gateway connectors is displayed (see Viewing the list of Payment gateway connectors).
3. On the Toolbar, click Create. The New Payment Gateway Connector page is displayed.
   
   
   
   
4. In the Name field, enter the Payment gateway connector name displayed in a Payment Method configuration (see Creating a Payment Method).
5. In the Connector URL field, enter the URL to which ActivePlatform will send requests working with the payment gateway. Example: https://gateway.example.com

6. In the JSON Schema field, enter the data specification in the JSON format of the Payment gateway connector settings to be specified later in a Payment Method configuration (see Creating a Payment Method).

   More about JSON schemas

   A JSON schema is an array of objects that describes the Payment gateway connector settings. It includes field types, requirements to their values, and the displaying order of the corresponding HTML elements (text fields, checkboxes, lists, etc.) in the Connector settings group of a Payment Method with Integration type = External Payment Gateway (see Creating a Payment Method).

   A JSON schema supports the following fields:

   Name	Type	Required	Unique	Description
   type	String	Yes	No	HTML element type: string — one-line text input field. password — one-line password input field. Entered symbols are masked. text — multi-line text input field. select — list that allows selecting one of the options. radio — group of radio buttons that allows selecting one of the options. checkbox — group of checkboxes that allows selecting any of the options.
   key	String	Yes	Yes	Field key
   label	String	Yes	Yes	HTML element label
   hint	String	No	No	Text of the hint that is displayed on hovering on an icon next to the label. The icon is displayed if the hint filed in non-empty
   required	Boolean	Yes	No	Defines whether the element must be specified
   default_value	String	No	No	The default value. For the select, radio, checkbox fields, the default value must match one of the value of the options
   options	Array of Objects	No	No	Array of objects that defines the list of available options. For the select, radio, checkbox fields only. Each object includes the following fields: Name Type Required Description value String Yes The value of the option name String Yes The displayed name of the option
   priority	Number	No	No	Defines the displaying order of the corresponding HTML elements. Fields with the lower priority values are displayed higher

   Example of a JSON schema:

   [
     {
       "type": "string",
       "key": "api_username",
       "label": "API Username",
       "hint": "Your PayPay Username",
       "required": true,
       "default_value": "",
       "options": [],
       "priority": 1
     },
     {
       "type": "password",
       "key": "api_password",
       "label": "API Password",
       "hint": "Your PayPay Password",
       "required": true,
       "default_value": "",
       "options": [],
       "priority": 2
     },
     {
       "type": "select",
       "key": "integration_type",
       "label": "Integration Type",
       "hint": "Your Integration Type",
       "required": true,
       "default_value": "type-1",
       "options": [
         {
           "value": "type-1",
           "name": "Type 1"
         },
         {
           "value": "type-2",
           "name": "Type 2"
         }
       ],
       "priority": 3
     }
   ]

   Example of Payment gateway connector settings for this JSON schema:

   

7. Click Create. The platform validates the JSON schema:
   • If the JSON schema is valid, the list of Payment gateway connectors is displayed, including the created Payment gateway connector.
   • If the JSON schema is not valid, the error message is displayed, including the description of the problem items.

After creating the Payment gateway connector, the platform automatically generates the hash function key (see Secret Shared Key in Viewing and updating Payment gateway connector's details).