83 lines
2.9 KiB
PHP
Executable file
83 lines
2.9 KiB
PHP
Executable file
<?php
|
||
|
||
// File generated from our OpenAPI spec
|
||
|
||
namespace Stripe\Service;
|
||
|
||
class DisputeService extends \Stripe\Service\AbstractService
|
||
{
|
||
/**
|
||
* Returns a list of your disputes.
|
||
*
|
||
* @param null|array $params
|
||
* @param null|array|\Stripe\Util\RequestOptions $opts
|
||
*
|
||
* @throws \Stripe\Exception\ApiErrorException if the request fails
|
||
*
|
||
* @return \Stripe\Collection
|
||
*/
|
||
public function all($params = null, $opts = null)
|
||
{
|
||
return $this->requestCollection('get', '/v1/disputes', $params, $opts);
|
||
}
|
||
|
||
/**
|
||
* Closing the dispute for a charge indicates that you do not have any evidence to
|
||
* submit and are essentially dismissing the dispute, acknowledging it as lost.
|
||
*
|
||
* The status of the dispute will change from <code>needs_response</code> to
|
||
* <code>lost</code>. <em>Closing a dispute is irreversible</em>.
|
||
*
|
||
* @param string $id
|
||
* @param null|array $params
|
||
* @param null|array|\Stripe\Util\RequestOptions $opts
|
||
*
|
||
* @throws \Stripe\Exception\ApiErrorException if the request fails
|
||
*
|
||
* @return \Stripe\Dispute
|
||
*/
|
||
public function close($id, $params = null, $opts = null)
|
||
{
|
||
return $this->request('post', $this->buildPath('/v1/disputes/%s/close', $id), $params, $opts);
|
||
}
|
||
|
||
/**
|
||
* Retrieves the dispute with the given ID.
|
||
*
|
||
* @param string $id
|
||
* @param null|array $params
|
||
* @param null|array|\Stripe\Util\RequestOptions $opts
|
||
*
|
||
* @throws \Stripe\Exception\ApiErrorException if the request fails
|
||
*
|
||
* @return \Stripe\Dispute
|
||
*/
|
||
public function retrieve($id, $params = null, $opts = null)
|
||
{
|
||
return $this->request('get', $this->buildPath('/v1/disputes/%s', $id), $params, $opts);
|
||
}
|
||
|
||
/**
|
||
* When you get a dispute, contacting your customer is always the best first step.
|
||
* If that doesn’t work, you can submit evidence to help us resolve the dispute in
|
||
* your favor. You can do this in your <a
|
||
* href="https://dashboard.stripe.com/disputes">dashboard</a>, but if you prefer,
|
||
* you can use the API to submit evidence programmatically.
|
||
*
|
||
* Depending on your dispute type, different evidence fields will give you a better
|
||
* chance of winning your dispute. To figure out which evidence fields to provide,
|
||
* see our <a href="/docs/disputes/categories">guide to dispute types</a>.
|
||
*
|
||
* @param string $id
|
||
* @param null|array $params
|
||
* @param null|array|\Stripe\Util\RequestOptions $opts
|
||
*
|
||
* @throws \Stripe\Exception\ApiErrorException if the request fails
|
||
*
|
||
* @return \Stripe\Dispute
|
||
*/
|
||
public function update($id, $params = null, $opts = null)
|
||
{
|
||
return $this->request('post', $this->buildPath('/v1/disputes/%s', $id), $params, $opts);
|
||
}
|
||
}
|