This is an object representing a person associated with a Stripe account.
A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account. See the Standard onboarding or Express onboarding documentation for information about platform prefilling and account onboarding steps.
Related guide: Handling identity verification with the API
+ * @property null|\Stripe\Person $individualThis is an object representing a person associated with a Stripe account.
A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account. See the Standard onboarding or Express onboarding documentation for information about platform prefilling and account onboarding steps.
Related guide: Handling identity verification with the API
* @property null|\Stripe\StripeObject $metadata Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. * @property null|bool $payouts_enabled Whether Stripe can send payouts to this account. * @property null|\Stripe\StripeObject $requirements diff --git a/lib/Event.php b/lib/Event.php index e01074ae9..4fc80bedd 100644 --- a/lib/Event.php +++ b/lib/Event.php @@ -131,6 +131,7 @@ class Event extends ApiResource const IDENTITY_VERIFICATION_SESSION_VERIFIED = 'identity.verification_session.verified'; const INVOICEITEM_CREATED = 'invoiceitem.created'; const INVOICEITEM_DELETED = 'invoiceitem.deleted'; + const INVOICEITEM_UPDATED = 'invoiceitem.updated'; const INVOICE_CREATED = 'invoice.created'; const INVOICE_DELETED = 'invoice.deleted'; const INVOICE_FINALIZATION_FAILED = 'invoice.finalization_failed'; diff --git a/lib/File.php b/lib/File.php index 59790da0c..a5d2b9e27 100644 --- a/lib/File.php +++ b/lib/File.php @@ -5,10 +5,10 @@ namespace Stripe; /** - * This is an object representing a file hosted on Stripe's servers. The - * file may have been uploaded by yourself using the create file - * request (for example, when uploading dispute evidence) or it may have - * been created by Stripe (for example, the results of a Sigma scheduled + * This object represents files hosted on Stripe's servers. You can upload + * files with the create file request + * (for example, when uploading dispute evidence). Stripe also + * creates files independetly (for example, the results of a Sigma scheduled * query). * * Related guide: File upload guide @@ -16,14 +16,14 @@ * @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 int $created Time at which the object was created. Measured in seconds since the Unix epoch. - * @property null|int $expires_at The time at which the file expires and is no longer available in epoch seconds. - * @property null|string $filename A filename for the file, suitable for saving to a filesystem. + * @property null|int $expires_at The file expires and isn't available at this time in epoch seconds. + * @property null|string $filename The suitable name for saving the file to a filesystem. * @property null|\Stripe\Collection<\Stripe\FileLink> $links A list of file links that point at this file. * @property string $purpose The purpose of the uploaded file. - * @property int $size The size in bytes of the file object. - * @property null|string $title A user friendly title for the document. - * @property null|string $type The type of the file returned (e.g.,csv, pdf, jpg, or png).
- * @property null|string $url The URL from which the file can be downloaded using your live secret API key.
+ * @property int $size The size of the file object in bytes.
+ * @property null|string $title A suitable title for the document.
+ * @property null|string $type The returned file type (for example, csv, pdf, jpg, or png).
+ * @property null|string $url Use your live secret API key to download the file from this URL.
*/
class File extends ApiResource
{
diff --git a/lib/FileLink.php b/lib/FileLink.php
index bb6ed6488..cab855eb6 100644
--- a/lib/FileLink.php
+++ b/lib/FileLink.php
@@ -6,14 +6,14 @@
/**
* To share the contents of a File object with non-Stripe users, you can
- * create a FileLink. FileLinks contain a URL that can be used to
+ * create a FileLink. FileLinks contain a URL that you can use to
* retrieve the contents of the file without authentication.
*
* @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 int $created Time at which the object was created. Measured in seconds since the Unix epoch.
- * @property bool $expired Whether this link is already expired.
- * @property null|int $expires_at Time at which the link expires.
+ * @property bool $expired Returns if the link is already expired.
+ * @property null|int $expires_at Time that the link expires.
* @property string|\Stripe\File $file The file object this link points to.
* @property bool $livemode Has the value true if the object exists in live mode or the value false if the object exists in test mode.
* @property \Stripe\StripeObject $metadata Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
diff --git a/lib/Person.php b/lib/Person.php
index d026788a8..f357d0be8 100644
--- a/lib/Person.php
+++ b/lib/Person.php
@@ -10,7 +10,7 @@
* A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account.
* See the Standard onboarding or Express onboarding documentation for information about platform prefilling and account onboarding steps.
*
- * Related guide: Handling identity verification with the API
+ * Related guide: Handling identity verification with the API
*
* @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.
diff --git a/lib/Service/FileService.php b/lib/Service/FileService.php
index 82ef0e500..ef76f8f77 100644
--- a/lib/Service/FileService.php
+++ b/lib/Service/FileService.php
@@ -7,9 +7,9 @@
class FileService extends \Stripe\Service\AbstractService
{
/**
- * Returns a list of the files that your account has access to. The files are
- * returned sorted by creation date, with the most recently created files appearing
- * first.
+ * Returns a list of the files that your account has access to. Stripe sorts and
+ * returns the files by their creation dates, placing the most recently created
+ * files at the top.
*
* @param null|array $params
* @param null|array|\Stripe\Util\RequestOptions $opts
@@ -24,10 +24,9 @@ public function all($params = null, $opts = null)
}
/**
- * Retrieves the details of an existing file object. Supply the unique file ID from
- * a file, and Stripe will return the corresponding file object. To access file
- * contents, see the File Upload
- * Guide.
+ * Retrieves the details of an existing file object. After you supply a unique file
+ * ID, Stripe returns the corresponding file object. Learn how to access file contents.
*
* @param string $id
* @param null|array $params
diff --git a/lib/Service/Issuing/AuthorizationService.php b/lib/Service/Issuing/AuthorizationService.php
index 60d78b7cc..c3bcbc57f 100644
--- a/lib/Service/Issuing/AuthorizationService.php
+++ b/lib/Service/Issuing/AuthorizationService.php
@@ -24,12 +24,12 @@ public function all($params = null, $opts = null)
}
/**
- * Approves a pending Issuing Authorization object. This request
- * should be made within the timeout window of the Authorization object. This
+ * request should be made within the timeout window of the real-time
- * authorization flow. You can also respond directly to the webhook request to
- * approve an authorization (preferred). More details can be found here.
+ * authorization flow. This method is deprecated. Instead, respond
+ * directly to the webhook request to approve an authorization.
*
* @param string $id
* @param null|array $params
@@ -45,12 +45,12 @@ public function approve($id, $params = null, $opts = null)
}
/**
- * Declines a pending Issuing Authorization object. This request
- * should be made within the timeout window of the Authorization object. This
+ * request should be made within the timeout window of the real time
- * authorization flow. You can also respond directly to the webhook request to
- * decline an authorization (preferred). More details can be found here.
+ * authorization flow. This method is deprecated. Instead, respond
+ * directly to the webhook request to decline an authorization.
*
* @param string $id
* @param null|array $params
diff --git a/lib/Service/PaymentIntentService.php b/lib/Service/PaymentIntentService.php
index a3fd8d133..f7cc083b2 100644
--- a/lib/Service/PaymentIntentService.php
+++ b/lib/Service/PaymentIntentService.php
@@ -239,10 +239,10 @@ public function search($params = null, $opts = null)
/**
* Updates properties on a PaymentIntent object without confirming.
*
- * Depending on which properties you update, you may need to confirm the
- * PaymentIntent again. For example, updating the payment_method will
- * always require you to confirm the PaymentIntent again. If you prefer to update
- * and confirm at the same time, we recommend updating properties via the payment_method
+ * always requires you to confirm the PaymentIntent again. If you prefer to update
+ * and confirm at the same time, we recommend updating properties through the confirm API instead.
*
* @param string $id
diff --git a/lib/TaxId.php b/lib/TaxId.php
index e85c71bbc..6a87d6913 100644
--- a/lib/TaxId.php
+++ b/lib/TaxId.php
@@ -5,10 +5,10 @@
namespace Stripe;
/**
- * You can add one or multiple tax IDs to a customer.
- * A customer's tax IDs are displayed on invoices and credit notes issued for the customer.
+ * You can add one or multiple tax IDs to a customer or account.
+ * Customer and account tax IDs get displayed on related invoices and credit notes.
*
- * Related guide: Customer tax identification numbers
+ * Related guides: Customer tax identification numbers, Account tax IDs
*
* @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.