API Updates

OPENAPI_VERSION

@@ -1 +1 @@
-v202
+v203

lib/Invoice.php

@@ -41,7 +41,7 @@
  * Related guide: <a href="https://stripe.com/docs/billing/invoices/sending">Send
  * Invoices to Customers</a>.
  *
- * @property string $id Unique identifier for the object.
+ * @property string $id Unique identifier for the object. This property is always present unless the invoice is an upcoming invoice. See <a href="https://stripe.com/docs/api/invoices/upcoming">Retrieve an upcoming invoice</a> for more details.
  * @property string $object String representing the object's type. Objects of the same type share the same value.
  * @property null|string $account_country The country of the business associated with this invoice, most often the business creating the invoice.
  * @property null|string $account_name The public name of the business associated with this invoice, most often the business creating the invoice.

lib/Service/PaymentIntentService.php

@@ -91,29 +91,25 @@ public function capture($id, $params = null, $opts = null)
     /**
      * Confirm that your customer intends to pay with current or provided payment
      * method. Upon confirmation, the PaymentIntent will attempt to initiate a payment.
-     *
      * If the selected payment method requires additional authentication steps, the
      * PaymentIntent will transition to the <code>requires_action</code> status and
      * suggest additional actions via <code>next_action</code>. If payment fails, the
      * PaymentIntent will transition to the <code>requires_payment_method</code>
      * status. If payment succeeds, the PaymentIntent will transition to the
      * <code>succeeded</code> status (or <code>requires_capture</code>, if
-     * <code>capture_method</code> is set to <code>manual</code>).
-     *
-     * If the <code>confirmation_method</code> is <code>automatic</code>, payment may
-     * be attempted using our <a
+     * <code>capture_method</code> is set to <code>manual</code>). If the
+     * <code>confirmation_method</code> is <code>automatic</code>, payment may be
+     * attempted using our <a
      * href="/docs/stripe-js/reference#stripe-handle-card-payment">client SDKs</a> and
      * the PaymentIntent’s <a
      * href="#payment_intent_object-client_secret">client_secret</a>. After
      * <code>next_action</code>s are handled by the client, no additional confirmation
-     * is required to complete the payment.
-     *
-     * If the <code>confirmation_method</code> is <code>manual</code>, all payment
-     * attempts must be initiated using a secret key. If any actions are required for
-     * the payment, the PaymentIntent will return to the
-     * <code>requires_confirmation</code> state after those actions are completed. Your
-     * server needs to then explicitly re-confirm the PaymentIntent to initiate the
-     * next payment attempt. Read the <a
+     * is required to complete the payment. If the <code>confirmation_method</code> is
+     * <code>manual</code>, all payment attempts must be initiated using a secret key.
+     * If any actions are required for the payment, the PaymentIntent will return to
+     * the <code>requires_confirmation</code> state after those actions are completed.
+     * Your server needs to then explicitly re-confirm the PaymentIntent to initiate
+     * the next payment attempt. Read the <a
      * href="/docs/payments/payment-intents/web-manual">expanded documentation</a> to
      * learn more about manual confirmation.
      *

lib/Source.php

@@ -10,6 +10,12 @@
  * API just like a <code>Card</code> object: once chargeable, they can be charged,
  * or can be attached to customers.
  *
+ * Stripe doesn't recommend using the deprecated <a
+ * href="https://stripe.com/docs/api/sources">Sources API</a>. We recommend that
+ * you adopt the <a
+ * href="https://stripe.com/docs/api/payment_methods">PaymentMethods API</a>. This
+ * newer API provides access to our latest features and payment method types.
+ *
  * Related guides: <a href="https://stripe.com/docs/sources">Sources API</a> and <a
  * href="https://stripe.com/docs/sources/customers">Sources &amp; Customers</a>.
  *

lib/TaxId.php

@@ -18,7 +18,7 @@
  * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
  * @property null|string|\Stripe\Customer $customer ID of the customer.
  * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
- * @property string $type Type of the tax ID, one of <code>ae_trn</code>, <code>au_abn</code>, <code>au_arn</code>, <code>bg_uic</code>, <code>br_cnpj</code>, <code>br_cpf</code>, <code>ca_bn</code>, <code>ca_gst_hst</code>, <code>ca_pst_bc</code>, <code>ca_pst_mb</code>, <code>ca_pst_sk</code>, <code>ca_qst</code>, <code>ch_vat</code>, <code>cl_tin</code>, <code>es_cif</code>, <code>eu_oss_vat</code>, <code>eu_vat</code>, <code>gb_vat</code>, <code>ge_vat</code>, <code>hk_br</code>, <code>hu_tin</code>, <code>id_npwp</code>, <code>il_vat</code>, <code>in_gst</code>, <code>is_vat</code>, <code>jp_cn</code>, <code>jp_rn</code>, <code>kr_brn</code>, <code>li_uid</code>, <code>mx_rfc</code>, <code>my_frp</code>, <code>my_itn</code>, <code>my_sst</code>, <code>no_vat</code>, <code>nz_gst</code>, <code>ru_inn</code>, <code>ru_kpp</code>, <code>sa_vat</code>, <code>sg_gst</code>, <code>sg_uen</code>, <code>si_tin</code>, <code>th_vat</code>, <code>tw_vat</code>, <code>ua_vat</code>, <code>us_ein</code>, or <code>za_vat</code>. Note that some legacy tax IDs have type <code>unknown</code>
+ * @property string $type Type of the tax ID, one of <code>ae_trn</code>, <code>au_abn</code>, <code>au_arn</code>, <code>bg_uic</code>, <code>br_cnpj</code>, <code>br_cpf</code>, <code>ca_bn</code>, <code>ca_gst_hst</code>, <code>ca_pst_bc</code>, <code>ca_pst_mb</code>, <code>ca_pst_sk</code>, <code>ca_qst</code>, <code>ch_vat</code>, <code>cl_tin</code>, <code>es_cif</code>, <code>eu_oss_vat</code>, <code>eu_vat</code>, <code>gb_vat</code>, <code>ge_vat</code>, <code>hk_br</code>, <code>hu_tin</code>, <code>id_npwp</code>, <code>il_vat</code>, <code>in_gst</code>, <code>is_vat</code>, <code>jp_cn</code>, <code>jp_rn</code>, <code>jp_trn</code>, <code>ke_pin</code>, <code>kr_brn</code>, <code>li_uid</code>, <code>mx_rfc</code>, <code>my_frp</code>, <code>my_itn</code>, <code>my_sst</code>, <code>no_vat</code>, <code>nz_gst</code>, <code>ru_inn</code>, <code>ru_kpp</code>, <code>sa_vat</code>, <code>sg_gst</code>, <code>sg_uen</code>, <code>si_tin</code>, <code>th_vat</code>, <code>tw_vat</code>, <code>ua_vat</code>, <code>us_ein</code>, or <code>za_vat</code>. Note that some legacy tax IDs have type <code>unknown</code>
  * @property string $value Value of the tax ID.
  * @property null|\Stripe\StripeObject $verification Tax ID verification information.
  */
@@ -55,6 +55,8 @@ class TaxId extends ApiResource
     const TYPE_IS_VAT = 'is_vat';
     const TYPE_JP_CN = 'jp_cn';
     const TYPE_JP_RN = 'jp_rn';
+    const TYPE_JP_TRN = 'jp_trn';
+    const TYPE_KE_PIN = 'ke_pin';
     const TYPE_KR_BRN = 'kr_brn';
     const TYPE_LI_UID = 'li_uid';
     const TYPE_MX_RFC = 'mx_rfc';