chargebee/chargebee-php

---

New Attributes:

• feature_type has been added in SubscriptionEntitlement.
• business_entity_id has been made optional in Quote.
• business_entity_id has been made optional in CreditNote.

New Input parameters:

• invoice_usages has been added in Subscription#UpdateForItemsRequest.
• invoice_usages has been added in Estimate#UpdateSubscriptionForItemsRequest.

---

New Resource:

• Metadata has been added.

New Attributes:

• variant_group has been added in PriceVariant resource.
• effective_from & schedule_status have been added in EntitlementOverride resource.
• effective_from & schedule_status have been added in SubscriptionEntitlement resource.
• status_transition_reason has been added in Ramp subresource.
• billing_period & billing_period_unit have been added in SubscriptionItem subresource.

New Input parameters:

• variant_group has been added to PriceVariant#CreateRequest, PriceVariant#UpdateRequest.
• include_scheduled_overrides has been added to SubscriptionEntitlement#SubscriptionEntitlementsForSubscriptionRequest.
• entitlement_overrides[effective_from] has been added to SubscriptionEntitlement#SubscriptionEntitlementsForSubscriptionRequest.
• entitlement_overrides[effective_from] has been added to EntitlementOverride#AddEntitlementOverrideForSubscriptionRequest.
• include_scheduled_overrides has been added to EntitlementOverride#ListEntitlementOverrideForSubscriptionRequest.
• updated_at has been added to Usage#ListRequest.

New Enum values:

• SUBSCRIPTION_ITEMS_RENEWED has been added in EventType enum.
• SUBSCRIPTION_RAMP_DRAFTED has been added in EventType enum.
• SUBSCRIPTION_RAMP_UPDATED has been added in EventType enum.

---

New resources:

• Currency has been added.
• PricingPageSession Transfer has been added.

New Enum

• cancel_option Enum has been added.

New Enum values:

• ONLINE_BANKING_POLAND has been added in PaymentMethod enum.
• ONLINE_BANKING_POLAND has been added in PaymentMethodType enum.
• ONLINE_BANKING_POLAND has been added in Type enum.
• DRAFT has been added in Ramp enum.

New Input parameters:

• cancel_option has been added to Estimate#CancelSubscriptionRequest, Estimate#CancelSubscriptionForItemsRequest.
• cancel_option has been added to Subscription#CancelForItemsRequest, Subscription#CancelRequest.
• statement_descriptor[descriptor] has been added to Purchase#ChargeRequest.

New Attributes:

• tax_origin has been added to Invoice.
• tax_origin has been added to CreditNote.

---

Reverted

• PSR-18 compatible http client (decouple from Guzzle)
• introduce HttpClientFactory in Environment class (also covers GH-19, GH-43 use cases)
• make request logic unit-testable by using custom HttpClientFactory (GH-50)
• cover Request class with unit tests

---

---

Removed resources:

• Session has been removed.

---

New resources:

• PriceVariant has been added.
• Ramp has been added.
• InstallmentDetail has been added.
• Session has been added.
• Ramp has been added.

New Enum values:

• INVOICE_INSTALLMENTS_CREATED has been added in EventType enum.
• INVOICE_INSTALLMENT_UPDATED has been added in EventType enum.
• INSTALLMENT_CONFIG_CREATED has been added in EventType enum.
• INSTALLMENT_CONFIG_DELETED has been added in EventType enum.
• RAMP_CREATED has been added in EventType enum.
• RAMP_DELETED has been added in EventType enum.
• RAMP_APPLIED has been added in EventType enum.

New Attributes:

• tax_providers_fields has been added to Addon resource.
• tax_providers_fields has been added to Customer resource.
• tax_providers_fields has been added to ItemPrice resource.
• tax_providers_fields has been added to Plan resource.
• resource_version has been added to Installment resource.
• resource_version has been added to InstallmentConfig resource.
• KlarnaPayNow has been added to PaymentSource resource.
• business_entity_id has been added to UnbilledCharge resource.

New Endpoints:

• Exports#PriceVariantsRequest has been added to Exports resource.

New Input parameters:

• changes_scheduled_at, change_option has been added to Estimate#UpdateSubscriptionRequest.
• changes_scheduled_at, change_option has been added to Estimate#UpdateSubscriptionForItemsRequest.
• contract_term[contract_start] has been added to Estimate#CreateSubItemEstimateRequest.
• contract_term[contract_start] has been added to Estimate#CreateSubItemForCustomerEstimateRequest.
• contract_term[contract_start] has been added to Subscription#CreateWithItemsRequest.
• contract_term[contract_start] has been added to Subscription#UpdateForItemsRequest.
• price_variant_id has been added to ItemPrice#CreateRequest.
• price_variant_id has been added to ItemPrice#UpdateRequest.
• price_variant_id has been added to ItemPrice#ListRequest.

Removed attributes:

• additional_info has been removed from Invoice#StatmentDescriptor resource.

Removed Input parameters:

• additional_info has been removed from Subscription#CreateRequest.
• additional_info has been removed from Subscription#CreateForCustomerRequest.
• additional_info has been removed from Subscription#CreateWithItemsRequest.
• additional_info has been removed from Subscription#UpdateRequest.
• additional_info has been removed from Subscription#UpdateForItemsRequest.
• additional_info has been removed from Subscription#ReactivateRequest.

---

New Input parameters:

• to_customer_id has been added to subscription#MoveRequest.
• copy_payment_source has been added to subscription#MoveRequest.

New endpoints:

• Subscription#MoveRequest has been added to the Subscription resource.

---

New resources:

• Attribute has been added.
• ImpactedItemPrice has been added.
• InstallmentConfig has been added.
• Installment has been added.

Removed attributes:

• product_id has been removed from ItemPrice resource.

New Enum values:

• klarna_pay_now has been added to TypeEnum in Customer resource.
• klarna_pay_now has been added to PaymentMethodEnum.
• klarna_pay_now has been added to PaymentMethodTypeEnum enum.
• klarna_pay_now has been added to TypeEnum.
• price_variant has been added to EntityTypeEnum.
• price_variant_created has been added in EventType enum.
• price_variant_updated has been added in EventType enum.
• price_variant_deleted has been added in EventType enum.

Removed Enum values:

• product and variant have been removed from EntityTypeEnum.

New Input parameters:

• config_id has been added to Invoice#InstallmentsRequest.
• amount has been added to Invoice#InstallmentsRequest.
• payment_source_id has been added to Purchase#CreateRequest.
• installment_info[config_id] has been added to Purchase#CreateRequest.
• installment_info[amount] has been added to Purchase#CreateRequest.
• subscription_info[contract_term_billing_cycle_on_renewal] has been added to Purchase#CreateRequest.
• contract_terms[index] has been added to Purchase#CreateRequest.
• contract_terms[action_at_term_end] has been added to Purchase#CreateRequest.
• contract_terms[cancellation_cutoff_period] has been added to Purchase#CreateRequest.
• subscription_info[contract_term_billing_cycle_on_renewal] has been added to Purchase#EstimateRequest.
• contract_terms[index] has been added to Purchase#EstimateRequest.
• contract_terms[action_at_term_end] has been added to Purchase#EstimateRequest.
• contract_terms[cancellation_cutoff_period] has been added to Purchase#EstimateRequest.

Deprecated input parameters:

• product_created, product_updated, product_deleted, variant_created, variant_updated, variant_deleted has been deprecated in EventTypeEnum.

---

• NonSubscription has been added.

---

New attributes:

• usage_percentage has been added to QuoteLineGroup resource.
• usage_percentage has been added to Quote resource.
• usage_percentage has been added to CreditNoteEstimate resource.
• usage_percentage has been added to CreditNote resource.
• usage_percentage has been added to InvoiceEstimate resource.
• usage_percentage has been added to Invoice resource.
• error_detail of type GatewayErrorDetail has been added to PaymentIntent#PaymentAttempt subResource.
• origin_user has been added to Event resource.
• proration_type has been added to QuotedSubscription#SubscriptionItem and Subscription#SubscriptionItem subResources
• network_error_message, recommendation_message, processor_error_code, processor_error_message has been added to Transaction#GatewayErrorDetail subResource.

New Enum values:

• TAX_NOT_CONFIGURED_EXTERNAL_PROVIDER has been added to TaxExemptReasonEnum.

New Input parameters:

• billing_address has been added to Estimate#CreateSubItemForCustomerEstimateRequest.
• transactions[amount] has been added to Invoice#ApplyPaymentsRequest.

---

• Fixed Custom field case conversion issue

---

New resources:

• Entitlements has been added.

