Add support for account hierarchy

[aaron-junot]

This adds support for account hierarchy. Tests only include operations on the account object because there is no change in the response to create subscription and create purchase endpoints. Examples of this usage are included below.

Create an account with a parent account:

# Assumes 'example-124' exists but 'example-123' does not exist
try {
    $account = new Recurly_Account('example-123');
    $account->parent_account_code = 'example-124';
    $account->create();
  } catch (Recurly_ValidationError $e) {
    print "Invalid Account: $e";
  }

Get a parent account:

# Assumes 'example-123' has a parent account
$accountCode = 'example-123';
try
{
    $account = Recurly_Account::get($accountCode);
    $parent = $account->parent_account->get();
    print($parent);
}
catch(Recurly_Error $e)
{
    print("Caught an error:\n");
    print($e);
}
print("\n");

Get child accounts:

# Assumes 'example-124' has a child accounts
$accountCode = 'example-124';
try
{
    $account = Recurly_Account::get($accountCode);
    $children = $account->child_accounts->get();
    foreach ($children as $child) {
        print($child->account_code . "\n");
    }
}
catch(Recurly_Error $e)
{
    print("Caught an error:\n");
    print($e);
}

Remove a parent account:

# Assumes 'example-123' has a parent
$account = Recurly_Account::get('example-123');
$account->parent_account_code = '';

try {
    $account->update();
}
catch (Recurly_ValidationError $e) {
    print($e->getMessage());
}

Associate an account with a parent account on a subscription:

  # Assumes plan code 'silver' exists
  # Assumes account 'example-124' exists
  $subscription = new Recurly_Subscription();
  $subscription->plan_code = 'silver';
  $subscription->currency = 'USD';

  $account = new Recurly_Account();
  $account->account_code = 'example-123';
  $account->parent_account_code = 'example-124';
  $subscription->account = $account;

  $subscription->create();

  print "Subscription: $subscription\n";

Remove a parent by creating a subscription:

  # Assumes plan code 'silver' exists
  # Assumes account 'example-123' exists and has a parent
  $subscription = new Recurly_Subscription();
  $subscription->plan_code = 'silver';
  $subscription->currency = 'USD';

  $account = new Recurly_Account();
  $account->account_code = 'example-123';
  $account->parent_account_code = '';
  $subscription->account = $account;

  $subscription->create();

  print "Subscription: $subscription\n";

Associate an account with a parent by creating a purchase:

$purchase = new Recurly_Purchase();
$purchase->currency = 'USD';
$purchase->collection_method = 'automatic';
$purchase->account = new Recurly_Account();
$purchase->account->account_code = 'example-123';
$purchase->account->parent_account_code = 'example-124';
$subscription = new Recurly_Subscription();
$subscription->plan_code = 'silver';
$purchase->subscriptions = array($subscription);

// Create an invoice collection
try {
  $collection = Recurly_Purchase::invoice($purchase);
} catch (Recurly_Error $e) {
    print("There was an error!\n");
    print($e);
}

Remove a parent account by creating a purchase:

$purchase = new Recurly_Purchase();
$purchase->currency = 'USD';
$purchase->collection_method = 'automatic';
$purchase->account = new Recurly_Account();
$purchase->account->account_code = 'example-123';
$purchase->account->parent_account_code = '';
$subscription = new Recurly_Subscription();
$subscription->plan_code = 'silver';
$purchase->subscriptions = array($subscription);

// Create an invoice collection
try {
  $collection = Recurly_Purchase::invoice($purchase);
} catch (Recurly_Error $e) {
    print("There was an error!\n");
    print($e);
}

[bhelx]

Is there a reason we need to create new fixtures for all these? Could we possibly re-use fixtures? I'm open to either but I find adding fixtures to be cumbersome since they are managed by hand. They tend to go stale quick.

[bhelx]

I'm okay with it 👍

[bhelx]

👍