Файл: sngine-v2.8/Script/includes/libs/Stripe/lib/Service/PaymentMethodService.php
Строк: 156
<?php
namespace StripeService;
class PaymentMethodService extends StripeServiceAbstractService
{
/**
* Returns a list of PaymentMethods for a given Customer.
*
* @param null|array $params
* @param null|array|StripeUtilRequestOptions $opts
*
* @throws StripeExceptionApiErrorException if the request fails
*
* @return StripeCollection
*/
public function all($params = null, $opts = null)
{
return $this->requestCollection('get', '/v1/payment_methods', $params, $opts);
}
/**
* Attaches a PaymentMethod object to a Customer.
*
* To attach a new PaymentMethod to a customer for future payments, we recommend
* you use a <a href="/docs/api/setup_intents">SetupIntent</a> or a PaymentIntent
* with <a
* href="/docs/api/payment_intents/create#create_payment_intent-setup_future_usage">setup_future_usage</a>.
* These approaches will perform any necessary steps to ensure that the
* PaymentMethod can be used in a future payment. Using the
* <code>/v1/payment_methods/:id/attach</code> endpoint does not ensure that future
* payments can be made with the attached PaymentMethod. See <a
* href="/docs/payments/payment-intents#future-usage">Optimizing cards for future
* payments</a> for more information about setting up future payments.
*
* To use this PaymentMethod as the default for invoice or subscription payments,
* set <a
* href="/docs/api/customers/update#update_customer-invoice_settings-default_payment_method"><code>invoice_settings.default_payment_method</code></a>,
* on the Customer to the PaymentMethod’s ID.
*
* @param string $id
* @param null|array $params
* @param null|array|StripeUtilRequestOptions $opts
*
* @throws StripeExceptionApiErrorException if the request fails
*
* @return StripePaymentMethod
*/
public function attach($id, $params = null, $opts = null)
{
return $this->request('post', $this->buildPath('/v1/payment_methods/%s/attach', $id), $params, $opts);
}
/**
* Creates a PaymentMethod object. Read the <a
* href="/docs/stripe-js/reference#stripe-create-payment-method">Stripe.js
* reference</a> to learn how to create PaymentMethods via Stripe.js.
*
* @param null|array $params
* @param null|array|StripeUtilRequestOptions $opts
*
* @throws StripeExceptionApiErrorException if the request fails
*
* @return StripePaymentMethod
*/
public function create($params = null, $opts = null)
{
return $this->request('post', '/v1/payment_methods', $params, $opts);
}
/**
* Detaches a PaymentMethod object from a Customer.
*
* @param string $id
* @param null|array $params
* @param null|array|StripeUtilRequestOptions $opts
*
* @throws StripeExceptionApiErrorException if the request fails
*
* @return StripePaymentMethod
*/
public function detach($id, $params = null, $opts = null)
{
return $this->request('post', $this->buildPath('/v1/payment_methods/%s/detach', $id), $params, $opts);
}
/**
* Retrieves a PaymentMethod object.
*
* @param string $id
* @param null|array $params
* @param null|array|StripeUtilRequestOptions $opts
*
* @throws StripeExceptionApiErrorException if the request fails
*
* @return StripePaymentMethod
*/
public function retrieve($id, $params = null, $opts = null)
{
return $this->request('get', $this->buildPath('/v1/payment_methods/%s', $id), $params, $opts);
}
/**
* Updates a PaymentMethod object. A PaymentMethod must be attached a customer to
* be updated.
*
* @param string $id
* @param null|array $params
* @param null|array|StripeUtilRequestOptions $opts
*
* @throws StripeExceptionApiErrorException if the request fails
*
* @return StripePaymentMethod
*/
public function update($id, $params = null, $opts = null)
{
return $this->request('post', $this->buildPath('/v1/payment_methods/%s', $id), $params, $opts);
}
}