Платежи

Позволяет создавать, подтверждать, отменять платежи, а также получать информацию о них.

Создать платеж

Чтобы принять оплату, необходимо создать объект платежа — payments.CreatePaymentRequest. Он содержит всю необходимую информацию для проведения оплаты (сумму, валюту и статус). У платежа линейный жизненный цикл, он последовательно переходит из статуса в статус.

client.Payments.Create(&payments.CreatePaymentRequest{})

Получить список платежей

Запрос позволяет получить список платежей, отфильтрованный по заданным критериям, переданным в объекте payments.GetListPaymentRequest.

client.Payments.GetList(&payments.GetListPaymentRequest{})

Подтвердить платеж

Подтверждает вашу готовность принять платеж. После подтверждения платеж перейдет в статус Succeeded. Это значит, что вы можете выдать товар или оказать услугу пользователю.

Подтвердить можно только платеж в статусе WaitingForCapture и только в течение определенного времени (зависит от способа оплаты). Если вы не подтвердите платеж в отведенное время, он автоматически перейдет в статус Canceled, и деньги вернутся пользователю.

client.Payments.Capture("PAYMENT_ID", &payments.CapturePaymentRequest{})

Получить информацию о платеже

Запрос позволяет получить информацию о текущем состоянии платежа по его уникальному идентификатору.

client.Payments.Get("PAYMENT_ID")

Отменить незавершенный платеж

Отменяет платеж, находящийся в статусе WaitingForCapture. Отмена платежа значит, что вы не готовы выдать пользователю товар или оказать услугу. Как только вы отменяете платеж, мы начинаем возвращать деньги на счет плательщика. Для платежей банковскими картами, из кошелька ЮMoney или через SberPay отмена происходит мгновенно. Для остальных способов оплаты возврат может занимать до нескольких дней.

client.Payments.Cancel("PAYMENT_ID", &payments.CancelPaymentRequest{})