developer:soap-1.6:methods:copycustomer

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

developer:soap-1.6:methods:copycustomer [2012/08/04 11:04] (current)
tem created
Line 1: Line 1:
 +<embed ..:​contents/>​====== copyCustomer ======
  
 +Copy customer from one merchant to another.
 +
 +===== Description =====
 +
 +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. ​  
 +
 +
 +===== Syntax =====
 +
 +CustNum **copyCustomer** ( [[..:​objects:​ueSecurityToken]] FromToken, integer CustNum, [[..:​objects:​ueSecurityToken]] ToToken) ​
 +
 +
 +===== Arguments =====
 +
 +^Type   ​^Name ​  ​^Description ​  ^
 +|[[..:​objects:​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. |
 +|[[..:​objects:​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. |
 +
 +===== Examples =====
 +
 +==== PHP ====
 +
 +For directions on how to set up the WSDL link, create "​$token"​ and "​$client",​ go to [[..:​howto:​php|PHP Soap How-to]].
 +
 +<code php>
 +<?​php ​
 +
 +try { 
 +
 +  // CustNum for Customer to Copy  ​
 +  $CustNum="​12345678";​
 +
 +  // $toMerchToken is setup with sourcekey
 +  // for merchant being copied to
 +  $NewCustNum=$client->​copyCustomer($token,​ $CustNum,​$toMerchToken);​
 +
 +} catch(Exception $e)  { 
 +
 +  echo '​Error:​ ' . $e->​getMessage(); ​
 +
 +
 +
 +?>  ​
 +</​code>​
 +
 +==== Java ====
 +
 +This example uses the [[developer/​javalibrary|USAePay Java library]]. ​ For directions on how to install the library and create the token/​client objects, go to either the [[..:​howto:​javajaxrpc|Java JAX-RPC Howto]] or the [[..:​howto:​javajaxws|Java JAX-WS Howto]].
 +
 +
 +<code java>
 +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());​
 +}
 +</​code>​
 +
 +==== .NET VB ====
 +<code vb>
 +Dim token1 As usaepay.ueSecurityToken
 +        Dim token2 As usaepay.ueSecurityToken
 +
 +        token1 = Me.CreateToken("​source key of the merchant1",​ "​1234"​)
 +        token2 = Me.CreateToken("​source key of the merchant2",​ "​1234"​)
 +
 +        Dim custNum As String
 +        custNum = "​103125"​
 +        Dim NewCust As String
 +
 +        NewCust = client.copyCustomer(token1,​ custNum, token2)
 +        MsgBox(NewCust)
 +</​code>​
 +
 +==== .NET C# ====
 +For directions on how to set up the WSDL link and create the "​token"​ and "​client"​ variables, go to the [[..:​howto:​csharp|C Sharp .Net Soap How-to]].
 +<code c>
 +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;
 +
 +            try 
 +            {
 +                NewCust = client.copyCustomer(token,​ CustNum, totoken);
 +                MessageBox.Show(string.Concat(NewCust));​
 +            }
 +
 +            catch (Exception err)
 +            {
 +                    MessageBox.Show(err.Message);​
 +            }
 +</​code>​
 +
 +===== Change History =====
 +
 +^ Version ^ Change ^
 +| [[developer:​soap-1.1:​methods:​copycustomer|1.1]] | Method added prior to soap-1.1 |
developer/soap-1.6/methods/copycustomer.txt ยท Last modified: 2012/08/04 11:04 by tem

Page Tools