New attributes:

• date_to, date_from, prorated_taxable_amount has been added to quote_line_group.
• date_to, date_from, prorated_taxable_amount has been added to quote.
• date_to, date_from, prorated_taxable_amount has been added to credit_note_estimate.
• date_to, date_from, prorated_taxable_amount has been added to credit_note.
• date_to, date_from, prorated_taxable_amount has been added to invoice_estimate.
• date_to, date_from, prorated_taxable_amount has been added to order.
• date_to, date_from, prorated_taxable_amount has been added to invoice.
• active_id has been added to customers.
• active_id has been added to subscriptions.
• reference_id has been made optional for payment_sources/create_using_permanent_token
• custom_payment_method_id has been added to transactions.
• custom_payment_method_name has been added to transactions.
• error_detail has been added to transactions.

New Enum values:

• CMR_FALABELLA, TARJETA_NARANJA, NATIVA, CENCOSUD, CABAL, ARGENCARD, ELO, HIPERCARD, CARNET, RUPAY, MAESTRO has been added to Card#CardTypeEnum
• Transferred has been added to Subscription#StatusEnum.
• Transferred has been added to SubscriptionEstimate#StatusEnum.
• AutomatedBankTransfer has been added to PaymentMethodEnum.
• UsAutomatedBankTransfer, GbAutomatedBankTransfer, EuAutomatedBankTransfer, JpAutomatedBankTransfer, MxAutomatedBankTransfer has been added to VirtualBankAccount#SchemeEnum.
• CustomerBusinessEntityChanged, SubscriptionBusinessEntityChanged has been added to EventTypeEnum.
• Dlocal has been added to GatewayEnum.
• UsAutomatedBankTransfer, UkAutomatedBankTransfer, EuAutomatedBankTransfer, JpAutomatedBankTransfer, MxAutomatedBankTransfer, Custom has been added to OfflinePaymentMethodEnum.
• AutomatedBankTransfer has been added to PaymentMethodEnum.
• AutomatedBankTransfer has been added to PaymentMethodTypeEnum.

New Input parameters:

• custom_payment_method_name has been added to Transactions#RecordRefundRequest.
• proration_type has been added to Subscription#UpdateForItemsRequest.
• proration_type has been added to ItemPrice.
• payment_initiator has been added to Invoice.
• payment_method_token, customer_profile_token, network_transaction_id, mandate_id, skip_retrieval, card, billing_address has been added to PaymentSource#CreateUsingPermanentTokenRequest.
• subscription_items[proration_type] has been added to Estimate#UpdateSubscriptionForItemsRequest.
• transaction[custom_payment_method_id] has been added to Customer#RecordExcessPaymentRequest.
• transaction[custom_payment_method_id] has been added to CreditNote#RecordRefundRequest.

---

New attributes:

• statement_descriptor has been added to invoice resource.
• source has been added to the Hosted_Pages resource.

New Enum values:

• pay_com has been added to Gateway.
• pay_to, faster_payments, sepa_instant_transfer has been added to Customer#TypeEnum.
• pay_to, faster_payments, sepa_instant_transfer has been added to PaymentMethodEnum.
• pay_to, faster_payments, sepa_instant_transfer has been added to PaymentMethodTypeEnum.
• pay_to, faster_payments, sepa_instant_transfer has been added to TypeEnum.
• pay_to, faster_payments, sepa_instant_transfer, amazon_payments has been added to PaymentIntent#PaymentMethodTypeEnum.

New Input parameters:

• source has been added to HostedPage#CheckoutOneTimeForItemsRequest.
• source has been added to HostedPage#CheckoutNewForItemsRequest.
• source has been added to HostedPage#CheckoutExistingForItemsRequest.
• statement_descriptor_descriptor has been added to Invoice#CreateRequest.
• statement_descriptor_descriptor has been added to Invoice#CreateForChargeItemsAndChargesRequest.
• statement_descriptor_descriptor has been added to Invoice#UpdateDetailsRequest.
• statement_descriptor_additional_info has been added to Invoice#CreateRequest.
• statement_descriptor_additional_info has been added to Invoice#CreateForChargeItemsAndChargesRequest.
• statement_descriptor_additional_info has been added to Invoice#UpdateDetailsRequest.
• statement_descriptor_descriptor has been added to Subscription#CreateRequest.
• statement_descriptor_descriptor has been added to Subscription#CreateForCustomerRequest.
• statement_descriptor_descriptor has been added to Subscription#CreateWithItemsRequest.
• statement_descriptor_descriptor has been added to Subscription#UpdateRequest.
• statement_descriptor_descriptor has been added to Subscription#UpdateForItemsRequest.
• statement_descriptor_descriptor has been added to Subscription#ReactivateRequest.
• statement_descriptor_additional_info has been added to Subscription#CreateRequest.
• statement_descriptor_additional_info has been added to Subscription#CreateForCustomerRequest.
• statement_descriptor_additional_info has been added to Subscription#CreateWithItemsRequest.
• statement_descriptor_additional_info has been added to Subscription#UpdateRequest.
• statement_descriptor_additional_info has been added to Subscription#UpdateForItemsRequest.
• statement_descriptor_additional_info has been added to Subscription#ReactivateRequest.

Updates to old parameters:

• duration_type, discount_type in coupons has been made optional.
• proration_type in addons is now supported.
• csv_tax_rule has been removed.
• Tax1JurisTypeEnum has been removed.
• Tax2JurisTypeEnum has been removed.
• Tax3JurisTypeEnum has been removed.
• Tax4JurisTypeEnum has been removed.

---

New attributes:

• venmo has been added to the PaymentSource resource.
• proration_type has been added to the QuotedCharge, QuotedSubscription and Subscription resource.

New Enum values:

• ebanx has been added to Gateway.
• venmo has been added to Customer#TypeEnum.
• venmo has been added to PaymentMethodEnum.
• venmo has been added to PaymentMethodTypeEnum.
• venmo has been added to TypeEnum.
• venmo has been added to PaymentIntent#PaymentMethodTypeEnum.

New Input parameters:

• einvoicing_method has been added to HostedPage#CheckoutOneTimeForItemsRequest.
• einvoicing_method has been added to HostedPage#CheckoutNewForItemsRequest.
• additional_information has been added to PaymentSource#CardAdditionalInformation.

---

New Resource:

• CsvTaxRule has been added.

New attributes:

• direct_debit_scheme has been added to the PaymentSource#PaymentSourceBankAccount resource.

New Enum :

• DirectDebitSchemeEnum has been added.
• Tax1JurisTypeEnum has been added.
• Tax2JurisTypeEnum has been added.
• Tax3JurisTypeEnum has been added.
• Tax4JurisTypeEnum has been added.

New Input parameters:

• avalara_tax_code, hsn_code, taxjar_product_code has been added to Invoice#AddChargeRequest.

---

New Attributes:

• tax_category has been added to the CreditNote, Quote and Invoice resource.
• proration_type has been added in Addon resource.

New Enum values:

• tax has been added to EntityType enum in Invoice resource.
• payment_source_locally_deleted has been added to EventType.

New Input parameters:

• CouponId and CouponApplyTill has been added to Subscritpion#CreateRequest in Subscritpion resource.
• CouponId and CouponApplyTill has been added to Subscritpion#CreateForCustomerRequest in Subscritpion resource.
• CouponId and CouponApplyTill has been added to Subscritpion#CreateWithItemsRequest in Subscritpion resource.
• CouponId and CouponApplyTill has been added to Subscritpion#UpdateRequest in Subscritpion resource.
• CouponId and CouponApplyTill has been added to Subscritpion#UpdateForItemsRequest in Subscritpion resource.
• CouponId and CouponApplyTill has been added to Subscritpion#ImportSubscriptionRequest in Subscritpion resource.
• CouponId and CouponApplyTill has been added to Subscritpion#ImportForCustomerRequest in Subscritpion resource.
• CouponId and CouponApplyTill has been added to Subscritpion#ImportForItemsRequest in Subscritpion resource.
• cancel_reason_code has been added to Subscritpion#ImportForItemsRequest in Subscritpion resource.
• proration_type has been added in addon#createRequest and addon#UpdateRequest in Addon resource.
• addons[proration_type] has been added in Estimate#UpdateSubscriptionRequest in Estimate resource.
• addons[proration_type] has been added in Subscription#UpdateRequest in Subscritpion resource.

New Enum Class:

• ProrationType enum has been added to addon resource.
• ProrationType enum has been added.

---

New endpoints:

