Recurly PHP Client

This PHP library can be used in creating one-time payment forms, recurring billing forms, subscription plans, and many other more, all powered by the Recurly API.

The PHP client works in tandem with the Recurly.js JavaScript client, allowing developers to create complex financial transaction and payment forms, that handle funds directly from the user's credit card, without going through any intermediary services.

Various card types are supported, along with push notifications, system error handling, and adjacent documentation.

What is new in this release:

• Force cURL to validate SSL certificates.
• Removing `balance_in_cents_invoiced` and `balance_in_cents_uninvoiced` from `Recurly_Account`. They were never added to the API.
• Added `tax_code` to `Recurly_Plan`, `Recurly_Addon` and `Recurly_Adjustment`
• Added invoice previews: `Recurly_Invoice::previewPendingCharges($accountCode)`
• Added `terms_and_conditions` and `customer_notes` to `Recurly_Invoice`
• Added `vat_location_valid` field to `Recurly_Account`
• Added `updateNotes()` and `vat_reverse_charge` to `Recurly_Subscription`.
• Added `vat_reverse_charge_notes` to `Recurly_Invoice`.
• Added `invoice_number_prefix` and `invoiceNumberWithPrefix()` to `Recurly_Invoice`. This is to be used with the Country Invoice Sequencing feature.

What is new in version 2.4.3:

• Force cURL to validate SSL certificates.
• Removing `balance_in_cents_invoiced` and `balance_in_cents_uninvoiced` from `Recurly_Account`. They were never added to the API.
• Added `tax_code` to `Recurly_Plan`, `Recurly_Addon` and `Recurly_Adjustment`
• Added invoice previews: `Recurly_Invoice::previewPendingCharges($accountCode)`
• Added `terms_and_conditions` and `customer_notes` to `Recurly_Invoice`
• Added `vat_location_valid` field to `Recurly_Account`
• Added `updateNotes()` and `vat_reverse_charge` to `Recurly_Subscription`.
• Added `vat_reverse_charge_notes` to `Recurly_Invoice`.
• Added `invoice_number_prefix` and `invoiceNumberWithPrefix()` to `Recurly_Invoice`. This is to be used with the Country Invoice Sequencing feature.

What is new in version 2.4.2:

• Force cURL to validate SSL certificates.
• Removing `balance_in_cents_invoiced` and `balance_in_cents_uninvoiced` from `Recurly_Account`. They were never added to the API.
• Added `tax_code` to `Recurly_Plan`, `Recurly_Addon` and `Recurly_Adjustment`
• Added invoice previews: `Recurly_Invoice::previewPendingCharges($accountCode)`
• Added `terms_and_conditions` and `customer_notes` to `Recurly_Invoice`
• Added `vat_location_valid` field to `Recurly_Account`
• Added `updateNotes()` and `vat_reverse_charge` to `Recurly_Subscription`.
• Added `vat_reverse_charge_notes` to `Recurly_Invoice`.
• Added `invoice_number_prefix` and `invoiceNumberWithPrefix()` to `Recurly_Invoice`. This is to be used with the Country Invoice Sequencing feature.

What is new in version 2.4.1:

• Force cURL to validate SSL certificates.
• Removing `balance_in_cents_invoiced` and `balance_in_cents_uninvoiced` from `Recurly_Account`. They were never added to the API.
• Added `tax_code` to `Recurly_Plan`, `Recurly_Addon` and `Recurly_Adjustment`
• Added invoice previews: `Recurly_Invoice::previewPendingCharges($accountCode)`
• Added `terms_and_conditions` and `customer_notes` to `Recurly_Invoice`
• Added `vat_location_valid` field to `Recurly_Account`
• Added `updateNotes()` and `vat_reverse_charge` to `Recurly_Subscription`.
• Added `vat_reverse_charge_notes` to `Recurly_Invoice`.
• Added `invoice_number_prefix` and `invoiceNumberWithPrefix()` to `Recurly_Invoice`. This is to be used with the Country Invoice Sequencing feature.

What is new in version 2.3.0:

• Added tax details to adjustments: `$adjustment->tax_details`
• Added subscription previews: `$subscription->preview()`

What is new in version 2.2.4:

• Fixed error when trying to redeem expired or maxed out coupons.
• Improved documentation of `Recurly_PushNotification`.
• Updated XML in test fixtures.
• Better tests for `Recurly_Adjustment`.

What is new in version 2.2.3:

• Use PHPUnit for testing
• Remove old `taxable` parameter from `Recurly_Adjustment`
• Send `null` attributes because `Recurly_PlanTest` needs `total_billing_cycles` to be set to `null` for unlimited renewals.

What is new in version 2.2.2:

• Fixed errors thrown due to empty XML strings.

What is new in version 2.2.1:

• Fixed invalid XML errors when saving subscriptions with add-ons.

What is new in version 2.2.0:

• Added support for client subdomains, the default of 'api' should be fine for most users.

What is new in version 2.1.4:

• Fixed fatal error in Recurly_Invoice::getInvoicePdf().
• Fixed fatal error in Recurly_Account::close().
• Added `reopen()` and `reopenAccount` to `Recurly_Account`.

What is new in version 2.1.3:

• Added `Recurly_AccountList::getClosed()`
• Added `update()` and `accounting_code` to `Recurly_Addon` and `Recurly_Transaction`
• Improved test coverage
• Lists now implement Countable and IteratorAggregate
• Fixed fatal errors in delete methods
• Fixed problems marking invoices successful/failed

What is new in version 2.1.2:

• Support marking invoices as successful/failed
• Added subscriptions postpone functionality
• Support for subscriptions 'first_renewal_date' attribute.
• Fixed problem where require parameters are sometimes not sent in requests (such as account_code).
• Fixed un-pageable array results (no href is present), such as invoice/transactions.
• Fixed transaction refunding, which was sending to a deprecated route.

Requirements:

• Recurly API key
• PHP 5.3 or higher
• PHP's libcurl enabled
• OpenSSL support