34 KiB
YooKassa API SDK
Class: \YooKassa\Request\Refunds\CreateRefundRequest
Namespace: \YooKassa\Request\Refunds
Summary:
Класс объекта запроса для создания возврата
Examples
Пример использования билдера
// Создание запроса возврата через билдер
try {
$refundBuilder = \YooKassa\Request\Refunds\CreateRefundRequest::builder();
$refundBuilder
->setPaymentId('24b94598-000f-5000-9000-1b68e7b15f3f')
->setAmount(3500.00)
->setCurrency(\YooKassa\Model\CurrencyCode::RUB)
->setDescription('Не подошел цвет')
->setReceiptItems(array(
array(
'description' => 'Платок Gucci',
'quantity' => '1.00',
'amount' => array(
'value' => '3000.00',
'currency' => 'RUB',
),
'vat_code' => 2,
'payment_mode' => 'full_payment',
'payment_subject' => 'commodity',
),
))
->setReceiptEmail('john.doe@merchant.com')
->setTaxSystemCode(1);
// Создаем объект запроса
$request = $refundBuilder->build();
// Можно изменить данные, если нужно
$request->setDescription('Не подошел цвет и размер');
$idempotenceKey = uniqid('', true);
$response = $client->createRefund($request, $idempotenceKey);
} catch (Exception $e) {
$response = $e;
}
Constants
- No constants found
Properties
| Visibility | Name | Flag | Summary |
|---|---|---|---|
| public | $amount | Сумма возврата | |
| public | $amount | Сумма | |
| public | $description | Комментарий к операции возврата, основание для возврата средств покупателю. | |
| public | $paymentId | Айди платежа для которого создаётся возврат | |
| public | $receipt | Инстанс чека или null | |
| public | $receipt | Данные фискального чека 54-ФЗ | |
| public | $sources | Информация о распределении денег — сколько и в какой магазин нужно перевести | |
| public | $transfers | Данные о распределении платежа между магазинами |
Methods
| Visibility | Name | Flag | Summary |
|---|---|---|---|
| public | __construct() | AbstractObject constructor. | |
| public | __get() | Возвращает значение свойства | |
| public | __isset() | Проверяет наличие свойства | |
| public | __set() | Устанавливает значение свойства | |
| public | __unset() | Удаляет свойство | |
| public | builder() | Возвращает билдер объектов текущего типа | |
| public | clearValidationError() | Очищает статус валидации текущего запроса | |
| public | fromArray() | Устанавливает значения свойств текущего объекта из массива | |
| public | getAmount() | Возвращает сумму оплаты | |
| public | getDescription() | Возвращает комментарий к возврату или null, если комментарий не задан | |
| public | getLastValidationError() | Возвращает последнюю ошибку валидации | |
| public | getPaymentId() | Возвращает идентификатор платежа для которого создаётся возврат средств | |
| public | getReceipt() | Возвращает чек, если он есть | |
| public | getSources() | Возвращает информацию о распределении денег — сколько и в какой магазин нужно перевести | |
| public | getTransfers() | Возвращает данные о распределении денег — сколько и в какой магазин нужно перевести. | |
| public | hasAmount() | Проверяет была ли установлена сумма оплаты | |
| public | hasDescription() | Проверяет задан ли комментарий к создаваемому возврату | |
| public | hasReceipt() | Проверяет наличие чека | |
| public | hasSources() | Проверяет наличие информации о распределении денег | |
| public | hasTransfers() | Проверяет наличие данных о распределении денег | |
| public | jsonSerialize() | Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации | |
| public | offsetExists() | Проверяет наличие свойства | |
| public | offsetGet() | Возвращает значение свойства | |
| public | offsetSet() | Устанавливает значение свойства | |
| public | offsetUnset() | Удаляет свойство | |
| public | removeReceipt() | Удаляет чек из запроса | |
| public | setAmount() | Устанавливает сумму оплаты | |
| public | setDescription() | Устанавливает комментарий к возврату | |
| public | setPaymentId() | Устанавливает идентификатор платежа для которого создаётся возврат | |
| public | setReceipt() | Устанавливает чек | |
| public | setSources() | Устанавливает sources (массив распределения денег между магазинами) | |
| public | setTransfers() | Устанавливает transfers (массив распределения денег между магазинами) | |
| public | toArray() | Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации Является алиасом метода AbstractObject::jsonSerialize() | |
| public | validate() | Валидирует текущий объект запроса | |
| protected | getUnknownProperties() | Возвращает массив свойств которые не существуют, но были заданы у объекта | |
| protected | setValidationError() | Устанавливает ошибку валидации |
Details
- File: lib/Request/Refunds/CreateRefundRequest.php
- Package: Default
- Class Hierarchy:
- \YooKassa\Common\AbstractObject
- \YooKassa\Common\AbstractRequest
- \YooKassa\Common\AbstractPaymentRequest
- \YooKassa\Request\Refunds\CreateRefundRequest
- Implements:
Properties
public $amount : \YooKassa\Model\AmountInterface
Description
Сумма возврата
Type: AmountInterface
Details:
public $amount : \YooKassa\Model\AmountInterface
Description
Сумма
Type: AmountInterface
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
public $description : string
Description
Комментарий к операции возврата, основание для возврата средств покупателю.
Type: string
Details:
public $paymentId : string
Description
Айди платежа для которого создаётся возврат
Type: string
Details:
public $receipt : \YooKassa\Model\ReceiptInterface|null
Description
Инстанс чека или null
Type: ReceiptInterface|null
Details:
public $receipt : \YooKassa\Model\ReceiptInterface
Description
Данные фискального чека 54-ФЗ
Type: ReceiptInterface
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
public $sources : \YooKassa\Model\SourceInterface[]|null
Description
Информация о распределении денег — сколько и в какой магазин нужно перевести
Type: SourceInterface[]|null
Details:
public $transfers : \YooKassa\Model\TransferInterface[]
Description
Данные о распределении платежа между магазинами
Type: TransferInterface[]
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Methods
public __construct() : mixed
public __construct(array $data = array()) : mixed
Summary
AbstractObject constructor.
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
array |
data |
Returns: mixed -
public __get() : mixed
public __get(string $propertyName) : mixed
Summary
Возвращает значение свойства
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
string |
propertyName | Имя свойства |
Returns: mixed - Значение свойства
public __isset() : bool
public __isset(string $propertyName) : bool
Summary
Проверяет наличие свойства
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
string |
propertyName | Имя проверяемого свойства |
Returns: bool - True если свойство имеется, false если нет
public __set() : mixed
public __set(string $propertyName, mixed $value) : mixed
Summary
Устанавливает значение свойства
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
string |
propertyName | Имя свойства |
mixed |
value | Значение свойства |
Returns: mixed -
public __unset() : mixed
public __unset(string $propertyName) : mixed
Summary
Удаляет свойство
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
string |
propertyName | Имя удаляемого свойства |
Returns: mixed -
public builder() : \YooKassa\Request\Refunds\CreateRefundRequestBuilder
Static public builder() : \YooKassa\Request\Refunds\CreateRefundRequestBuilder
Summary
Возвращает билдер объектов текущего типа
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Returns: \YooKassa\Request\Refunds\CreateRefundRequestBuilder - Инстанс билдера запрсов
public clearValidationError() : mixed
public clearValidationError() : mixed
Summary
Очищает статус валидации текущего запроса
Details:
- Inherited From: \YooKassa\Common\AbstractRequest
Returns: mixed -
public fromArray() : mixed
public fromArray(array|\Traversable $sourceArray) : mixed
Summary
Устанавливает значения свойств текущего объекта из массива
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
array OR \Traversable |
sourceArray | Ассоциативный массив с настройками |
Returns: mixed -
public getAmount() : \YooKassa\Model\AmountInterface
public getAmount() : \YooKassa\Model\AmountInterface
Summary
Возвращает сумму оплаты
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Returns: \YooKassa\Model\AmountInterface - Сумма оплаты
public getDescription() : string
public getDescription() : string
Summary
Возвращает комментарий к возврату или null, если комментарий не задан
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Returns: string - Комментарий к операции возврата, основание для возврата средств покупателю.
public getLastValidationError() : string
public getLastValidationError() : string
Summary
Возвращает последнюю ошибку валидации
Details:
- Inherited From: \YooKassa\Common\AbstractRequest
Returns: string - Последняя произошедшая ошибка валидации
public getPaymentId() : string
public getPaymentId() : string
Summary
Возвращает идентификатор платежа для которого создаётся возврат средств
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Returns: string - Идентификатор платежа для которого создаётся возврат
public getReceipt() : \YooKassa\Model\ReceiptInterface|null
public getReceipt() : \YooKassa\Model\ReceiptInterface|null
Summary
Возвращает чек, если он есть
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Returns: \YooKassa\Model\ReceiptInterface|null - Данные фискального чека 54-ФЗ или null если чека нет
public getSources() : \YooKassa\Model\SourceInterface[]
public getSources() : \YooKassa\Model\SourceInterface[]
Summary
Возвращает информацию о распределении денег — сколько и в какой магазин нужно перевести
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Returns: \YooKassa\Model\SourceInterface[] - Информация о распределении денег
public getTransfers() : \YooKassa\Model\TransferInterface[]
public getTransfers() : \YooKassa\Model\TransferInterface[]
Summary
Возвращает данные о распределении денег — сколько и в какой магазин нужно перевести.
Description
Присутствует, если вы используете решение ЮKassa для платформ. (https://yookassa.ru/developers/special-solutions/checkout-for-platforms/basics)
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Returns: \YooKassa\Model\TransferInterface[] - Данные о распределении денег
public hasAmount() : bool
public hasAmount() : bool
Summary
Проверяет была ли установлена сумма оплаты
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Returns: bool - True если сумма оплаты была установлена, false если нет
public hasDescription() : bool
public hasDescription() : bool
Summary
Проверяет задан ли комментарий к создаваемому возврату
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Returns: bool - True если комментарий установлен, false если нет
public hasReceipt() : bool
public hasReceipt() : bool
Summary
Проверяет наличие чека
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Returns: bool - True если чек есть, false если нет
public hasSources() : bool
public hasSources() : bool
Summary
Проверяет наличие информации о распределении денег
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Returns: bool -
public hasTransfers() : bool
public hasTransfers() : bool
Summary
Проверяет наличие данных о распределении денег
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Returns: bool -
public jsonSerialize() : array
public jsonSerialize() : array
Summary
Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Returns: array - Ассоциативный массив со свойствами текущего объекта
public offsetExists() : bool
public offsetExists(string $offset) : bool
Summary
Проверяет наличие свойства
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
string |
offset | Имя проверяемого свойства |
Returns: bool - True если свойство имеется, false если нет
public offsetGet() : mixed
public offsetGet(string $offset) : mixed
Summary
Возвращает значение свойства
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
string |
offset | Имя свойства |
Returns: mixed - Значение свойства
public offsetSet() : mixed
public offsetSet(string $offset, mixed $value) : mixed
Summary
Устанавливает значение свойства
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
string |
offset | Имя свойства |
mixed |
value | Значение свойства |
Returns: mixed -
public offsetUnset() : mixed
public offsetUnset(string $offset) : mixed
Summary
Удаляет свойство
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
string |
offset | Имя удаляемого свойства |
Returns: mixed -
public removeReceipt() : mixed
public removeReceipt() : mixed
Summary
Удаляет чек из запроса
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Returns: mixed -
public setAmount() : mixed
public setAmount(\YooKassa\Model\AmountInterface $value) : mixed
Summary
Устанавливает сумму оплаты
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Parameters:
| Type | Name | Description |
|---|---|---|
\YooKassa\Model\AmountInterface |
value | Сумма оплаты |
Returns: mixed -
public setDescription() : mixed
public setDescription(string $value) : mixed
Summary
Устанавливает комментарий к возврату
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Parameters:
| Type | Name | Description |
|---|---|---|
string |
value | Комментарий к операции возврата, основание для возврата средств покупателю |
Throws:
| Type | Description |
|---|---|
| \YooKassa\Common\Exceptions\InvalidPropertyValueTypeException | Выбрасывается если была передана не строка |
Returns: mixed -
public setPaymentId() : mixed
public setPaymentId(string $value) : mixed
Summary
Устанавливает идентификатор платежа для которого создаётся возврат
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Parameters:
| Type | Name | Description |
|---|---|---|
string |
value | Идентификатор платежа |
Throws:
| Type | Description |
|---|---|
| \YooKassa\Common\Exceptions\EmptyPropertyValueException | Выбрасывается если передано пустое значение идентификатора платежа |
| \YooKassa\Common\Exceptions\InvalidPropertyValueException | Выбрасывается если переданное значение является строкой, но не является валидным значением идентификатора платежа |
| \YooKassa\Common\Exceptions\InvalidPropertyValueTypeException | Выбрасывается если передано значение не валидного типа |
Returns: mixed -
public setReceipt() : mixed
public setReceipt(\YooKassa\Model\ReceiptInterface|null $value) : mixed
Summary
Устанавливает чек
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Parameters:
| Type | Name | Description |
|---|---|---|
\YooKassa\Model\ReceiptInterface OR null |
value | Инстанс чека или null для удаления информации о чеке |
Throws:
| Type | Description |
|---|---|
| \YooKassa\Common\Exceptions\InvalidPropertyValueTypeException | Выбрасывается если передан не инстанс класса чека и не null |
Returns: mixed -
public setSources() : mixed
public setSources(\YooKassa\Model\SourceInterface[]|array $value) : mixed
Summary
Устанавливает sources (массив распределения денег между магазинами)
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Parameters:
| Type | Name | Description |
|---|---|---|
\YooKassa\Model\SourceInterface[] OR array |
value | Массив распределения денег между магазинами |
Returns: mixed -
public setTransfers() : mixed
public setTransfers(\YooKassa\Model\TransferInterface[]|array|null $value) : mixed
Summary
Устанавливает transfers (массив распределения денег между магазинами)
Details:
- Inherited From: \YooKassa\Common\AbstractPaymentRequest
Parameters:
| Type | Name | Description |
|---|---|---|
\YooKassa\Model\TransferInterface[] OR array OR null |
value |
Returns: mixed -
public toArray() : array
public toArray() : array
Summary
Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации Является алиасом метода AbstractObject::jsonSerialize()
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Returns: array - Ассоциативный массив со свойствами текущего объекта
public validate() : bool
public validate() : bool
Summary
Валидирует текущий объект запроса
Details:
- Inherited From: \YooKassa\Request\Refunds\CreateRefundRequest
Returns: bool - True если текущий объект запроса валиден, false если нет
protected getUnknownProperties() : array
protected getUnknownProperties() : array
Summary
Возвращает массив свойств которые не существуют, но были заданы у объекта
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Returns: array - Ассоциативный массив с не существующими у текущего объекта свойствами
protected setValidationError() : mixed
protected setValidationError(string $value) : mixed
Summary
Устанавливает ошибку валидации
Details:
- Inherited From: \YooKassa\Common\AbstractRequest
Parameters:
| Type | Name | Description |
|---|---|---|
string |
value | Ошибка, произошедшая при валидации объекта |
Returns: mixed -
Top Namespaces
Reports
This document was automatically generated from source code comments on 2021-09-17 using phpDocumentor
© 2021 YooMoney