• ViewVoucher#ViewVoucherRequest has been added to the HostedPage resource.
• InvoiceListPaymentReferenceNumbers#InvoiceListPaymentReferenceNumbersRequest has been added to the Invoice resource.

New Resource:

• PaymentReferenceNumber has been added.

New attributes:

• local_currency_exchange_rate has been added to the CreditNote and Invoice resource.

New Enum values:

• view_voucher has been added to Type enum in HostedPage resource.
• paused has been added in StoreStatus enum in InAppSubscription resource.
• metrics_global and windcave has been added in Gateway enum.

New Input parameters:

• payment_initiator has been added to Customers#CollectPaymentRequest.
• payment_initiator has been added to Invoice#CreateRequest.
• payment_initiator has been added to Invoice#ChargeRequest.
• payment_initiator has been added to Invoice#ChargeAddonRequest.
• payment_initiator has been added to Invoice#CollectPaymentRequest.
• payment_initiator has been added to Subscription#CreateRequest.
• payment_initiator has been added to Invoice#CreateForChargeItemRequest.
• payment_initiator has been added to Subscription#CreateForCustomerRequest.
• payment_initiator has been added to Subscription#CreateWithItemsRequest.
• payment_initiator has been added to Subscription#UpdateForItemsRequest.
• payment_initiator has been added to Subscription#ReactivateRequest.
• payment_initiator has been added to Subscription#ResumeRequest.
• payment_reference_numbers[id] has been added to Invoice#ImportInvoiceRequest.
• payment_reference_numbers[type] has been added to Invoice#ImportInvoiceRequest.
• payment_reference_numbers[number] has been added to Invoice#ImportInvoiceRequest.

---

New endpoints:

• PaymentSource#CreateVoucherPaymentSource has been added to the PaymentSource resource.
• EventsRequest#HostedPage has been added to the PaymentSource resource.

New Resource:

• PaymentVoucher has been added.

New attributes:

• boleto and billing_address has been added to the PaymentSource resource.
• product_id has been added to the ItemPrice resource.

New Enum Class:

• EventNameEnum has been added.
• PaymentVoucherTypeEnum has been added.
• VoucherTypeEnum has been added.

New Enum values:

• product and variant has been added to EntityType enum.
• product_created, product_updated, product_deleted, variant_created, variant_updated and variant_deleted enums have been added in EventType enum.
• voucher_created, voucher_expired and voucher_create_failed have been added in EventType enum.
• boleto has been added in PaymentMethod and OfflinePaymentMethod and PaymentMethodTypeEnum#PaymentIntent.

---

New Feature:

• Added utility to pass Idempotency key along with request headers to allow a safe retry of POST requests.
• Added isIdempotencyReplayed() utility to differentiate between original and replayed requests.
• Added getResponseHeaders() utility to fetch the response headers.

---

Fixes:

• SubscriptionId attribute has been maid as required in InAppSubscription resource.

New Attributes:

• TotalContractValueBeforeTax has been added to the ContractTerm resource.
• TotalContractValueBeforeTax#SubscriptionContractTerm has been added to the Subscription resource.
• TotalContractValueBeforeTax#SubscriptionEstimateContractTerm has been addded to the SubscriptionEstimate resource.
• CouponConstraints has been added to the Coupon resource.

New Resource:

• NonSubscription have been added.

Added Input Parameters:

• contract_term[total_amount_raised_before_tax]#ImportSubscriptionRequest, contract_term[total_amount_raised_before_tax]#ImportForItemsRequest, contract_term[total_amount_raised_before_tax]#ImportContractTermRequest and contract_term[total_amount_raised_before_tax]#ImportForCustomerRequest parameter has been added to Subscription resource.
• contract_term[total_contract_value_before_tax]#ImportContractTermRequest parameter has been added to Subscription resource.
• coupon_constraints[entity_type]#CreateForItemsRequestParams, coupon_constraints[type]#CreateForItemsRequestParams and coupon_constraints[value]#CreateForItemsRequestParams parameter has been added to the Coupon resource.
• coupon_constraints[entity_type]#UpdateForItemsRequestParams, coupon_constraints[type]#UpdateForItemsRequestParams and coupon_constraints[value]#UpdateForItemsRequestParams parameter has been added to the Coupon resource.
• export_type#CustomersRequest and export_type#SubscriptionsRequest parameter has been added to the Export resource.

New Enum Class:

• ExportType has been added.

New Enum values:

• pending_authorization has been added to StatusEnum#PaymentIntentPaymentAttempt to the PaymentIntent resource.

---

Fixes:

• Fixed list_discounts subscriptions API error.
• Fixed utf8_encode deprecation warnings.

New Attributes:

• referenceNumber has been added to the CreditNoteEinvoice resource.
• referenceNumber has been added to the InvoiceEinvoice resource.
• einvoicingMethod has been added to the Customer resource.
• storeStatus and invoiceId have been addded to the InAppSubscription resource.

Added Input Parameters:

• UpdateForItemsRequestParams#discount_quantity and UpdateRequestParams#discount_quantity parameter has been added to the coupon resource.
• UpdateBillingInfoRequestParams#einvoicing_method and CreateRequestParams#einvoicing_method parameter has been added to the customer resource.
• CreateCustomerParams#einvoicing_method , UpdateCustomerParams#einvoicing_metho and UpdateForItemsCustomerParams#einvoicing_method parameter has been added to the Subscription resource.
• CreateSubscriptionInfoParams#meta_data parameter has been added to the purchase resource.

New Endpoints:

• CreditNote#SendEinvoice has been added to the CreditNote resource.
• Invoice#SendEinvoice has been added to the Invoice resource.
• InAppSubscription#ImportSubscription and InAppSubscription#RetrieveStoreSubs requests have been added to the InAppSubscription resource.

New Enum Class:

• EinvoicingMethod has been added.
• StoreStatus has been added in InAppSubscription resource.

---

New Attributes:

• resource_version and updated_at parameter has been added to the tax_withheld resource.

Added input parameters:

• ListRequestParams#updated_at parameter has been added to attached_item resource.
• AttachedItemsAttachedItemParams#updated_at parameter has been added to export resource.
• CheckoutGiftRequestParams#coupon_ids parameter has been added to hosted_page resource.
• ProcessReceiptCustomerParams#email, ProcessReceiptCustomerParams#first_name and ProcessReceiptCustomerParams#last_name parameters has been added to in_app_subscription resource.

New endpoints:

• invoice#RecordTaxWithheld and invoice#RemoveTaxWithheld has been added to the invoice resource.
• credit_note#RemoveTaxWithheldRefund has been added to the credit_note resource.

New Enum values:

• custom has been added to payment_method Enum.
• ecentric has been added to gateway Enum.

Removed input parameters:

• EstimateRequestParams#EstimateInvoiceInfoParams parameter has been removed from purchase resource.

Deprecated input parameters:

• CheckoutGiftRequest#coupon parameter have been deprecated in hosted_page resource.

---

New Attributes:

• shipping_address and billing_address parameter has been added to the CreditNote.
• is_advance_charge has been added to the UnbilledCharge.

Added input parameters:

• CreateSubForCustomerQuoteRequest#subscription[po_number] and CreateSubItemsForCustomerQuoteRequest#subscription[po_number] parameter has been added to Quote resource.
• ImportUnbilledChargesRequest#unbilled_charges[is_advance_charge] parameter has been added to Subscription resource.
• ImportInvoiceRequest#has_advance_charges parameter has been added to Invoice resource.

New endpoints:

• Invoice#DeleteLineItemsRequest has been added to the Invoice resource.

New Enum values:

• SUBSCRIPTION_TRIAL_EXTENDED has been added to EventTypeEnum.
• ZERO_VALUE_ITEM has been added to TaxExemptReasonEnum.
• BANK_OF_AMERICA has been added to GatewayEnum.

---

New Resource:

• discount has been added.

New Enum values:

• apply_on, duration_type and operation_type enums have been added.

---

New endpoints:

• subscriptions#list_discounts has been added to the subscriptions resource.

New attributes:

• billing_month has been added to the customer resource.

Added input parameters:

