Files
yookassa-sdk-php/docs/classes/YooKassa-Request-Payments-AbstractPaymentRequestBuilder.md
Евгений Ю. Лозный 260d13f890 Добавлен прием платежей через Alfa Pay. Добавлен новый тип ошибки RuleViolationError
Добавлены нулевые привязки по СБП
Добавлена причина отмены возвратов `payment_expired`
2026-06-29 17:46:40 +03:00

18 KiB

YooKassa API SDK

Abstract Class: \YooKassa\Request\Payments\AbstractPaymentRequestBuilder

Namespace: \YooKassa\Request\Payments


Summary:

Класс, представляющий модель AbstractPaymentRequestBuilder.

Description:

Базовый класс билдера объекта платежного запроса, передаваемого в методы клиента API.


Constants

  • No constants found

Properties

Visibility Name Flag Summary
protected $amount Сумма
protected $currentObject Инстанс собираемого запроса.
protected $receipt Объект с информацией о чеке

Methods

Visibility Name Flag Summary
public __construct() Конструктор, инициализирует пустой запрос, который в будущем начнём собирать.
public addReceiptItem() Добавляет в чек товар
public addReceiptShipping() Добавляет в чек доставку товара.
public addTransfer() Добавляет трансфер.
public build() Строит запрос, валидирует его и возвращает, если все прошло нормально.
public setAmount() Устанавливает сумму.
public setCurrency() Устанавливает валюту в которой будет происходить подтверждение оплаты заказа.
public setOptions() Устанавливает свойства запроса из массива.
public setReceipt() Устанавливает чек.
public setReceiptEmail() Устанавливает адрес электронной почты получателя чека.
public setReceiptItems() Устанавливает список товаров для создания чека.
public setReceiptPhone() Устанавливает телефон получателя чека.
public setTaxSystemCode() Устанавливает код системы налогообложения.
public setTransfers() Устанавливает трансферы.
protected initCurrentObject() Инициализирует пустой запрос

Details


Tags

Tag Version Description
category Class
author cms@yoomoney.ru

Properties

protected $amount : ?\YooKassa\Model\MonetaryAmount


Summary

Сумма

Type: MonetaryAmount

Details:

protected $currentObject : ?\YooKassa\Common\AbstractRequestInterface


Summary

Инстанс собираемого запроса.

Type: AbstractRequestInterface

Details:

protected $receipt : ?\YooKassa\Model\Receipt\Receipt


Summary

Объект с информацией о чеке

Type: Receipt

Details:


Methods

public __construct() : mixed

public __construct() : mixed

Summary

Конструктор, инициализирует пустой запрос, который в будущем начнём собирать.

Details:

Returns: mixed -

public addReceiptItem() : self

public addReceiptItem(string $title, string $price, float $quantity, int $vatCode, null|string $paymentMode = null, null|string $paymentSubject = null, null|mixed $productCode = null, null|mixed $countryOfOriginCode = null, null|mixed $customsDeclarationNumber = null, null|mixed $excise = null) : self

Summary

Добавляет в чек товар

Details:

Parameters:
Type Name Description
string title Название или описание товара
string price Цена товара в валюте, заданной в заказе
float quantity Количество товара
int vatCode Ставка НДС
null OR string paymentMode значение перечисления PaymentMode
null OR string paymentSubject значение перечисления PaymentSubject
null OR mixed productCode
null OR mixed countryOfOriginCode
null OR mixed customsDeclarationNumber
null OR mixed excise

Returns: self - Инстанс билдера запросов

public addReceiptShipping() : self

public addReceiptShipping(string $title, string $price, int $vatCode, null|string $paymentMode = null, null|string $paymentSubject = null) : self

Summary

Добавляет в чек доставку товара.

Details:

Parameters:
Type Name Description
string title Название доставки в чеке
string price Стоимость доставки
int vatCode Ставка НДС
null OR string paymentMode значение перечисления PaymentMode
null OR string paymentSubject значение перечисления PaymentSubject

Returns: self - Инстанс билдера запросов

public addTransfer() : self

public addTransfer(array|\YooKassa\Request\Payments\TransferDataInterface $value) : self

Summary

Добавляет трансфер.

Details:

Parameters:
Type Name Description
array OR \YooKassa\Request\Payments\TransferDataInterface value Трансфер

Returns: self - Инстанс билдера запросов

public build() : \YooKassa\Common\AbstractRequestInterface

