diff --git a/lib/PaymentLink.php b/lib/PaymentLink.php
index 95c2ebed0c..c0399fe2c5 100644
--- a/lib/PaymentLink.php
+++ b/lib/PaymentLink.php
@@ -5,12 +5,21 @@
 namespace Stripe;
 
 /**
- * A payment link allows you create payment pages through a url you can share with
- * customers.
+ * A payment link is a shareable URL that will take your customers to a hosted
+ * payment page. A payment link can be shared and used multiple times.
+ *
+ * When a customer opens a payment link it will open a new <a
+ * href="https://stripe.com/docs/api/checkout/sessions">checkout session</a> to
+ * render the payment page. You can use <a
+ * href="https://stripe.com/docs/api/events/types#event_types-checkout.session.completed">checkout
+ * session events</a> to track payments through payment links.
+ *
+ * Related guide: <a
+ * href="https://stripe.com/docs/payments/payment-links/api">Payment Links API</a>
  *
  * @property string $id Unique identifier for the object.
  * @property string $object String representing the object's type. Objects of the same type share the same value.
- * @property bool $active Whether the payment link's <code>url</code> is active. If <code>false</code>, customers visiting the url will be redirected.
+ * @property bool $active Whether the payment link's <code>url</code> is active. If <code>false</code>, customers visiting the URL will be shown a page saying that the link has been deactivated.
  * @property \Stripe\StripeObject $after_completion
  * @property bool $allow_promotion_codes Whether user redeemable promotion codes are enabled.
  * @property null|int $application_fee_amount The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account.
@@ -21,11 +30,12 @@
  * @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 \Stripe\StripeObject $metadata Set of <a href="https://stripe.com/docs/api/metadata">key-value pairs</a> that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
  * @property null|string|\Stripe\Account $on_behalf_of The account on behalf of which to charge. See the <a href="https://support.stripe.com/questions/sending-invoices-on-behalf-of-connected-accounts">Connect documentation</a> for details.
- * @property null|string[] $payment_method_types The list of payment method types that customers can use. When <code>null</code>, your <a href="https://dashboard.stripe.com/settings/payment_methods">payment methods settings</a> will be used.
+ * @property null|string[] $payment_method_types The list of payment method types that customers can use. When <code>null</code>, Stripe will dynamically show relevant payment methods you've enabled in your <a href="https://dashboard.stripe.com/settings/payment_methods">payment method settings</a>.
+ * @property \Stripe\StripeObject $phone_number_collection
  * @property null|\Stripe\StripeObject $shipping_address_collection Configuration for collecting the customer's shipping address.
  * @property null|\Stripe\StripeObject $subscription_data When creating a subscription, the specified configuration data will be used. There must be at least one line item with a recurring price to use <code>subscription_data</code>.
  * @property null|\Stripe\StripeObject $transfer_data The account (if any) the payments will be attributed to for tax reporting, and where funds from each payment will be transferred to.
- * @property string $url The public url that can be shared with customers.
+ * @property string $url The public URL that can be shared with customers.
  */
 class PaymentLink extends ApiResource
 {
diff --git a/lib/Service/AccountService.php b/lib/Service/AccountService.php
index e69c5ee904..28d094ec23 100644
--- a/lib/Service/AccountService.php
+++ b/lib/Service/AccountService.php
@@ -148,9 +148,10 @@ public function createPerson($parentId, $params = null, $opts = null)
     /**
      * With <a href="/docs/connect">Connect</a>, you can delete accounts you manage.
      *
-     * Accounts created using test-mode keys can be deleted at any time. Custom or
-     * Express accounts created using live-mode keys can only be deleted once all
-     * balances are zero.
+     * Accounts created using test-mode keys can be deleted at any time. Standard
+     * accounts created using live-mode keys cannot be deleted. Custom or Express
+     * accounts created using live-mode keys can only be deleted once all balances are
+     * zero.
      *
      * If you want to delete your own account, use the <a
      * href="https://dashboard.stripe.com/account">account information tab in your
diff --git a/tests/Stripe/GeneratedExamplesTest.php b/tests/Stripe/GeneratedExamplesTest.php
index 49296f7c8c..c8a9f37a37 100644
--- a/tests/Stripe/GeneratedExamplesTest.php
+++ b/tests/Stripe/GeneratedExamplesTest.php
@@ -2687,7 +2687,7 @@ public function testListLineItemsPaymentLink()
         $this->expectsRequest('get', '/v1/payment_links/pl_xyz/line_items');
         $result = $this->client->paymentLinks->allLineItems('pl_xyz', []);
         static::assertInstanceOf(\Stripe\Collection::class, $result);
-        static::assertInstanceOf(\Stripe\LineItem::class, $result->data[0]);
+        static::assertInstanceOf(\Stripe\PaymentLink::class, $result->data[0]);
     }
 
     public function testRetrievePaymentLink()