• billing_month has been added to the customers#change_billing_date API.
• line_items[subscription_id] has been added to the invoices#import_invoice API.
• layout has been added to hosted_pages#checkout_onetime_for_items, hosted_pages#checkout_new_for_items and hosted_pages#checkout_existing_for_items APIs.
• discounts[apply_on], discounts[percentage], discounts[amount] and discounts[item_price_id] have been added to estimates#create_subscription_for_items, estimates#create_subscription_for_items_estimate, estimates#update_subscription_for_items, hosted_pages#checkout_onetime_for_items, hosted_pages#checkout_new_for_items, hosted_pages#checkout_existing_for_items, invoices#create_for_charge_items_and_charges, quotes#create_subscription_for_items, quotes#edit_create_subscription_quote_for_items, quotes#update_subscription_quote_for_items, quotes#edit_update_subscription_quote_for_items, quotes#create_for_charge_items_and_charges, quotes#edit_for_charge_items_and_charges, subscriptions#create_subscription_for_items, subscriptions#update_subscription_for_items and subscriptions#import_subscription_for_items APIs.
• discounts[duration_type], discounts[period], discounts[period_unit] and discounts[included_in_mrr] have been added to estimates#create_subscription_for_items, estimates#create_subscription_for_items_estimate, estimates#update_subscription_for_items, hosted_pages#checkout_new_for_items, hosted_pages#checkout_existing_for_items, quotes#create_subscription_for_items, quotes#edit_create_subscription_quote_for_items, quotes#update_subscription_quote_for_items, quotes#edit_update_subscription_quote_for_items, subscriptions#create_subscription_for_items, subscriptions#update_subscription_for_items and subscriptions#import_subscription_for_items APIs.
• discounts[operation_type] and discounts[id] have been added to estimates#update_subscription_for_items, quotes#update_subscription_quote_for_items, hosted_pages#checkout_existing_for_items, quotes#edit_update_subscription_quote_for_items, subscriptions#update_subscription_for_items and subscriptions#import_subscription_for_items APIs.

New Enum values:

• global_payments has been added to gateway enum.
• layout enum has been added.

---

Fixes:

• fixed incorrect reference of OperationFailedException class in TimeMachine model.

New endpoints:

• Purchase#Retrieve has been added to the Purchase resource.

New attributes:

• ResourceVersion has been added to the Token resource.
• UpdatedAt has been added to the Token and UnbilledCharge resources.
• ReferenceLineItemId has been added to the CreditNote#LineItem, CreditNoteEstimate#LineItem, Quote#LineItem, QuoteLineGroup#LineItem, InvoiceEstimate#LineItem and Invoice#LineItem subResources.
• Index has been added to the Order#ShippingAddress, Invoice#ShippingAddress, Quote#ShippingAddress, QuotedCharge#ItemTier, QuotedSubscription#ItemTier, Subscription#ItemTier, Subscription#ShippingAddress and SubscriptionEstimate#ShippingAddress subResources.
• VoidWithCreditNote has been added to the Invoice#VoidInvoiceRequest subresources.
• PaymentMethodDetails has been added to the Transaction resource.

New Resource:

• InAppSubscription have been added.

Removed input parameters:

• BusinessEntityId has been removed from Purchase#CreateRequest and Purchase#EstimateRequest.

---

---

New endpoints:

• invoice#sync_usages and invoice#resend_einvoice have been added to the invoice resource.
• credit_notes#resend_einvoice has been added to the credit_notes resource.
• features#list_features, features#create_a_feature, features#update_a_feature, features#retrieve_a_feature, features#delete_a_feature, features#activate_a_feature, features#archive_a_feature and features#reactivate_a_feature have been added to the features resource.
• subscription_entitlements#subscription_entitlements_for_subscription and subscription_entitlements#set_subscription_entitlement_availability have been added to the subscription_entitlements resource.
• item_entitlements#item_entitlements_for_an_item, item_entitlements#item_entitlements_for_a_feature, item_entitlements#add_an_item_entitlements and item_entitlements#upsert_or_remove_an_item_entitlements_for_item have been added to the item_entitlements resource.
• entitlement_overrides#add_entitlement_override_for_a_subscription and entitlement_overrides#list_entitlement_override_for_a_subscription have been added to the entitlement_overrides resource.

New Resource:

• features, subscription_entitlements, item_entitlements and entitlement_overrides have been added.

New filter parameters:

• einvoice[status] filter parameter has been added in credit_notes#list_credit_notes api.

New Enum values:

• paypal_express_checkout has been added to payment_method_type enum.
• feature_created, feature_updated, feature_deleted, feature_activated, feature_reactivated, feature_archived, item_entitlements_updated, entitlement_overrides_updated, entitlement_overrides_removed, item_entitlements_removed and entitlement_overrides_auto_removed have been added to the event_type enum.
• action enum has been added.

---

New endpoints:

• UnbilledCharge#CreateUnbilledCharge has been added to UnbilledCharge resource. Applicable only for PC1.0.

New attributes:

• channel have been added to the Addon, AttachedItem, CreditNote, Customer, Invoice, ItemFamily, ItemPrice, Plan and Subscription resources.
• external_name and channel have been added to the Item resource.

New input parameters:

• external_name have been added to Item#CreateRequest and Item#UpdateRequest.
• channel have been added to Addon#AddonListRequest.
• channel have been added to CreditNote#CreditNoteListRequest.
• channel have been added to Customer#CustomerListRequest.
• invoice[channel], subscription[channel] and customer[channel] have been added to Export#RevenueRecognitionRequest and Export#DeferredRevenueRequest.
• plan[channel] have been added to Export#PlansRequest.
• addon[channel] have been added to Export#AddonsRequest.
• customer[channel] have been added to Export#CustomersRequest.
• subscription[channel] have been added to Export#SubscriptionsRequest.
• invoice[channel] have been added to Export#InvoicesRequest.
• credit_note[channel] have been added to Export#CreditNotesRequest.
• item[channel] have been added to Export#ItemsRequest.
• item_price[channel] have been added to Export#ItemPricesRequest.
• channel have been added to Invoice#InvoiceListRequest.
• channel have been added to Item#ItemListRequest.
• channel have been added to ItemPrice#ItemPriceListRequest.
• channel have been added to Plan#PlanListRequest.
• channel have been added to Subscription#SubscriptionListRequest.

---

---

---

New Input parameters:

• net_term_days has been added to subscriptions#create_subscription_for_items, subscriptions#update_subscription_for_items, subscriptions#import_subscription_for_items endpoints.

---

---

New endpoints:

• credit_notes#download_einvoice has been added to the credit_notes resource.
• invoice#download_einvoice has been added to the invoice resource.

New attributes:

• is_einvoice_enabled, entity_identifier_scheme, entity_identifier_standard and entity_identifiers[] have been added to the customer resource.
• einvoice has been added to the invoice resource.
• einvoice has been added to the credit_notes resource.
• mime_type has been added to the download resource.

New Input parameters:

• entity_identifier_scheme, entity_identifier_standard, is_einvoice_enabled, entity_identifiers[id][0..N], entity_identifiers[scheme][0..N], entity_identifiers[value][0..N], entity_identifiers[standard][0..N] have been added to customers#create_a_customer, customers#update_billing_info_for_a_customer apis.
• customer[entity_identifier_scheme], customer[entity_identifier_standard], customer[is_einvoice_enabled], entity_identifiers[id][0..N], entity_identifiers[scheme][0..N], entity_identifiers[value][0..N], entity_identifiers[standard][0..N] have been added to the subscriptions#create_a_subscription api.
• customer[entity_identifier_scheme], customer[entity_identifier_standard], customer[is_einvoice_enabled] have been added to subscriptions#update_a_subscription and subscriptions#update_subscription_for_items apis.

New Enum values:

• operation enum has been added.
• status enum has been added in credit_notes_einvoice subresource of credit_notes resource.

Deprecated attributes:

• user, type, payment_method and exchange_rate have been deprecated from TaxWithHeld resource.

Deprecated enums:

• type and payment_method have been deprecated in TaxWithHeld resource.

Updated parameters:

• hierarchy_operation_type has been made mandatory in customers#get_hierarchy api.

Removed Filter parameters:

• create_pending_invoices has been removed from subscriptions#list_subscriptions api.

---

---

---

New Attributes:

• entity_id has been added in order_line_item_discounts resource.

New Input parameters:

• line_items[tax5_name], line_items[tax5_amount], line_items[tax6_name], line_items[tax6_amount], line_items[tax7_name], line_items[tax7_amount], line_items[tax8_name], line_items[tax8_amount], line_items[tax9_name], line_items[tax9_amount], line_items[tax10_name], line_items[tax10_amount] have been added in import_invoice api.
• replace_primary_payment_source has been added in create_subscription_for_customer and create_subscription_for_items apis.

New Enum values:

• coupon_expired has been added to event_type enum.
• mollie has been added to gateway enum.
• item_level_discount and document_level_discount has been added to discount_type.

---

• Bumped minimum php version to 5.6.0.
• Implemented namespaces.
• Switched to Guzzle PHP Http Client to make HTTP requests.