public build(?array $options = null) : \YooKassa\Common\AbstractRequestInterface

Summary

Строит запрос, валидирует его и возвращает, если все прошло нормально.

Details:

Parameters:
Type Name Description
?array options Массив свойств запроса, если нужно их установить перед сборкой

Returns: \YooKassa\Common\AbstractRequestInterface - Инстанс собранного запроса

public setAmount() : self

public setAmount(\YooKassa\Model\AmountInterface|array|\YooKassa\Request\Payments\numeric $value, string|null $currency = null) : self

Summary

Устанавливает сумму.

Details:

Parameters:
Type Name Description
\YooKassa\Model\AmountInterface OR array OR \YooKassa\Request\Payments\numeric value Сумма оплаты
string OR null currency Валюта

Returns: self - Инстанс билдера запросов

public setCurrency() : self

public setCurrency(string $value) : self

Summary

Устанавливает валюту в которой будет происходить подтверждение оплаты заказа.

Details:

Parameters:
Type Name Description
string value Валюта в которой подтверждается оплата

Returns: self - Инстанс билдера запросов

public setOptions() : \YooKassa\Common\AbstractRequestBuilder

public setOptions(iterable|null $options) : \YooKassa\Common\AbstractRequestBuilder

Summary

Устанавливает свойства запроса из массива.

Details:

Parameters:
Type Name Description
iterable OR null options Массив свойств запроса
Throws:
Type Description
\InvalidArgumentException Выбрасывается если аргумент не массив и не итерируемый объект
\YooKassa\Common\Exceptions\InvalidPropertyException Выбрасывается если не удалось установить один из параметров, переданных в массиве настроек

Returns: \YooKassa\Common\AbstractRequestBuilder - Инстанс текущего билдера запросов

public setReceipt() : self

public setReceipt(array|\YooKassa\Model\Receipt\ReceiptInterface $value) : self

Summary

Устанавливает чек.

Details:

Parameters:
Type Name Description
array OR \YooKassa\Model\Receipt\ReceiptInterface value Инстанс чека или ассоциативный массив с данными чека
Throws:
Type Description
\YooKassa\Common\Exceptions\InvalidPropertyValueTypeException Генерируется если было передано значение невалидного типа

Returns: self - Инстанс билдера запросов

public setReceiptEmail() : self

public setReceiptEmail(string|null $value) : self

Summary

Устанавливает адрес электронной почты получателя чека.

Details:

Parameters:
Type Name Description
string OR null value Email получателя чека

Returns: self - Инстанс билдера запросов

public setReceiptItems() : self

public setReceiptItems(array $value = []) : self

Summary

Устанавливает список товаров для создания чека.

Details:

Parameters:
Type Name Description
array value Массив товаров в заказе
Throws:
Type Description
\YooKassa\Common\Exceptions\InvalidPropertyValueException Выбрасывается если хотя бы один из товаров имеет неверную структуру

Returns: self - Инстанс билдера запросов

public setReceiptPhone() : self

public setReceiptPhone(string|null $value) : self

Summary

Устанавливает телефон получателя чека.

Details:

Parameters:
Type Name Description
string OR null value Телефон получателя чека

Returns: self - Инстанс билдера запросов

public setTaxSystemCode() : self

public setTaxSystemCode(int|null $value) : self

Summary

Устанавливает код системы налогообложения.

Details:

Parameters:
Type Name Description
int OR null value Код системы налогообложения. Число 1-6.

Returns: self - Инстанс билдера запросов

public setTransfers() : self

public setTransfers(array|\YooKassa\Request\Payments\TransferDataInterface[]|\YooKassa\Common\ListObjectInterface $value) : self

Summary

Устанавливает трансферы.

Details:

Parameters:
Type Name Description
array OR \YooKassa\Request\Payments\TransferDataInterface[] OR \YooKassa\Common\ListObjectInterface value Массив трансферов

Returns: self - Инстанс билдера запросов

protected initCurrentObject() : \YooKassa\Common\AbstractRequestInterface|null

protected initCurrentObject() : \YooKassa\Common\AbstractRequestInterface|null

Summary

Инициализирует пустой запрос

Details:

Returns: \YooKassa\Common\AbstractRequestInterface|null -


Top Namespaces


Reports


This document was automatically generated from source code comments on 2026-06-29 using phpDocumentor

© 2026 YooMoney