ExchangeRate.php — Booking for Appointments and Events Calendar – Amelia 2.4.4

ameliabooking / vendor / stripe / stripe-php / lib / ExchangeRate.php

ameliabooking / vendor / stripe / stripe-php / lib Last commit date

ExchangeRate.php

75 lines

1	<?php
2
3	// File generated from our OpenAPI spec
4	namespace AmeliaVendor\Stripe;
5
6	/**
7	* <code>ExchangeRate</code> objects allow you to determine the rates that Stripe is currently
8	* using to convert from one currency to another. Since this number is variable
9	* throughout the day, there are various reasons why you might want to know the current
10	* rate (for example, to dynamically price an item for a user with a default
11	* payment in a foreign currency).
12	*
13	* Please refer to our <a href="https://stripe.com/docs/fx-rates">Exchange Rates API</a> guide for more details.
14	*
15	* <em>[Note: this integration path is supported but no longer recommended]</em> Additionally,
16	* you can guarantee that a charge is made with an exchange rate that you expect is
17	* current. To do so, you must pass in the exchange_rate to charges endpoints. If the
18	* value is no longer up to date, the charge won't go through. Please refer to our
19	* <a href="https://stripe.com/docs/exchange-rates">Using with charges</a> guide for more details.
20	*
21	* -----
22	*
23	*
24	*
25	* <em>This Exchange Rates API is a Beta Service and is subject to Stripe's terms of service. You may use the API solely for the purpose of transacting on Stripe. For example, the API may be queried in order to:</em>
26	*
27	* - <em>localize prices for processing payments on Stripe</em>
28	* - <em>reconcile Stripe transactions</em>
29	* - <em>determine how much money to send to a connected account</em>
30	* - <em>determine app fees to charge a connected account</em>
31	*
32	* <em>Using this Exchange Rates API beta for any purpose other than to transact on Stripe is strictly prohibited and constitutes a violation of Stripe's terms of service.</em>
33	*
34	* @property string $id Unique identifier for the object. Represented as the three-letter <a href="https://www.iso.org/iso-4217-currency-codes.html">ISO currency code</a> in lowercase.
35	* @property string $object String representing the object's type. Objects of the same type share the same value.
36	* @property \StripeObject $rates Hash where the keys are supported currencies and the values are the exchange rate at which the base id currency converts to the key currency.
37	*/
38	class ExchangeRate extends ApiResource
39	{
40	const OBJECT_NAME = 'exchange_rate';
41	/**
42	* Returns a list of objects that contain the rates at which foreign currencies are
43	* converted to one another. Only shows the currencies for which Stripe supports.
44	*
45	* @param null\|array{ending_before?: string, expand?: string[], limit?: int, starting_after?: string} $params
46	* @param null\|array\|string $opts
47	*
48	* @return Collection<ExchangeRate> of ApiResources
49	*
50	* @throws Exception\ApiErrorException if the request fails
51	*/
52	public static function all($params = null, $opts = null)
53	{
54	$url = static::classUrl();
55	return static::_requestPage($url, Collection::class, $params, $opts);
56	}
57	/**
58	* Retrieves the exchange rates from the given currency to every supported
59	* currency.
60	*
61	* @param array\|string $id the ID of the API resource to retrieve, or an options array containing an `id` key
62	* @param null\|array\|string $opts
63	*
64	* @return ExchangeRate
65	*
66	* @throws Exception\ApiErrorException if the request fails
67	*/
68	public static function retrieve($id, $opts = null)
69	{
70	$opts = \AmeliaVendor\Stripe\Util\RequestOptions::parse($opts);
71	$instance = new static($id, $opts);
72	$instance->refresh();
73	return $instance;
74	}
75	}