New Attributes:

• generated_at has been added in credit_note and invoice resources.
• change_option have been added in quoted_subscription resource.
• changes_scheduled_at has been added in subscription and quoted_subscription resources.
• iin and last4 have been added in transaction resource.

New Resource:

• quoted_charge has been added.

New Input parameters:

• invoice_date has been added in estimates##create_subscription_estimate, estimates#estimate_for_creating_a_customer_and_subscription, estimates#estimate_for_creating_a_subscription, estimates#create_subscription_for_a_customer_estimate, estimates#update_subscription_estimate, estimates#estimate_for_updating_a_subscription, estimates#cancel_subscription_estimate, estimates#cancel_subscription_for_items_estimate, estimates#create_invoice_for_items_estimate, estimates#create_invoice_estimate, hosted_pages#checkout_existing_subscription, hosted_pages#create_checkout_to_update_a_subscription, invoices#create_an_invoice, invoices#create_invoice_for_items_and_one-time_charges, subscriptions#create_a_subscription, subscriptions#create_subscription_for_customer, subscriptions#update_a_subscription, subscriptions#create_subscription_for_items, subscriptions#update_subscription_for_items, subscriptions#reactivate_a_subscription, subscriptions#cancel_subscription_for_items and subscriptions#cancel_a_subscription endpoints.
• coupon_ids has been added to invoices#create_invoice_for_a_one-time_charge, invoice#create_invoice_for_a_non-recurring_addon, quotes#create_quote_for_one-time_charges, quotes#edit_quote_for_one-time_charges, quotes#create_a_quote_for_charge_and_charge_items, quotes#edit_quote_for_charge_items_and_charges endpoints.
• change_option and changes_scheduled_at have been added in quotes#create_quote_for_updating_a_subscription, quotes#edit_quote_for_updating_a_subscription, quotes#create_a_quote_for_update_subscription_items, quotes#edit_update_subscription_quote_for_items, subscriptions#update_a_subscription and subscriptions#create_subscription_for_items endpoints.
• invoice_date, create_pending_invoices and first_invoice_pending have been added in quotes#convert_a_quote endpoint.
• subscription[auto_close_invoices] has been added in quotes#convert_a_quote endpoint.

New Enum values:

• subscription_cancel has been added to charge_event enum in quote_line_groups resource.
• subscription_created_with_backdating, subscription_changed_with_backdating, subscription_canceled_with_backdating, subscription_reactivated_with_backdating, invoice_generated_with_backdating and credit_note_created_with_backdating have been added to event_type enum
• change_option enum has been added.

Deprecated parameters:

• coupon has been deprecated in invoices#create_invoice_for_a_one-time_charge and invoices#create_invoice_for_a_non-recurring_addon endpoints.

---

New endpoints:

• hosted_pages#checkout_one_time_for_items and hosted_pages#checkout_gift_for_items have been added in hosted_pages resource.
• orders#resend_an_order has been added in orders resource.
• quotes#edit_create_subscription_quote_for_items, quotes#edit_update_subscription_quote_for_items and quotes#edit_quote_for_charge_items_and_charges have been added in quotes resource. Applicable only for Product Catalog V2.

New attributes:

• accounting_category3 and accounting_category4 have been added to addon, item_price and plan resources.
• quantity_in_decimal has been added to attached_item resource.
• period and period_unit have been added to coupon resource.
• entity_id has been added to line_item_discounts object of credit_note, credit_note_estimate, invoice, invoice_estimate, quote and quote_line_group resources.
• vat_number_prefix has been added to credit_note, customer, invoice and quote resources.
• price_in_decimal has been added to differential_price and item_price resources.
• exchange_rate and new_sales_amount have been added to invoice resource.
• archived_at has been added to item and item_price resources.
• trial_end_action has been added to item_price, plan, subscription and subscription_estimate resources.
• resent_orders, tracking_url, resent_status, is_resent, original_order_id and resend_reasons have been added to order resource.
• line_item_tiers have been added to quote resource.
• plan_quantity_in_decimal and plan_unit_price_in_decimal have been added to quoted_subscription and subscription resources. Applicable only for Product Catalog V1.
• contract_term_billing_cycle_on_renewal and quoted_contract_term have been added to quoted_subscription resource.
• quantity_in_decimal, metered_quantity, last_calculated_at, unit_price_in_decimal, amount_in_decimal and free_quantity_in_decimal have been added to subscription_items object of quoted_subscription and subscription resources.
• starting_unit_in_decimal, ending_unit_in_decimal and price_in_decimal have been added to item_tiers object in quoted_subscription resources.
• cancel_schedule_created_at has been added to subscription resource.
• exchange_rate and merchant_reference_id have been added to transaction resource.

New parameters:

• accounting_category3 and accounting_category4 have been added in addons#create_an_addon, addons#update_an_addon, plans#create_a_plan and plans#update_a_plan endpoints.
• quantity_in_decimal has been added in attached_items#create_an_attached_item, attached_items#update_an_attached_item and gifts#create_a_gift_subscription_for_items endpoints.
• period and period_unit have been added in coupons#create_a_coupon, coupons#update_a_coupon, coupons#create_a_coupon_for_items and coupons#update_a_coupon_for_items endpoints.
• vat_number_prefix has been added in customers#create_a_customer, customers#update_billing_info_for_a_customer, estimates#create_subscription, estimates#create_subscription_estimate, estimates#create_subscription_for_items, estimates#create_subscription_for_items_estimate, estimates#update_subscription_for_items, estimates#update_subscription, hosted_pages#checkout_new_subscription, hosted_pages#checkout_one-time_payments, hosted_pages#create_checkout_for_a_new_subscription hosted_pages#checkout_existing_subscription, hosted_pages#create_checkout_to_update_a_subscription, invoices#import_invoice, invoices#update_invoice_details, subscriptions#create_a_subscription, subscriptions#update_a_subscription, subscriptions#update_subscription_for_items and subscriptions#import_a_subscription endpoints.
• payment_method[additional_information] has been added in customers#create_a_customer, customers#update_payment_method_for_a_customer, customers#collect_payment_for_customer, invoices#create_an_invoice, invoices#create_invoice_for_items_and_one-time_charges, subscriptions#create_a_subscription, subscriptions#update_a_subscription, subscriptions#update_subscription_for_items and subscriptions#import_a_subscription endpoints.
• card[additional_information] has been added in customers#create_a_customer, customers#collect_payment_for_customer, invoices#create_an_invoice, invoices#create_invoice_for_items_and_one-time_charges, payment_sources#create_a_card_payment_source, subscriptions#create_a_subscription, subscriptions#update_a_subscription, subscriptions#update_subscription_for_items and subscriptions#import_a_subscription endpoints.
• bank_account[billing_address] has been added in customers#create_a_customer, invoices#create_an_invoice, invoices#create_invoice_for_items_and_one-time_charges, payment_sources#create_a_bank_account_payment_source and subscriptions#create_a_subscription endpoints.
• price_in_decimal has been added in differential_prices#create_a_differential_price and differential_prices#update_a_differential_price endpoints.
• tiers[starting_unit_in_decimal][0..N], tiers[ending_unit_in_decimal][0..N] and tiers[price_in_decimal][0..N] have been added in differential_prices#create_a_differential_price, differential_prices#update_a_differential_price, item_prices#create_an_item_price and item_prices#update_an_item_price endpoints.
• remove_general_note and notes_to_remove been added in estimates#create_invoice_estimate, estimates#create_invoice_for_items_estimate and invoices#create_invoice_for_items_and_one-time_charges endpoints.
• trial_end_action has been added in estimates#create_subscription, estimates#create_subscription_estimate, estimates#create_subscription_for_items, estimates#create_subscription_for_items_estimate, estimates#update_subscription_for_items, estimates#update_subscription, plans#create_a_plan, plans#update_a_plan, item_prices#create_an_item_price, item_prices#update_an_item_price, subscriptions#create_a_subscription, subscriptions#create_subscription_for_customer, subscriptions#create_subscription_for_items, subscriptions#update_a_subscription and subscriptions#update_subscription_for_items endpoints.
• subscription_items[unit_price_in_decimal][0..N], item_tiers[starting_unit][0..N], item_tiers[ending_unit][0..N] and item_tiers[price_in_decimal][0..N] have been added in estimates#create_subscription_for_items, estimates#create_subscription_for_items_estimate, estimates#update_subscription_for_items, estimates#update_subscription, estimates#cancel_subscription_for_items_estimate, hosted_pages#create_checkout_for_a_new_subscription, hosted_pages#create_checkout_to_update_a_subscription, subscriptions#create_subscription_for_items, subscriptions#update_subscription_for_items and subscriptions#import_subscription_for_items endpoints.
• subscription_items[quantity_in_decimal][0..N] has been added in estimates#create_subscription_for_items, estimates#create_subscription_for_items_estimate, estimates#cancel_subscription_for_items_estimate, estimates#update_subscription_for_items, estimates#update_subscription, estimates#gift_subscription_for_items, estimates#cancel_subscription_for_items_estimate, gifts#create_a_gift_subscription_for_items, hosted_pages#create_checkout_for_a_new_subscription, hosted_pages#create_checkout_to_update_a_subscription, subscriptions#create_subscription_for_items, subscriptions#update_subscription_for_items, subscriptions#import_subscription_for_items and subscriptions#cancel_subscription_for_items endpoints.
• notes_to_remove[entity_type][0..N] and notes_to_remove[entity_id][0..N] have been added in estimates#create_invoice, estimates#create_invoice_for_items and invoices#create_invoice_for_items_and_one-time_charges endpoints.
• item_prices[quantity_in_decimal][0..N] and item_prices[unit_price_in_decimal][0..N] have been added in estimates#create_invoice_for_items, invoices#create_invoice_for_items_and_one-time_charges and unbilled_charges#create_unbilled_charges_for_a_subscription endpoints.
• item_tiers[starting_unit_in_decimal][0..N], item_tiers[ending_unit_in_decimal][0..N] and item_tiers[price_in_decimal][0..N] have been added in estimates#create_invoice_for_items, invoices#create_invoice_for_items_and_one-time_charges and unbilled_charges#create_unbilled_charges_for_a_subscription endpoints.
• payment_intent[additional_information] has been added in customers#create_a_customer, customers#collect_payment_for_customer, gifts#create_a_gift_subscription_for_items, gifts#create_a_gif and payment_sources#create_using_payment_intent endpoints.
• invoice_note has been added in hosted_pages#checkout_one-time_payments endpoint.
• allow_offline_payment_methods has been added in hosted_pages#create_checkout_for_a_new_subscription and hosted_pages#create_checkout_to_update_a_subscription endpoints.
• free_quantity_in_decimal, price_in_decimal and trial_end_action have been added in item_prices#create_an_item_price and item_prices#update_an_item_price endpoints.
• tracking_url has been added in orders#create_an_order, orders#update_an_order and orders#import_an_order endpoints.
• additional_information has been added in payment_sources#create_using_gateway_temporary_token and payment_sources#create_using_permanent_token endpoints.

