API version 2.7

[bhelx]

API v2.7 only has 1 feature, the updates to the purchases endpoint.

$purchase = new Recurly_Purchase();
$purchase->currency = 'USD';
$purchase->collection_method = 'automatic';
$purchase->account = new Recurly_Account();
$purchase->account->account_code = 'aba9209a-aa61-4790-8e61-0a2692435fee';
$purchase->account->first_name = "Benjamin";
$purchase->account->last_name = "Du Monde";
$purchase->account->address->phone = "555-555-5555";
$purchase->account->address->email = "verena@example.com";
$purchase->account->address->address1 = "123 Main St.";
$purchase->account->address->city = "San Francisco";
$purchase->account->address->state = "CA";
$purchase->account->address->zip = "94110";
$purchase->account->address->country = "US";

$billing_info = new Recurly_BillingInfo();
$billing_info->number = '4111-1111-1111-1111';
$billing_info->month = 12;
$billing_info->year = 2019;
$billing_info->verification_value = '123';
$billing_info->address1 = '400 Alabama St';
$billing_info->city = 'San Francisco';
$billing_info->state = 'CA';
$billing_info->country = 'US';
$billing_info->zip = '94110';

$purchase->account->billing_info = $billing_info;

$adjustment = new Recurly_Adjustment();
$adjustment->unit_amount_in_cents = 1000;
$adjustment->quantity = 1;

$purchase->adjustments = array($adjustment);

$subscription = new Recurly_Subscription();
$subscription->plan_code = 'pp';

$purchase->subscriptions = array($subscription);

$purchase->coupon_codes = array('couponcode', 'rqw311ofo6');

$gift_card = new Recurly_GiftCard();
$gift_card->redemption_code = "FCJ7GEY4HO8WR16Q";
$purchase->gift_card = $gift_card;

try {
  $invoice = Recurly_Purchase::invoice($purchase);
  print($invoice);
} catch (Recurly_ValidationError $e) {
  print($e);
} catch (Recurly_Error $e) {
  print($e);
}

[drewish]

Looking at the PHPDoc docs for types, it seems like we can document the types in the array using:

 * @property string[] $coupon_codes An array of coupon codes to apply to the purchase
 * @property Recurly_Subscription[] $subscriptions An array of subscriptions to apply to the purchase

Also, I'm not sure apply is the right verb to use for subscriptions.

[drewish]

let's change A GiftCard to A gift card

[drewish]

I think we'd talked about moving this up the inheritance tree at one point since there's a few classes using it. What do you think about doing that as part of this PR?

[drewish]

@bhelx and I discovered that we can't remove this or it'll break the serialization for the subscription creation endpoint. it was being removed because the purchases endpoint doesn't allow an empty array. we need to get get a fix into the purchases endpoint before we can merge this.

[bhelx]

Right, it works for purchases if we remove this line here, but breaks the library in other places.