activateMerchantApplication

Reseller only method

Description

This method activates a pending merchant application, creating the production merchant account and any sourcekeys and usernames. Once this command is run, the merchant can start processing. The merchant application can be one added via the reseller console or the addMerchantApplication method). The application ID that was obtained when adding the merchant application must be passed.

The MerchRefNum of the newly created merchant will be returned.

See also addMerchantApplication

Syntax

string addMerchantApplication ( ueSecurityToken Token, integer ApplicationID )

Arguments

Type Name Description
ueSecurityToken Token Reseller security token, used to identify reseller and validate request.
integer ApplicationID The merchant application number assigned by the gateway.

Return Value

integer Returns merchant reference number that was assigned to the new merchant account.

Exceptions

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

Code Message Advice
19022 Permission denied Source key does not have permission to run this method. The reseller needs to edit the key and enable this method
19021 Permission denied Reseller does not have permission to activate merchants. Please contact reseller support for information on getting this feature enabled.
19031 Application has already been activated The specified application as already been activated. Use getMerchantApplicationStatus to query for the merchrefnum
19032 Merchant creation failed An internal system error prevented the merchant account from being activated. Please try again or contact support.

Examples

PHP

For directions on how to set up the WSDL link, create "$token" and "$resclient", go to PHP Soap How-to.

    <?php

    try {

      $ApplicationID=2;

      $MerchRefNum=$resclient->activateMerchantApplication($restoken, $ApplicationID);

    }

    catch (SoapFault $e) {

      echo $client->__getLastRequest();
      echo $client->__getLastResponse();
      die("getMerchantApplicationStatus failed: " .$e->getMessage());

    }

    ?>

Change History

Version Change
1.5 Method added in this release