New enum values:

• bancontact has been added to card_type enum.
• card and latam_local_card have been added to powered_by enum.
• item_level_discount and document_level_discount have been added to entity_type enum of credit_note_discount, credit_note_estimate_discount, invoice_discount, line_item_discount and invoice_estimate_discount resources.
• item_level_discount and document_level_discount have been added to discount_type enum.
• add_usages_reminder and order_resent have been added to event_type enum.
• ingenico_direct and exact have been added to gateway enum.
• max_usage has been added to usage_calculation enum.
• trial_end_action enum has been added.
• order_resent has been added to cancellation_reason enum.
• resent_status enum has been added.
• custom_discount has been added in discount_type enum of order_line_item_discount.

New filter parameters:

• resent_status, is_resent and original_order_id filter parameters have been added in exports#orders and orders#list_orders enpoints.
• updated_at filter parameter has been added in exports#item_families and item_families#list_item_families endpoints.

New sort parameters:

• name, id and updated_at sort parameters are added to items#list_items and item_prices#list_item_prices endpoints.
• created_at and updated_at sort parameters are added to payment_sources#list_payment_sources endpoint.
• usage_date sort parameter has been added to usages#list_usages endpoint.

Deprecated parameters:

• duration_month parameter has been deprecated in coupon resource.

---

• fixed: missing requires for Product Catalog V2 resources.

---

New resources:

• Usages is added. Applicable only for Product Catalog V2

New end points:

• hosted_pages#checkout_one-time_payments has been added in hosted_pages resource

New attributes:

• auto_close_invoices has been added to customers, subscriptions resources
• metered, usage_calculation have been added to items resources
• create_pending_invoices, auto_close_invoices have been added to subscriptions resources

New parameters:

• auto_close_invoices has been added to the endpoint: customers#create_a_customer, customers#list_customers, customers#update_a_customer
• invoice_allocations[invoice_id] has been added to the endpoint: customers#collect_payment_for_customer
• coupon_ids has been added to the endpoint: estimates#create_invoice_for_items_estimate. Applicable only for Product Catalog V2
• subscription[auto_close_invoices] has been added to the endpoint: exports#export_revenue_recognition_reports, exports#export_deferred_revenue_reports, exports#export_subscriptions
• customer[auto_close_invoices] has been added to the endpoint: exports#export_revenue_recognition_reports, exports#export_deferred_revenue_reports, exports#export_customers
• item[metered], item[usage_calculation] have been added to the endpoint: exports#export_items. Applicable only for Product Catalog V2
• subscription_id has been added to the endpoint: invoices#add_one-time_charge_to_a_pending_invoice, invoices#add_non-recurring_addon_to_a_pending_invoice
• subscription_id has been added to the endpoint: invoices#add_a_charge-item_to_a_pending_invoice. Applicable only for Product Catalog V2
• metered, usage_calculation have been added to the endpoint: items#create_an_item, items#list_item. Applicable only for Product Catalog V2
• create_pending_invoices, auto_close_invoices, first_invoice_pending have been added to the endpoint: subscriptions#create_subscription_for_items, subscriptions#update_subscription_for_items,subscriptions#import_subscription_for_items. Applicable only for Product Catalog V2
• create_pending_invoices, auto_close_invoices have been added to the endpoint: subscriptions#list_subscriptions

---

New resources:

item_family, item, item_price, attached_item and differential_price are added. Applicable only for Product Catalog V2

New end points:

• coupons#create_a_coupon_for_items and coupons#update_a_coupon_for_items have been added in coupon resource. Applicable only for Product Catalog V2
• estimates#estimate_for_creating_a_subscription, estimates#estimate_for_updating_a_subscription and estimates#create_invoice_for_items_estimate have been added in estimate resource. Applicable only for Product Catalog V2
• estimates#advance_invoice_estimate has been added in estimate resource
• exports#export_item_families, exports#export_items, exports#export_item_prices, exports#export_attached_items and exports#export_differential_price have been added in export api. Applicable only for Product Catalog V2
• checkout_new_for_items and checkout_existing_for_items have been added in hosted_pages api. Applicable only for Product Catalog V2
• invoices#create_invoice_for_items_and_one-time_charges, invoices#create_invoice_for_a_charge-item and invoices#add_a_charge-item_to_a_pending_invoice have been added in invoice resource. Applicable only for Product Catalog V2
• quotes#create_a_quote_for_a_new_subscription_items, quotes#create_a_quote_for_update_subscription_items and quotes#create_a_quote_for_charge_and_charge_items have been added in quote resource. Applicable only for Product Catalog V2
• subscriptions#create_subscription_for_items, subscriptions#update_subscription_for_items, subscriptions#import_subscription_for_items and subscriptions#cancel_subscription_for_items have been added in subscription resource. Applicable only for Product Catalog V2
• subscriptions#edit_advance_invoice_schedule, subscriptions#retrieve_advance_invoice and subscriptions#remove_an_advance_invoice_schedules have been added in subscription resource
• unbilled_charges#create_an_invoice_for_unbilled_charges has been added to unbilled_charge resource

New attributes:

• item_constraints and item_constraint_criteria have been added in coupon resource. Applicable only for Product Catalog V2
• success_url and failure_url have been added in payment_intent resource
• subscription_items and item_tiers have been added in quoted_subscription resource. Applicable only for Product Catalog V2
• has_scheduled_advance_invoices has been added in subscription resource
• subscription_items, item_tiers and charged_items have been added in subscription resource. Applicable only for Product Catalog V2

New parameters:

• item_id and item_price_id have been added to the end point: subscriptions#list_subscriptions, exports#export_revenue_recognition_reports, exports#export_deferred_revenue_reports, exports#export_subscriptions. Applicable only for Product Catalog V2
• invoice_immediately, schedule_type and fixed_interval_schedule have been added to the end point: subscriptions#charge_future_renewals
• success_url and failure_url have been added to the end points: payment_intents#create_a_payment_intent, payment_intents#update_a_payment_intent

New Enum values:

