18 KiB
YooKassa API SDK
Class: \YooKassa\Model\Notification\NotificationWaitingForCapture
Namespace: \YooKassa\Model\Notification
Summary:
Класс объекта, присылаемого API при изменении статуса платежа на "waiting_for_capture"
Description:
При создании платежа с флагом "capture" равным false, после того как клиент проводит платёж, от API на эндпоинт, указанный в настройках API посылается уведомление о том, что платёж теперь может быть проведён. В классе описана структура такого объекта для магазинов, которые получают уведомления на HTTPS endpoint.
Examples
03-notification.php 3 Пример скрипта обработки уведомления
Constants
- No constants found
Properties
| Visibility | Name | Flag | Summary |
|---|---|---|---|
| public | $event | Тип события | |
| public | $object | Объект с информацией о платеже, который можно подтвердить или отменить | |
| public | $type | Тип уведомления в виде строки |
Methods
| Visibility | Name | Flag | Summary |
|---|---|---|---|
| public | __construct() | Конструктор объекта нотификации о возможности подтверждения платежа | |
| public | __get() | Возвращает значение свойства | |
| public | __isset() | Проверяет наличие свойства | |
| public | __set() | Устанавливает значение свойства | |
| public | __unset() | Удаляет свойство | |
| public | fromArray() | Устанавливает значения свойств текущего объекта из массива | |
| public | getEvent() | Возвращает тип события | |
| public | getObject() | Возвращает объект с информацией о платеже, уведомление о котором хранится в текущем объекте | |
| public | getType() | Возвращает тип уведомления | |
| public | jsonSerialize() | ||
| public | offsetExists() | ||
| public | offsetGet() | ||
| public | offsetSet() | ||
| public | offsetUnset() | ||
| public | toArray() | Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации Является алиасом метода AbstractObject::jsonSerialize() | |
| protected | getUnknownProperties() | Возвращает массив свойств которые не существуют, но были заданы у объекта | |
| protected | setEvent() | Устанавливает тип события | |
| protected | setType() | Устанавливает тип уведомления |
Details
- File: lib/Model/Notification/NotificationWaitingForCapture.php
- Package: YooKassa
- Class Hierarchy:
- \YooKassa\Common\AbstractObject
- \YooKassa\Model\Notification\AbstractNotification
- \YooKassa\Model\Notification\NotificationWaitingForCapture
Properties
public $event : string
Description
Тип события
Type: string
Details:
- Inherited From: \YooKassa\Model\Notification\AbstractNotification
public $object : \YooKassa\Model\PaymentInterface
Description
Объект с информацией о платеже, который можно подтвердить или отменить
Type: PaymentInterface
Details:
public $type : string
Description
Тип уведомления в виде строки
Type: string
Details:
- Inherited From: \YooKassa\Model\Notification\AbstractNotification
Methods
public __construct() : mixed
public __construct(array $source) : mixed
Summary
Конструктор объекта нотификации о возможности подтверждения платежа
Description
Инициализирует текущий объект из ассоциативного массива, который просто путём JSON десериализации получен из тела пришедшего запроса. При конструировании проверяется валидность типа передаваемого уведомления, если передать уведомление не того типа, будет сгенерировано исключение типа {@link}
Details:
- Inherited From: \YooKassa\Model\Notification\NotificationWaitingForCapture
Parameters:
| Type | Name | Description |
|---|---|---|
array |
source | Ассоциативный массив с информацией об уведомлении |
Throws:
| Type | Description |
|---|---|
| \YooKassa\Common\Exceptions\InvalidPropertyValueException | Генерируется если значение типа нотификации или события не равны "notification" и "payment.waiting_for_capture" соответственно, что может говорить о том, что переданные в конструктор данные не являются уведомлением нужного типа. |
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 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 getEvent() : string
public getEvent() : string
Summary
Возвращает тип события
Description
Тип события - одна из констант, указанных в перечислении {@link}.
Details:
- Inherited From: \YooKassa\Model\Notification\AbstractNotification
Returns: string - Тип события
public getObject() : \YooKassa\Model\PaymentInterface
public getObject() : \YooKassa\Model\PaymentInterface
Summary
Возвращает объект с информацией о платеже, уведомление о котором хранится в текущем объекте
Description
Так как нотификация может быть сгенерирована и поставлена в очередь на отправку гораздо раньше, чем она будет получена на сайте, то опираться на статус пришедшего платежа не стоит, лучше запросить текущую информацию о платеже у API.
Details:
- Inherited From: \YooKassa\Model\Notification\NotificationWaitingForCapture
Returns: \YooKassa\Model\PaymentInterface - Объект с информацией о платеже, который можно подтвердить или отменить
public getType() : string
public getType() : string
Summary
Возвращает тип уведомления
Description
Тип уведомления - одна из констант, указанных в перечислении {@link}.
Details:
- Inherited From: \YooKassa\Model\Notification\AbstractNotification
Returns: string - Тип уведомления в виде строки
public jsonSerialize() : mixed
public jsonSerialize() : mixed
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Returns: mixed -
public offsetExists() : mixed
public offsetExists(mixed $offset) : mixed
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
mixed |
offset |
Returns: mixed -
public offsetGet() : mixed
public offsetGet(mixed $offset) : mixed
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
mixed |
offset |
Returns: mixed -
public offsetSet() : mixed
public offsetSet(mixed $offset, mixed $value) : mixed
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
mixed |
offset | |
mixed |
value |
Returns: mixed -
public offsetUnset() : mixed
public offsetUnset(mixed $offset) : mixed
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Parameters:
| Type | Name | Description |
|---|---|---|
mixed |
offset |
Returns: mixed -
public toArray() : array
public toArray() : array
Summary
Возвращает ассоциативный массив со свойствами текущего объекта для его дальнейшей JSON сериализации Является алиасом метода AbstractObject::jsonSerialize()
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Returns: array - Ассоциативный массив со свойствами текущего объекта
protected getUnknownProperties() : array
protected getUnknownProperties() : array
Summary
Возвращает массив свойств которые не существуют, но были заданы у объекта
Details:
- Inherited From: \YooKassa\Common\AbstractObject
Returns: array - Ассоциативный массив с не существующими у текущего объекта свойствами
protected setEvent() : mixed
protected setEvent(string $value) : mixed
Summary
Устанавливает тип события
Details:
- Inherited From: \YooKassa\Model\Notification\AbstractNotification
Parameters:
| Type | Name | Description |
|---|---|---|
string |
value | Тип события |
Throws:
| Type | Description |
|---|---|
| \YooKassa\Common\Exceptions\EmptyPropertyValueException | Выбрасывается если в качестве значения было передано пустое значение |
| \YooKassa\Common\Exceptions\InvalidPropertyValueException | Выбрасывается если переданное значение не найдено в перечислении типов событий |
| \YooKassa\Common\Exceptions\InvalidPropertyValueTypeException | Выбрасывается если переданное значение не является строкой |
Returns: mixed -
protected setType() : mixed
protected setType(string $value) : mixed
Summary
Устанавливает тип уведомления
Details:
- Inherited From: \YooKassa\Model\Notification\AbstractNotification
Parameters:
| Type | Name | Description |
|---|---|---|
string |
value | Тип уведомления |
Throws:
| Type | Description |
|---|---|
| \YooKassa\Common\Exceptions\EmptyPropertyValueException | Выбрасывается если в качестве значения было передано пустое значение |
| \YooKassa\Common\Exceptions\InvalidPropertyValueException | Выбрасывается если переданное значение не найдено в перечислении типов нотификаций |
| \YooKassa\Common\Exceptions\InvalidPropertyValueTypeException | Выбрасывается если переданное значение не является строкой |
Returns: mixed -
Top Namespaces
Reports
This document was automatically generated from source code comments on 2023-04-06 using phpDocumentor
© 2023 YooMoney