mirror of
https://git.yoomoney.ru/scm/sdk/yookassa-sdk-php.git
synced 2026-09-14 20:06:16 +00:00
488 lines
20 KiB
Markdown
488 lines
20 KiB
Markdown
# [YooKassa API SDK](../home.md)
|
|
|
|
# Interface: PaymentInterface
|
|
### Namespace: [\YooKassa\Model\Payment](../namespaces/yookassa-model-payment.md)
|
|
---
|
|
**Summary:**
|
|
|
|
Interface PaymentInterface.
|
|
|
|
---
|
|
### Constants
|
|
| Visibility | Name | Flag | Summary |
|
|
| ----------:| ---- | ---- | ------- |
|
|
* [public MIN_LENGTH_ID](../classes/YooKassa-Model-Payment-PaymentInterface.md#constant_MIN_LENGTH_ID)
|
|
* [public MAX_LENGTH_ID](../classes/YooKassa-Model-Payment-PaymentInterface.md#constant_MAX_LENGTH_ID)
|
|
* [public MAX_LENGTH_DESCRIPTION](../classes/YooKassa-Model-Payment-PaymentInterface.md#constant_MAX_LENGTH_DESCRIPTION)
|
|
* [public MAX_LENGTH_MERCHANT_CUSTOMER_ID](../classes/YooKassa-Model-Payment-PaymentInterface.md#constant_MAX_LENGTH_MERCHANT_CUSTOMER_ID)
|
|
|
|
---
|
|
### Methods
|
|
| Visibility | Name | Flag | Summary |
|
|
| ----------:| ---- | ---- | ------- |
|
|
| public | [getAmount()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getAmount) | | Возвращает сумму. |
|
|
| public | [getAuthorizationDetails()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getAuthorizationDetails) | | Возвращает данные об авторизации платежа. |
|
|
| public | [getCancellationDetails()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getCancellationDetails) | | Возвращает комментарий к статусу canceled: кто отменил платеж и по какой причине. |
|
|
| public | [getCapturedAt()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getCapturedAt) | | Возвращает время подтверждения платежа магазином или null, если время не задано. |
|
|
| public | [getConfirmation()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getConfirmation) | | Возвращает способ подтверждения платежа. |
|
|
| public | [getCreatedAt()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getCreatedAt) | | Возвращает время создания заказа. |
|
|
| public | [getDeal()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getDeal) | | Возвращает сделку, в рамках которой нужно провести платеж. |
|
|
| public | [getExpiresAt()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getExpiresAt) | | Возвращает время до которого можно бесплатно отменить или подтвердить платеж, или null, если оно не задано. |
|
|
| public | [getId()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getId) | | Возвращает идентификатор платежа. |
|
|
| public | [getIncomeAmount()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getIncomeAmount) | | Возвращает сумму перечисляемая магазину за вычетом комиссий платежной системы.(только для успешных платежей). |
|
|
| public | [getInvoiceDetails()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getInvoiceDetails) | | Возвращает invoice_details. |
|
|
| public | [getMetadata()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getMetadata) | | Возвращает метаданные платежа установленные мерчантом |
|
|
| public | [getPaid()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getPaid) | | Проверяет, был ли уже оплачен заказ. |
|
|
| public | [getPaymentMethod()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getPaymentMethod) | | Возвращает используемый способ проведения платежа. |
|
|
| public | [getReceiptRegistration()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getReceiptRegistration) | | Возвращает состояние регистрации фискального чека. |
|
|
| public | [getRecipient()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getRecipient) | | Возвращает получателя платежа. |
|
|
| public | [getRefundable()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getRefundable) | | Возможность провести возврат по API. |
|
|
| public | [getRefundedAmount()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getRefundedAmount) | | Возвращает сумму возвращенных средств. |
|
|
| public | [getStatus()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getStatus) | | Возвращает состояние платежа. |
|
|
| public | [getTransfers()](../classes/YooKassa-Model-Payment-PaymentInterface.md#method_getTransfers) | | Возвращает данные о распределении платежа между магазинами. |
|
|
|
|
---
|
|
### Details
|
|
* File: [lib/Model/Payment/PaymentInterface.php](../../lib/Model/Payment/PaymentInterface.php)
|
|
* Package: \YooKassa\Model
|
|
* See Also:
|
|
* [](https://yookassa.ru/developers/api)
|
|
|
|
---
|
|
### Tags
|
|
| Tag | Version | Description |
|
|
| --- | ------- | ----------- |
|
|
| category | | Class |
|
|
| author | | cms@yoomoney.ru |
|
|
| property | | Идентификатор платежа |
|
|
| property | | Текущее состояние платежа |
|
|
| property | | Получатель платежа |
|
|
| property | | Сумма заказа |
|
|
| property | | Описание транзакции |
|
|
| property | | Способ проведения платежа |
|
|
| property | | Способ проведения платежа |
|
|
| property | | Время создания заказа |
|
|
| property | | Время создания заказа |
|
|
| property | | Время подтверждения платежа магазином |
|
|
| property | | Время подтверждения платежа магазином |
|
|
| property | | Время, до которого можно бесплатно отменить или подтвердить платеж |
|
|
| property | | Время, до которого можно бесплатно отменить или подтвердить платеж |
|
|
| property | | Способ подтверждения платежа |
|
|
| property | | Сумма возвращенных средств платежа |
|
|
| property | | Сумма возвращенных средств платежа |
|
|
| property | | Признак оплаты заказа |
|
|
| property | | Возможность провести возврат по API |
|
|
| property | | Состояние регистрации фискального чека |
|
|
| property | | Состояние регистрации фискального чека |
|
|
| property | | Метаданные платежа указанные мерчантом |
|
|
| property | | Признак тестовой операции |
|
|
| property | | Комментарий к отмене платежа |
|
|
| property | | Комментарий к отмене платежа |
|
|
| property | | Данные об авторизации платежа |
|
|
| property | | Данные об авторизации платежа |
|
|
| property | | Данные о распределении платежа между магазинами |
|
|
| property | | Сумма платежа, которую получит магазин |
|
|
| property | | Сумма платежа, которую получит магазин |
|
|
| property | | Данные о сделке, в составе которой проходит платеж |
|
|
| property | | Идентификатор покупателя в вашей системе, например электронная почта или номер телефона |
|
|
| property | | Идентификатор покупателя в вашей системе, например электронная почта или номер телефона |
|
|
| property | | Данные о выставленном счете, в рамках которого проведен платеж |
|
|
| property | | Данные о выставленном счете, в рамках которого проведен платеж |
|
|
|
|
---
|
|
## Constants
|
|
<a name="constant_MIN_LENGTH_ID" class="anchor"></a>
|
|
###### MIN_LENGTH_ID
|
|
```php
|
|
MIN_LENGTH_ID = 36 : int
|
|
```
|
|
|
|
|
|
<a name="constant_MAX_LENGTH_ID" class="anchor"></a>
|
|
###### MAX_LENGTH_ID
|
|
```php
|
|
MAX_LENGTH_ID = 36 : int
|
|
```
|
|
|
|
|
|
<a name="constant_MAX_LENGTH_DESCRIPTION" class="anchor"></a>
|
|
###### MAX_LENGTH_DESCRIPTION
|
|
Максимальная длина строки описания платежа
|
|
|
|
```php
|
|
MAX_LENGTH_DESCRIPTION = 128
|
|
```
|
|
|
|
|
|
<a name="constant_MAX_LENGTH_MERCHANT_CUSTOMER_ID" class="anchor"></a>
|
|
###### MAX_LENGTH_MERCHANT_CUSTOMER_ID
|
|
Максимальная длина строки идентификатора покупателя в вашей системе
|
|
|
|
```php
|
|
MAX_LENGTH_MERCHANT_CUSTOMER_ID = 200
|
|
```
|
|
|
|
|
|
|
|
---
|
|
## Methods
|
|
<a name="method_getId" class="anchor"></a>
|
|
#### public getId() : string|null
|
|
|
|
```php
|
|
public getId() : string|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает идентификатор платежа.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** string|null - Идентификатор платежа
|
|
|
|
|
|
<a name="method_getStatus" class="anchor"></a>
|
|
#### public getStatus() : string|null
|
|
|
|
```php
|
|
public getStatus() : string|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает состояние платежа.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** string|null - Текущее состояние платежа
|
|
|
|
|
|
<a name="method_getRecipient" class="anchor"></a>
|
|
#### public getRecipient() : null|\YooKassa\Model\Payment\RecipientInterface
|
|
|
|
```php
|
|
public getRecipient() : null|\YooKassa\Model\Payment\RecipientInterface
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает получателя платежа.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** null|\YooKassa\Model\Payment\RecipientInterface - Получатель платежа или null, если получатель не задан
|
|
|
|
|
|
<a name="method_getAmount" class="anchor"></a>
|
|
#### public getAmount() : \YooKassa\Model\AmountInterface|null
|
|
|
|
```php
|
|
public getAmount() : \YooKassa\Model\AmountInterface|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает сумму.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \YooKassa\Model\AmountInterface|null - Сумма платежа
|
|
|
|
|
|
<a name="method_getPaymentMethod" class="anchor"></a>
|
|
#### public getPaymentMethod() : \YooKassa\Model\Payment\PaymentMethod\AbstractPaymentMethod|null
|
|
|
|
```php
|
|
public getPaymentMethod() : \YooKassa\Model\Payment\PaymentMethod\AbstractPaymentMethod|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает используемый способ проведения платежа.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \YooKassa\Model\Payment\PaymentMethod\AbstractPaymentMethod|null - Способ проведения платежа
|
|
|
|
|
|
<a name="method_getCreatedAt" class="anchor"></a>
|
|
#### public getCreatedAt() : \DateTime|null
|
|
|
|
```php
|
|
public getCreatedAt() : \DateTime|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает время создания заказа.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \DateTime|null - Время создания заказа
|
|
|
|
|
|
<a name="method_getCapturedAt" class="anchor"></a>
|
|
#### public getCapturedAt() : null|\DateTime
|
|
|
|
```php
|
|
public getCapturedAt() : null|\DateTime
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает время подтверждения платежа магазином или null, если время не задано.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** null|\DateTime - Время подтверждения платежа магазином
|
|
|
|
|
|
<a name="method_getConfirmation" class="anchor"></a>
|
|
#### public getConfirmation() : \YooKassa\Model\Payment\Confirmation\AbstractConfirmation|null
|
|
|
|
```php
|
|
public getConfirmation() : \YooKassa\Model\Payment\Confirmation\AbstractConfirmation|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает способ подтверждения платежа.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \YooKassa\Model\Payment\Confirmation\AbstractConfirmation|null - Способ подтверждения платежа
|
|
|
|
|
|
<a name="method_getRefundedAmount" class="anchor"></a>
|
|
#### public getRefundedAmount() : \YooKassa\Model\AmountInterface|null
|
|
|
|
```php
|
|
public getRefundedAmount() : \YooKassa\Model\AmountInterface|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает сумму возвращенных средств.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \YooKassa\Model\AmountInterface|null - Сумма возвращенных средств платежа
|
|
|
|
|
|
<a name="method_getPaid" class="anchor"></a>
|
|
#### public getPaid() : bool
|
|
|
|
```php
|
|
public getPaid() : bool
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Проверяет, был ли уже оплачен заказ.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** bool - Признак оплаты заказа, true если заказ оплачен, false если нет
|
|
|
|
|
|
<a name="method_getRefundable" class="anchor"></a>
|
|
#### public getRefundable() : bool
|
|
|
|
```php
|
|
public getRefundable() : bool
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возможность провести возврат по API.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** bool - Возможность провести возврат по API
|
|
|
|
|
|
<a name="method_getReceiptRegistration" class="anchor"></a>
|
|
#### public getReceiptRegistration() : string|null
|
|
|
|
```php
|
|
public getReceiptRegistration() : string|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает состояние регистрации фискального чека.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** string|null - Состояние регистрации фискального чека
|
|
|
|
|
|
<a name="method_getMetadata" class="anchor"></a>
|
|
#### public getMetadata() : \YooKassa\Model\Metadata|null
|
|
|
|
```php
|
|
public getMetadata() : \YooKassa\Model\Metadata|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает метаданные платежа установленные мерчантом
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \YooKassa\Model\Metadata|null - Метаданные платежа указанные мерчантом
|
|
|
|
|
|
<a name="method_getExpiresAt" class="anchor"></a>
|
|
#### public getExpiresAt() : null|\DateTime
|
|
|
|
```php
|
|
public getExpiresAt() : null|\DateTime
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает время до которого можно бесплатно отменить или подтвердить платеж, или null, если оно не задано.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** null|\DateTime - Время, до которого можно бесплатно отменить или подтвердить платеж
|
|
|
|
|
|
<a name="method_getCancellationDetails" class="anchor"></a>
|
|
#### public getCancellationDetails() : null|\YooKassa\Model\CancellationDetailsInterface
|
|
|
|
```php
|
|
public getCancellationDetails() : null|\YooKassa\Model\CancellationDetailsInterface
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает комментарий к статусу canceled: кто отменил платеж и по какой причине.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** null|\YooKassa\Model\CancellationDetailsInterface - Комментарий к статусу canceled
|
|
|
|
|
|
<a name="method_getAuthorizationDetails" class="anchor"></a>
|
|
#### public getAuthorizationDetails() : null|\YooKassa\Model\Payment\AuthorizationDetailsInterface
|
|
|
|
```php
|
|
public getAuthorizationDetails() : null|\YooKassa\Model\Payment\AuthorizationDetailsInterface
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает данные об авторизации платежа.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** null|\YooKassa\Model\Payment\AuthorizationDetailsInterface - Данные об авторизации платежа
|
|
|
|
|
|
<a name="method_getTransfers" class="anchor"></a>
|
|
#### public getTransfers() : \YooKassa\Model\Payment\TransferInterface[]|\YooKassa\Common\ListObjectInterface
|
|
|
|
```php
|
|
public getTransfers() : \YooKassa\Model\Payment\TransferInterface[]|\YooKassa\Common\ListObjectInterface
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает данные о распределении платежа между магазинами.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \YooKassa\Model\Payment\TransferInterface[]|\YooKassa\Common\ListObjectInterface -
|
|
|
|
|
|
<a name="method_getIncomeAmount" class="anchor"></a>
|
|
#### public getIncomeAmount() : ?\YooKassa\Model\AmountInterface
|
|
|
|
```php
|
|
public getIncomeAmount() : ?\YooKassa\Model\AmountInterface
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает сумму перечисляемая магазину за вычетом комиссий платежной системы.(только для успешных платежей).
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** ?\YooKassa\Model\AmountInterface -
|
|
|
|
|
|
<a name="method_getDeal" class="anchor"></a>
|
|
#### public getDeal() : \YooKassa\Model\Deal\PaymentDealInfo|null
|
|
|
|
```php
|
|
public getDeal() : \YooKassa\Model\Deal\PaymentDealInfo|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает сделку, в рамках которой нужно провести платеж.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \YooKassa\Model\Deal\PaymentDealInfo|null - Сделка, в рамках которой нужно провести платеж
|
|
|
|
|
|
<a name="method_getInvoiceDetails" class="anchor"></a>
|
|
#### public getInvoiceDetails() : \YooKassa\Model\Payment\PaymentInvoiceDetails|null
|
|
|
|
```php
|
|
public getInvoiceDetails() : \YooKassa\Model\Payment\PaymentInvoiceDetails|null
|
|
```
|
|
|
|
**Summary**
|
|
|
|
Возвращает invoice_details.
|
|
|
|
**Details:**
|
|
* Inherited From: [\YooKassa\Model\Payment\PaymentInterface](../classes/YooKassa-Model-Payment-PaymentInterface.md)
|
|
|
|
**Returns:** \YooKassa\Model\Payment\PaymentInvoiceDetails|null -
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
### Top Namespaces
|
|
|
|
* [\YooKassa](../namespaces/yookassa.md)
|
|
|
|
---
|
|
|
|
### Reports
|
|
* [Errors - 0](../reports/errors.md)
|
|
* [Markers - 0](../reports/markers.md)
|
|
* [Deprecated - 43](../reports/deprecated.md)
|
|
|
|
---
|
|
|
|
This document was automatically generated from source code comments on 2026-08-13 using [phpDocumentor](http://www.phpdoc.org/)
|
|
|
|
© 2026 YooMoney |