• PLAN_ITEM_PRICE, ADDON_ITEM_PRICE, CHARGE_ITEM_PRICE are added to Entitytype Enum
• ITEM_FAMILY_CREATED, ITEM_FAMILY_UPDATED, ITEM_FAMILY_DELETED, ITEM_CREATED, ITEM_UPDATED, ITEM_DELETED, ITEM_PRICE_CREATED, ITEM_PRICE_UPDATED, ITEM_PRICE_DELETED, ATTACHED_ITEM_CREATED, ATTACHED_ITEM_UPDATED, ATTACHED_ITEM_DELETED, DIFFERENTIAL_PRICE_CREATED, DIFFERENTIAL_PRICE_UPDATED, DIFFERENTIAL_PRICE_DELETED are added to EventType Enum

---

• New attributes price_in_decimal, tiers[starting_unit_in_decimal], tiers[ending_unit_in_decimal], tiers[price_in_decimal] have been added to the resource addon
• New input parameters price_in_decimal, tiers[starting_unit_in_decimal], tiers[ending_unit_in_decimal], tiers[price_in_decimal] have been added to addons#create_an_addon, addons#update_an_addon apis.
• New attributes unit_amount_in_decimal, quantity_in_decimal, amount_in_decimal, line_item_tiers[starting_unit_in_decimal], line_item_tiers[ending_unit_in_decimal], line_item_tiers[quantity_used_in_decimal], line_item_tiers[unit_amount_in_decimal] have been added to the resources credit_note, credit_note_estimate, invoice, invoice_estimate
• New input parameters line_items[unit_amount_in_decimal], line_items[quantity_in_decimal] have been added to credit_notes#create_credit_note api.
• New input parameters subscription[plan_unit_price_in_decimal], subscription[plan_quantity_in_decimal], addons[quantity_in_decimal], addons[unit_price_in_decimal], event_based_addons[quantity_in_decimal], event_based_addons[unit_price_in_decimal] have been added to estimates#create_subscription_estimate, estimates#create_subscription_for_a_customer_estimate, estimates#update_subscription_estimate, hosted_pages#checkout_new_subscription, hosted_pages#checkout_existing_subscription, quotes#create_a_quote_for_a_new_subscription, quotes#edit_create_subscription_quote, quotes#create_a_quote_for_update_subscription, quotes#edit_update_subscription_quote, apis
• New input parameters subscription[plan_quantity_in_decimal], addons[quantity_in_decimal] have been added to estimates#gift_subscription_estimate, gifts#create_a_gift, hosted_pages#checkout_gift_subscription apis
• New input parameters addons[quantity_in_decimal], addons[unit_price_in_decimal], charges[amount_in_decimal] have been added to estimates#create_invoice_estimate, invoices#create_an_invoice, quotes#create_a_quote_for_one-time_charges, quotes#edit_one-time_quote apis
• New input parameter amount_in_decimal has been added to invoices#create_invoice_for_a_one-time_charge api
• Input parameter amount has been made optional to invoices#create_invoice_for_a_one-time_charge api
• New input parameters addon_quantity_in_decimal, addon_unit_price_in_decimal have been added to invoices#create_invoice_for_a_non-recurring_addon
• New input parameters line_items[unit_amount_in_decimal], line_items[quantity_in_decimal], line_items[amount_in_decimal], line_item_tiers[starting_unit_in_decimal], line_item_tiers[ending_unit_in_decimal], line_item_tiers[quantity_used_in_decimal], line_item_tiers[unit_amount_in_decimal] have been added to invoices#import_invoice api
• Input parameters line_item_tiers[starting_unit], line_item_tiers[ending_unit], line_item_tiers[quantity_used], line_item_tiers[unit_amount] have beed made optional in invoices#import_invoice api
• New input parameters addon_quantity_in_decimal, addon_unit_price_in_decimal have been added to invoices#add_non-recurring_addon_to_a_pending_invoice api
• New input parameter invoice_date has been added to invoices#close_a_pending_invoice api
• New attributes tiers[starting_unit_in_decimal], tiers[ending_unit_in_decimal], tiers[price_in_decimal], attached_addons[quantity_in_decimal], event_based_addons[quantity_in_decimal], free_quantity_in_decimal, price_in_decimal have been added to the resource plan
• New input parameters tiers[starting_unit_in_decimal], tiers[ending_unit_in_decimal], tiers[price_in_decimal], attached_addons[quantity_in_decimal], event_based_addons[quantity_in_decimal], free_quantity_in_decimal, price_in_decimal have been added to plans#create_a_plan, plans#update_a_plan apis
• New attribute amount_in_decimal has been added to the resource promotional_credit
• New input parameter amount_in_decimal has been added to promotional_credits#add_promotional_credits, promotional_credits#deduct_promotional_credits, promotional_credits#set_promotional_credits apis
• Input parameter amount has been made optional in promotional_credits#add_promotional_credits, promotional_credits#deduct_promotional_credits, promotional_credits#set_promotional_credits apis
• New attributes unit_amount_in_decimal, quantity_in_decimal, amount_in_decimal have been added to the resource quote
• New attributes addons[quantity_in_decimal], addons[unit_price_in_decimal], addons[amount_in_decimal], event_based_addons[quantity_in_decimal], event_based_addons[unit_price_in_decimal] have been added to the sub resource quoted_subscription
• New attributes unit_amount_in_decimal, quantity_in_decimal, amount_in_decimal have been added to the sub resource quoted_line_group
• New attributes addons[quantity_in_decimal], addons[unit_price_in_decimal], addons[amount_in_decimal], event_based_addons[quantity_in_decimal], event_based_addons[unit_price_in_decimal], plan_free_quantity_in_decimal, plan_quantity_in_decimal, plan_unit_price_in_decimal, plan_amount_in_decimal have been added to the resource subscription
• New input parameters plan_unit_price_in_decimal, plan_quantity_in_decimal, addons[quantity_in_decimal], addons[unit_price_in_decimal], event_based_addons[quantity_in_decimal], event_based_addons[unit_price_in_decimal] have been added to subscriptions#create_a_subscription, subscriptions#create_subscription_for_customer, subscriptions#update_a_subscription, subscriptions#import_a_subscription, subscriptions#import_subscription_for_customer apis
• New input parameter amount_in_decimal has been added to subscriptions#add_charge_at_term_end apis
• Input parameter amount has been made optional in subscriptions#add_charge_at_term_end apis
• New input parameters addon_quantity_in_decimal, addon_unit_price_in_decimal have been added to subscriptions#charge_addon_at_term_end api
• New attributes tiers[starting_unit_in_decimal], tiers[ending_unit_in_decimal], tiers[quantity_used_in_decimal], tiers[unit_amount_in_decimal], unit_amount_in_decimal, quantity_in_decimal, amount_in_decimal have been added to the resource unbilled_charge
• New endpoint transactions#refund_a_payment has been added to the resource transaction

---

• New optional attribute quoted_subscriptions has been added to the resource quote
• New optional attributes resource_version and updated_at are added to the resource payment_intent

---

• New attribute included_in_mrr has been added in addon and coupon resource
• New attribute offline_payment_method has been added in subscription and customer resource
• New input parameter included_in_mrr has been added in create_an_addon, update_an_addon, create_a_coupon and update_a_coupon apis.
• New input parameter offline_payment_method has been added in create_a_customer, list_customers, update_a_customer, create_a_subscription, create_subscription_for_customer and list_subscriptions apis
• New input parameter auto_collection has been added in update_a_subscription
• New input parameter subscription[offline_payment_method] has been added in create_subscription_estimate, create_subscription_for_a_customer_estimate, update_subscription_estimate, export_revenue_recognition_reports, export_deferred_revenue_reports, export_subscriptions, checkout_new_subscription and checkout_existing_subscription apis
• New input parameter subscription[auto_collection] has been added in checkout_existing_subscription and update_subscription_estimate apis
• New input parameter customer[offline_payment_method] has been added in export_revenue_recognition_reports, export_deferred_revenue_reports, export_customers and create_a_subscription

---

