Account.update
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.update
The update method creates an Account object, or updates an existing one. Use the update method when a new customer record is created.
To create an Account object, initialize it and set the values for its data members as appropriate, and then call the update method to store the changes. When creating a new Account object, do not set a value for VID; Vindicia Subscribe will automatically generate a VID for the object when you call update. When updating an existing Account object, identify it with its VID or your account ID (merchantAccountId).
Note Do not call update to add or change a payment method for Account. Call Account.updatePaymentMethod instead. (See the Account.updatePaymentMethod method.)
When you update an Account, Vindicia Subscribe edits the existing Payment Method.
- If the merchantPaymentMethod of an existing Payment Method is passed, then that Payment Method is edited. If replaceOnAllAutoBills is false, this edit is applied to all AutoBills using that Payment Method, and no other.
- If a new merchantPaymentMethodId is passed, then a new Payment Method is created. If replaceOnallAutoBills is false, then the new Payment Method will not be applied to any AutoBills. If it is true, it will be applied to all.
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.
account: the Account object to create or update. Use the merchantAccountId or VID to identify the object.
Output
return: an object of type Return that indicates the success or failure of the call.
account: the Account object you created or updated.
created: a Boolean flag that, if set to true, indicates that update has created a new Account object. Afalse setting means that update has updated an existing Account object.
Returns
In addition to those listed in Standard Return Codes, this call returns:
Return Code |
Return String |
400 |
One of the following:
|
Example
// Create a new Account object
$account = new Account();
// Provide basic account information
$account->setName('Somebody Q. Customer'); // Customer name
$account->setMerchantAccountId('IN9430-8421'); // Unique customer id
// To create address information, create an address object
$address = new Address();
$address->setAddr1('123 Main Street');
$address->setAddr2('Apt. 4');
$address->setCity('San Carlos');
$address->setDistrict('CA');
$address->setPostalCode('94070');
$address->setCountry('US');
$address->setPhone('123-456-7890');
// Associate the Address object with the account
$account->setShippingAddress($address);
// Emails
$account->setEmailAddress('John.Doe@gmail.com');
$account->setEmailTypePreference('html');
$account->setWarnBeforeAutoBilling(true);
// Okay, basic information is entered, so save the account
$response = $account->update();
// Check to see that the account was created
if($response['returnCode'] == 200) {
// You can save the VID (Vindicia ID) for later use
$accountVid = $account->getVid();
}
For Users
Learn More