EarlyFraudWarning.php
74 lines
| 1 | <?php |
| 2 | |
| 3 | // File generated from our OpenAPI spec |
| 4 | |
| 5 | namespace AmeliaVendor\Stripe\Radar; |
| 6 | |
| 7 | /** |
| 8 | * An early fraud warning indicates that the card issuer has notified us that a |
| 9 | * charge may be fraudulent. |
| 10 | * |
| 11 | * Related guide: <a href="https://stripe.com/docs/disputes/measuring#early-fraud-warnings">Early fraud warnings</a> |
| 12 | * |
| 13 | * @property string $id Unique identifier for the object. |
| 14 | * @property string $object String representing the object's type. Objects of the same type share the same value. |
| 15 | * @property bool $actionable An EFW is actionable if it has not received a dispute and has not been fully refunded. You may wish to proactively refund a charge that receives an EFW, in order to avoid receiving a dispute later. |
| 16 | * @property string|\AmeliaVendor\Stripe\Charge $charge ID of the charge this early fraud warning is for, optionally expanded. |
| 17 | * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch. |
| 18 | * @property string $fraud_type The type of fraud labelled by the issuer. One of <code>card_never_received</code>, <code>fraudulent_card_application</code>, <code>made_with_counterfeit_card</code>, <code>made_with_lost_card</code>, <code>made_with_stolen_card</code>, <code>misc</code>, <code>unauthorized_use_of_card</code>. |
| 19 | * @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. |
| 20 | * @property null|string|\AmeliaVendor\Stripe\PaymentIntent $payment_intent ID of the Payment Intent this early fraud warning is for, optionally expanded. |
| 21 | */ |
| 22 | class EarlyFraudWarning extends \AmeliaVendor\Stripe\ApiResource |
| 23 | { |
| 24 | const OBJECT_NAME = 'radar.early_fraud_warning'; |
| 25 | |
| 26 | const FRAUD_TYPE_CARD_NEVER_RECEIVED = 'card_never_received'; |
| 27 | const FRAUD_TYPE_FRAUDULENT_CARD_APPLICATION = 'fraudulent_card_application'; |
| 28 | const FRAUD_TYPE_MADE_WITH_COUNTERFEIT_CARD = 'made_with_counterfeit_card'; |
| 29 | const FRAUD_TYPE_MADE_WITH_LOST_CARD = 'made_with_lost_card'; |
| 30 | const FRAUD_TYPE_MADE_WITH_STOLEN_CARD = 'made_with_stolen_card'; |
| 31 | const FRAUD_TYPE_MISC = 'misc'; |
| 32 | const FRAUD_TYPE_UNAUTHORIZED_USE_OF_CARD = 'unauthorized_use_of_card'; |
| 33 | |
| 34 | /** |
| 35 | * Returns a list of early fraud warnings. |
| 36 | * |
| 37 | * @param null|array{charge?: string, created?: array|int, ending_before?: string, expand?: string[], limit?: int, payment_intent?: string, starting_after?: string} $params |
| 38 | * @param null|array|string $opts |
| 39 | * |
| 40 | * @return \AmeliaVendor\Stripe\Collection<EarlyFraudWarning> of ApiResources |
| 41 | * |
| 42 | * @throws \AmeliaVendor\Stripe\Exception\ApiErrorException if the request fails |
| 43 | */ |
| 44 | public static function all($params = null, $opts = null) |
| 45 | { |
| 46 | $url = static::classUrl(); |
| 47 | |
| 48 | return static::_requestPage($url, \AmeliaVendor\Stripe\Collection::class, $params, $opts); |
| 49 | } |
| 50 | |
| 51 | /** |
| 52 | * Retrieves the details of an early fraud warning that has previously been |
| 53 | * created. |
| 54 | * |
| 55 | * Please refer to the <a href="#early_fraud_warning_object">early fraud |
| 56 | * warning</a> object reference for more details. |
| 57 | * |
| 58 | * @param array|string $id the ID of the API resource to retrieve, or an options array containing an `id` key |
| 59 | * @param null|array|string $opts |
| 60 | * |
| 61 | * @return EarlyFraudWarning |
| 62 | * |
| 63 | * @throws \AmeliaVendor\Stripe\Exception\ApiErrorException if the request fails |
| 64 | */ |
| 65 | public static function retrieve($id, $opts = null) |
| 66 | { |
| 67 | $opts = \AmeliaVendor\Stripe\Util\RequestOptions::parse($opts); |
| 68 | $instance = new static($id, $opts); |
| 69 | $instance->refresh(); |
| 70 | |
| 71 | return $instance; |
| 72 | } |
| 73 | } |
| 74 |