• New input parameter currency_code is added in list_addons, list_coupons, list_plans, export_plans, export_addons, export_coupons apis
• New attributes powered_by has been added in card resource
• New input parameters subscription[free_period], subscription[free_period_unit] have been added in create_subscription_estimate, create_subscription_for_a_customer_estimate, update_subscription_estimate apis
• Input parameter invoice[customer_id] is made optional in create_invoice_estimate api
• Input parameter customer_id is made optional in create_an_invoice
• Attribute created_at in dunning_attempts is made optional in the invoice resource
• New attributes free_period and free_period_unit have been added in the Subscription resource
• New enum type free_period_unit has been added with the values: DAY, WEEK, MONTH, YEAR
• New enum type powered_by has been added in card resource with the values: IDEAL, SOFORT, BANCONTACT, GIROPAY, NOT_APPLICABLE
• New endpoint import_contract_term has been added to the subscription resource
• Attributes status, amount and date inside the linked_payment are made optional in the transaction resource
• New endpoint delete has been added to the virtual_bank_account resource
• New values GIROPAY and DOTPAY have been added to the payment_method_types enum
• New values PAYMENT_SOURCE_EXPIRING and PAYMENT_SOURCE_EXPIRED have been added to the event_type enums
• New value PAYPAL has been added to the gateway enum

---

• New attributes show_description_in_invoices, show_description_in_quotes have been added in Addon, Plan resource
• New input parameters show_description_in_invoices, show_description_in_quotes have been added for create_an_addon, update_an_addon, create_a_plan, update_a_plan apis
• New attribute create_reason_code has been added in Credit notes resource
• Attribute reason_code is made optional in the Credit notes resource
• New filter parameter create_reason_code is added in list_credit_notes api
• New input parameter refund_reason_code has been added in Credit notes' Refund, Record a refund apis
• Sub-resources parent_account_access and child_account_access have been added in Customer resource
• New attribute use_default_hierarchy_settings has been added in Customer resource
• New endpoint update_hierarchy_settings has been added in Customer resource
• New input parameters use_default_hierarchy_settings, parent_account_access, child_account_access have been added in link_a_customer api
• New input parameter invoice_notes, coupon_ids, invoice[subscription_id], charges[taxable], charges[tax_profile_id], charges[avalara_tax_code], charges[taxjar_product_code] has been added to create_invoice_estimate api
• New input param cancel_reason_code has been added to export_revenue_recognition_reports, export_deferred_revenue_reports, export_subscriptions, export_credit_notes apis
• New input param coupon_ids has been added to checkout_new_subscription, checkout_existing_subscription apis
• Input param subscription_coupon has been deprecated in checkout_new_subscription, checkout_existing_subscription apis
• New attribute void_reason_code has been added to the Invoice resource
• Attribute cn_reason_code has been made optional in applied_credits, adjustment_credit_notes, issued_credit_notes, linked_credit_note sub-resources
• New attribute cn_create_reason_code has been added in applied_credits, adjustment_credit_notes, issued_credit_notes, linked_credit_note sub-resources
• New input parameter subscription_id, invoice_note, remove_general_note, coupon_ids, charges[taxable], charges[tax_profile_id], charges[avalara_tax_code], charges[taxjar_product_code] have been added to create_an_invoice api
• Input parameter coupon is deprecated from create_an_invoice api
• New filter parameter void_reason_code has been added to list_invoices api
• New input parameter invoice_note, remove_general_note, notes_to_remove[entity_type], notes_to_remove[entity_id] have been added to close_a_pending_invoice api
• New input parameter void_reason_code has been added to void_an_invoice api
• New input parameter credit_note[create_reason_code] has been added to refund_an_invoice, record_refund_for_an_invoice api
• New endpoints import_an_order and delete_an_imported_order have been added to Order resource
• New filter parameter exclude_deleted_credit_notes has been added to list_orders api
• New attribute payment_method_type has been added to payment_intent resource and active_payment_attempt sub-resource
• New input parameter payment_method_type has been added to create_a_payment_intent, update_a_payment_intent api
• New attributes version, contract_term_start, contract_term_end, contract_term_termination_fee have been added to Quotes resource
• New endpoints edit_create_subscription_quote, edit_update_subscription_quote, edit_one_time_quote, extend_expiry_date have beed added to Quotes resource
• New input parameters contract_term[action_at_term_end], contract_term[cancellation_cutoff_period], subscription[contract_term_billing_cycle_on_renewal] have been added to create_a_quote_for_a_new_subscription, create_a_quote_for_update_subscription apis
• New attribute version has been added to quote_line_group sub-resource
• New attribute cancel_reason_code has been added to Subscriptions resource
• New filter parameter cancel_reason_code has been added to list_subscriptions, cancel_a_subscription apis
• New input parameter contract_term_billing_cycle_on_renewal has been added to import_a_subscription, import_subscription_for_customer apis
• New input parameter event_based_addon has been added to cancel_a_subscription api
• New filter parameter is_voided has been added to list_unbilled_charges api
• New event_types MRR_UPDATED, ORDER_DELETED have been added
• New values SOFORT, BANCONTACT have been added to the payment_method_types enum
• New attributes entity_type_description has been added to the line_items sub-resource

---

• A subresource contract_term has been added in Subscription resource
• New endpoint refund_a_credit_note has been added in Credit notes resource
• New endpoint list_quote_line_groups has been added in Quotes resource
• New endpoint list_contract_terms_for_a_subscription has been added in Subscriptions resource
• New input parameter contract_term_billing_cycle_on_renewal, contract_term[action_at_term_end], contract_term[cancellation_cutoff_period] has been added in create_a_subscription, create_subscription_for_customer, update_a_subscription and reactivate_a_subscription apis
• New input parameter contract_term_cancel_option has been added in cancel_a_subscription api
• New input parameter contract_term[action_at_term_end], contract_term[cancellation_cutoff_period], subscription[contract_term_billing_cycle_on_renewal] has been added in create_subscription_estimate, create_subscription_for_a_customer_estimate, checkout_new_subscription, checkout_existing_subscription apis
• New input parameter business_customer_without_vat_number has been added in create_a_customer and update_billing_info_for_a_customer apis
• New input parameter addons[service_period] replaces the parameter addons[date_from] and addons[date_to] in create_a_quote_for_one-time_charges api
• New input parameter charges[service_period] replaces the parameter charges[date_from] and charges[date_to] in create_a_quote_for_one-time_charges api
• New input parameter consolidated_view has been added in retrieve_quote_as_pdf api
• New input parameter customer[business_customer_without_vat_number] has been added in create_a_subscription, update_a_subscription apis
• New value CHECKOUT_COM has been added in gateway enum
• New value CONTRACT_TERMINATION has been added to eventBasedAddons onEvent enum
• New values IDEAL, GOOGLE_PAY has been added to payment types enum
• New event types CONTRACT_TERM_CREATED, CONTRACT_TERM_RENEWED, CONTRACT_TERM_TERMINATED, CONTRACT_TERM_COMPLETED, CONTRACT_TERM_CANCELLED have been added

---

• New attribute total_payable and charge_on_aaceptance has been added in Quote.java
• New input parameter cancel_at has been added in cancel_a_subscription api

---

• New attribute taxjar_product_code has been added in Addon and Plan resource.
• New input parameter taxjar_product_code has been added in create_an_addon, update_an_addon, create_a_plan and update_a_plan api
• New input parameter taxjar_exemption_category has been added in create_a_customer, update_a_customer , create_a_subscription and import_a_subscription api
• New input parameter no_expiry has been added in gift_subscription_estimate and create_a_gift api
• New attribute no_expiry has been added in Gift resource
• New endpoint update_gift has been added in Gift resource
• New value BUSINESS_CHECKING has been added in AccountType enum
• New value CCD has been added in EcheckType enum
• New event type GIFT_UPDATED has been added
• New enum taxjar_exemption_category has been added

---

• Fix - Added CustomerRelationship to chargebee.php

---

• New endpoints gift_subscription_estimate and create_invoice_estimate have been added in estimate resource.
• New input parameter reference_id in payment_intent has been added in create_a_gift, create_an_invoice, create_using_payment_intent, create_a_subscription, create_subscription_for_customer, update_a_subscription, reactivate_a_subscription, resume_a_subscription, create_a_customer and collect_payment_for_customer api.
• New endpoint record_refund_for_a_payment has been added in transaction resource.

---

• New attribute client_profile_id has been added in customer resource.
• New input parameter client_profile_id has been added in create_a_customer, update_a_customer, create_subscription_estimate, create_a_subscription and import_a_subscription api.
• New input parameter payment_intent has been added in create_a_gift, create_an_invoice, reactivate_a_subscription and resume_a_subscription api.
• New input parameter replace_primary_payment_source has been added in create_an_invoice api.
• New attribute currency_code has been added in payment_intent resource.

---

• New resource payment_intent has been added.
• New input parameter 'id' in payment_intent sub-param has been added in create_a_customer, collect_payment_for_customer, create_using_payment_intent, create_a_subscription, create_subscription_for_customer and update_a_subscription .
• New event_types PAYMENT_INTENT_CREATED and PAYMENT_INTENT_UPDATED have been added.