Account.transfer
Web Session Object
Transaction Object
Token Object
Season Set Object
Refund Object
RatePlan Object
Product Object
Payment Provider Object
Payment Method Object
NameValuePair Object
GiftCard Object
Entitlement Object
Chargeback Object
Campaign Object
BillingPlan Object
AutoBill Object
Address Object
Activity Object
Account Object
Account.transfer
Customers often create multiple accounts on merchant sites. Because these accounts are essentially duplicates, you might receive a request from a customer to consolidate the billing for two accounts that customer has with you. Use the transfer method to consolidate billing for two accounts held by a single customer.
The transfer call merges the contents and related objects of two Account objects, and returns the target account with the merged content.
The transfer method:
- Transfers the payment methods, chargebacks, tax exemptions, AutoBill objects, activities, token grants and deductions, transactions, and name–value pairs associated with the source account into the target account.
- Strips all of the above contents from the source account, which will, however, continue to exist in Vindicia Subscribe with some basic attributes.
- Creates two name–value pairs with the names VIN_MERCHANT_CUSTOMER_ID_UPDATED_FROM
and VIN_MERCHANT_CUSTOMER_ID_UPDATED_DATE in each of the AutoBill objects transferred, thus specifying the original merchantAccountId value associated with the AutoBill object and the date on which the ID was transferred.
The two Accounts specified as input must exist prior to the transfer call, or an error will be returned.
Input
srd: sparse response description, a SOAP string (which must be a JSON object), in which you specify the elements you want returned.This parameter enables the calling system to constrain a method call to return only components you specify. This gives you greater control over returned content, and improves response time within the Vindicia platform by reducing the processing needed for the call.
Some fields are required, either practically or in the WSDL, and will be returned regardless of the srd. A null srd returns the complete response.
targetAccount: the Account object into which you wish to transfer all content from the source account.
sourceAccount: the Account object whose content you wish to transfer to the target account.
Output
return: an object of type Return that indicates the success or failure of the call.
mergedAccount: the account that contains the merged content of the target and source accounts.
Returns
In addition to those listed in Standard Return Codes, this call returns:
Return Code |
Return String |
400 |
One of the following:
|
Example
$targetAcct = new Account();
// Reference an existing account into which the contents will be
// merged
$targetAcct->setMerchantAccountId('9876-5432');
$sourceAcct = new Account();
// Reference an existing account from which we want to transfer
// contents
$sourceAcct->setMerchantAccountId('4932-5301');
// make the SOAP call to retrieve tokens
$response = $targetAcct->transfer($sourceAcct);
if($response['returnCode']==200) {
$mergedAcct = $response['mergedAccount'];
// process or verify contents of the merged account here
}
For Users
Learn More