developer:soap-1.4:methods:movecustomer

Soap API v1.4

moveCustomer

Move customer from one merchant to another.

Description

This method allows you to move a customer record from one merchant to another. It includes the stored payment methods. This method is only available to merchants who have a master user setup to access both accounts. The move method copies the customer information to the new merchant and then deletes the original customer, at which time a new CustNum is assigned.

Syntax

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

Arguments

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

Return Value

Integer Returns gateway assigned Customer Number of the new customer.

Examples

Java

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 {
  //Set CustNum to the customer number that you want to move.  "merch2token" 
  //represents a token set up under the merchant the customer is being moved to.
  BigInteger CustNum = new BigInteger("123456");
  BigInteger NewCustNum = client.moveCustomer(token, CustNum, merch2token);
 
  System.out.println(NewCustNum);
} catch (Exception e) {
    System.out.println("Soap Exception: " + e.getMessage());
}

.NET VB

Dim client As usaepay.usaepayService = New usaepay.usaepayService
        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.moveCustomer(token1, custNum, token2)
        MsgBox(NewCust)

.NET C#

For directions on how to set up the WSDL link and create the “token” and “client” variables, go to the C Sharp .Net Soap How-to.

 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.moveCustomer(token, CustNum, totoken);
                MessageBox.Show(string.Concat(NewCust));
            }
 
            catch (Exception err)
            {
                MessageBox.Show(err.Message);
            }

Change History

Version Change
1.1 Method added prior to soap-1.1
developer/soap-1.4/methods/movecustomer.txt · Last modified: 2012/03/29 08:23 by nell

Page Tools