Soap API v1.2


Copy customer from one merchant to another.


This method allows you to copy a customer record from one merchant to another. This method is only available to merchants who have a master user setup to access both accounts.


CustNum copyCustomer ( ueSecurityToken FromToken, integer CustNum, ueSecurityToken ToToken)


Type Name Description
ueSecurityToken FromToken Merchant security token: used to identify the merchant that the customer is being copied from.
integer CustNum The gateway assigned customer number for the the customer to be copied.
ueSecurityToken ToToken Merchant security token: used to identify the merchant that the customer is being copied to.

Return Value

Integer Returns gateway assigned Customer Number of the new customer.



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

try { 
  // CustNum for Customer to Copy  
  // $toMerchToken is setup with sourcekey
  // for merchant being copied to
  $NewCustNum=$client->copyCustomer($token, $CustNum,$toMerchToken);
} catch(Exception $e)  { 
  echo 'Error: ' . $e->getMessage(); 


This example uses the USAePay Java library. For directions on how to install the library and create the token/client objects, go to either the Java JAX-RPC Howto or the Java JAX-WS Howto.

try {
  //CusNum From Customer to copy
  BigInteger CustNum = BigInteger("12345678");
  // toMerchToken is the token setup with a source key
  // for the merchant being copied to.
  BigInteger NewCustNum = client.copyCustomer(token, CustNum, toMerchToken);
} catch (Exception e) {
  System.out.println("Soap Exception: " + e.getMessage());


Dim client As usaepay.usaepayService = New usaepay.usaepayService
        Dim token1 As usaepay.ueSecurityToken
        Dim token2 As usaepay.ueSecurityToken
        token1 = Me.CreateToken("O_FIRST_SOURCE_KEY_8", "1234")
        token2 = Me.CreateToken("O_SECOND_SOURCE_KEY_8", "1234")
        Dim custNum As String
        custNum = "115163"
        Dim NewCust As String
        NewCust = client.copyCustomer(token1, custNum, token2)


usaepay.ueSecurityToken totoken = new usaepay.ueSecurityToken();
            usaepay.ueHash hash = new usaepay.ueHash();
            string sourcekey = "NEW SOURCE KEY";
            string pin = "new pin";
            totoken.SourceKey = sourcekey;
            hash.Type = "md5";
            hash.Seed = Guid.NewGuid().ToString();
            string prehashvalue = string.Concat(token.SourceKey, hash.Seed, pin);
            hash.HashValue = GenerateHash(prehashvalue);
            totoken.PinHash = hash;
            string CustNum = "89147";
            string NewCust;
                NewCust = client.copyCustomer(token, CustNum, totoken);
            catch (Exception err)
developer/soap-1.2/methods/copycustomer.txt · Last modified: 2010/10/20 11:52 by irina

Page Tools