Data Model

Section

Defines a section in the plug-in configuration page. It is an associative array that contains the following parameters:

Param name Description Type
type

This must assume the section value in the section definition.

string
friendlyName

The section name.

string
items

An associative array, the keys of which are the name of the parameter and the values are the param data type.

Param

Param

Defines a configuration parameter in the plug-in configuration page. It is an associative array that contains the following parameters:

Param name Description Type
type

The parameter type. Valid values are:

  • text
  • integer
  • password
  • textarea
  • yesno
  • dropdown
  • radio
string
friendlyName

The name that will be displayed in the configuration page in the control panel.

string
options

(Optional) An array of values to be displayed in the combobox. This must be used when type is dropdown.

array
size (Optional) The data size limitation. integer
default (Optional) The parameter default value. string
required (Optional) This defines that the parameter is required and will be marked with a red star '*' in the plug-in configuration page. boolean
min (Optional) The minimum parameter value. integer
max (Optional) The maximum parameter value. integer

Environment 

Contains the Billing environment information.

Param name Description Type
lang The language (ISO_3166-1_alpha-2 code) configured in Billing (that is, the provider's location). string
system_host The Billing hostname. string

return_url

The Billing URL that is used for returning back from the payment gateway site to the CloudBlue Commerce site.

This URL is meant to be used in a redirect scenario when the customer's browser must be redirected back to the CloudBlue Commerce site.

When the return_url is requested, Billing calls the plug-in Callback method, which processes the received data and sends back a response to Billing. Billing processes the response data accordingly and responds with the HTTP 302 Found status with the CloudBlue Commerce URL to the browser, which redirects the customer to the CloudBlue Commerce site. For details, see Redirect Workflow.

string
return_url_ok

The Billing URL that is used for returning back from the payment gateway site to the CloudBlue Commerce site with the success status.

This URL works similarly to the return_url URL, but must be used for the successful status response only. For example, when the payment gateway processes a request successfully, it can redirect back to return_url_ok instead of redirect to return_url with the success status.

After a request is received though this URL, Billing assigns the returnResult parameter to ok, adds it to the parameters received from the payment gateway, and calls the plug-in Callback method, passing the parameters.

string
return_url_failed

The Billing URL that is used for returning back from the payment gateway site to the CloudBlue Commerce site with the failed status.

This URL works similarly to the return_url_ok URL, but the fail status value will be assigned to the returnResult parameter.

string

notify_url

The Billing URL that is used for receiving notifications from the payment gateway. It is designed to handle the server-to-server communication.

This URL is meant to be used in the scenario where the payment gateway servers call Billing to notify an update in the Billing payment transaction status.

When Billing receives a request through this URL, it calls the plug-in Callback method, which processes the data received in the request and sends back a response to Billing. Billing processes the response data accordingly and returns HTTP 200 OK with application/json Content-type, and an optional content body. Note that this URL response does not imply a redirection in the caller like the return_url URL does.

This URL is also used in the scenario where there is an interaction between a UI page in UX1 and the plugin. For details, see Modal Form Workflow.

string
return_url_3dsecure

The Billing URL that can be used for returning back from the 3D Secure gateway.

This URL is meant to be used in the 3D Secure scenario.

string

AccountDetails

Accounts details.

Param name Description Type Notes
id The customer account identifier in Billing. integer
type

The account type:

  • 0: a provider

  • 2: a reseller

  • 3: a customer

integer
is_corporate

A company or a personal account.


boolean
name

The full account name.

string
billing_fname

The Billing contact's first name


string
billing_mname

The Billing contact's middle name.

string
billing_lname The Billing contact's last name. string
billing_email The Billing contact's email address. string
billing_phone The Billing contact's phone number. PhoneInfo
billing_fax The Billing contact's fax number. PhoneInfo
tax_ex_number

The taxation number.

string
address_address1 The customer's first address. string
address_address2 The customer's second address. string
address_city The customer's city. string
address_state The customer's state in the short format. string
address_country The customer's country in the short format. string
admin_fname

The administrative contact's first name.

string Filled when the account type is provider or reseller.
admin_mname The administrative contact's middle name. string
admin_lname The administrative contact's last name. string
admin_email The administrative contact's email address. string
admin_phone

The administrative contact's phone number.

PhoneInfo
admin_fax The administrative contact's fax number. PhoneInfo
technical_fname

The technical contact's first name.

string
technical_mname The technical contact's middle name. string
technical_lname The technical contact's last name. string
technical_email The technical contact's email address. string
technical_phone The technical contact's phone number. PhoneInfo
technical_fax The technical contact's fax number. PhoneInfo

DocumentInfo

The payment document description.

Param name Description Type
id The document ID in Billing. integer
total The total amount in the document (can be different from transaction_amount). double
currency The document currency. string
description The document description. string

PhoneInfo

Param name Description Type
country_code The country code.
string
area_code The area code.
string
number The phone number.
string
extention The phone extension.
string
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.