GetConfig

Purpose

Returns parameters to configure a plugin. See Plugin Configuration for more information.

Mandatory

Yes.

Input Parameters

None.

Response

An associative array that contains the following keys:

Param name Description Type
friendlyName The plugin title that will be displayed in the plug-in configuration page and in the gateway selection options. string
parameter_id

This defines a section or a parameter field. It can assume the section or param data type. The parameter_id itself is the name of the parameter.

Section | Param

Example

The following example shows the GetConfig method implementation in the Example plugin.

The following image shows how the configuration parameters can be set in the control panel. Billing uses the GetConfig response array to display that UI and, once Save is clicked, Billing saves data in its database. The stored configuration data will be sent to the plugin after the interaction with the plugin.

The following JSON fragment shows how configuration is sent to the plugin throughout the method request:

Copy
"config" : {
    "gateway_url" : "https://plugin-gateway-url.com",
    "auth_code" : 421,
    "format" : "json",
    "test_mode" : "yes"}

See Also

CloudBlue, an Ingram Micro business, uses cookies to improve the usability of our site. By continuing to use this site and/or logging in you are accepting the use of these cookies. For more information, visit our Privacy Policy.