addProductCategory

This method creates a new product category record and returns a ProductCategoryRefNum

Description

The addProductCategory method creates a new product category record. If successful, a ProductCategoryRefNum will be returned. The ProductCategoryRefNum is a gateway assigned product category identifier. This product category identifier should be stored and is needed for updating and deleting product categories. The product database is an optional feature and may not be supported by all merchants. The merchant should check their gateway package to determine if this feature is available to them.

Syntax

string addProductCategory ( ueSecurityToken,ProductCategory)

Arguments

Type	Name	Description
ueSecurityToken	Token	Merchant security token: used to identify merchant and retrieve the custom fields.

Return Value

string

Returns a ProductCategoryRefNum.

Exceptions

The following exceptions (errors) are applicable to this method.

Code	Message	Advice
41001	Unable to create product database	Merchant does not have a product database. The feature not be enabled for merchant. Contact customer service and make sure product database feature is enabled.

Examples

PHP

<?php

VB

Dim category As eBizCharge.ProductCategory = New eBizCharge.ProductCategory

category.Name = "The first"

Dim response As String

response = client.addProductCategory(token, category)

MsgBox(response)

.NET C#

eBizCharge.ProductCategory category = new eBizCharge.ProductCategory();

category.Name = "The first";

string response;

try

{

response = client.addProductCategory(token, category);

MessageBox.Show(string.Concat(response));

}

catch (Exception err)

{

MessageBox.Show(err.Message);

}

XML

Request:

<?xml version="1.0" encoding="UTF-8"?>

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:ns1="urn:eBizCharge" xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"

SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<SOAP-ENV:Body>

<ns1:addProductCategory>

</PinHash>

<SourceKey xsi:type="xsd:string">HB4P7C4K2w2ZCQQQXRqrxDj6agrS2NIT</SourceKey>

</Token>

<Name xsi:type="xsd:string">Example Category</Name>

</ProductCategory>

</ns1:addProductCategory>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Response: