ru.bitel.bgbilling.modules.qiwi.server.bean

## Class QiwiSoap

- java.lang.Object
- - ru.bitel.bgbilling.modules.qiwi.server.bean.AbstractQiwiProtocol
  - - ru.bitel.bgbilling.modules.qiwi.server.bean.QiwiSoap

-     public class QiwiSoap
      extends AbstractQiwiProtocol

  Реализация SOAP-версии протокола сервиса Qiwi. По данным Qiwi SOAP-версия является устаревшей и используется для обратной совместимости.

- - ### Nested Class Summary

    - ### Nested classes/interfaces inherited from class ru.bitel.bgbilling.modules.qiwi.server.bean.AbstractQiwiProtocol

      `AbstractQiwiProtocol.QiwiResultCode`

  - ### Field Summary

    - ### Fields inherited from class ru.bitel.bgbilling.modules.qiwi.server.bean.AbstractQiwiProtocol

      `connection, contractManager, moduleId, moduleSetup`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `QiwiSoap(java.sql.Connection connection, int moduleId, ModuleSetup moduleSetup)`

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `java.lang.String` | `beginTransaction(int contractId, java.lang.String phone, java.math.BigDecimal sum, java.lang.String successUrl, java.lang.String failUrl)` Метод выставления счета абоненту из ЛК биллинга.
    `void` | `cancelTransaction(Transaction transaction)` Отмена НЕОПЛАЧЕННОГО выставленного счета.
    `void` | `checkRefundStatus(Transaction transaction)`
    `void` | `checkTransaction(Transaction transaction)` Проверка текущего состояния транзакции на сервере Qiwi.
    `void` | `refundTransaction(Transaction transaction)` Возврат средств (полный или частичный) по оплаченному счету.

    - ### Methods inherited from class ru.bitel.bgbilling.modules.qiwi.server.bean.AbstractQiwiProtocol

      `addPayment`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

    - #### QiwiSoap

          public QiwiSoap(java.sql.Connection connection,
                          int moduleId,
                          ModuleSetup moduleSetup)

  - ### Method Detail

    - #### beginTransaction

          public java.lang.String beginTransaction(int contractId,
                                                   java.lang.String phone,
                                                   java.math.BigDecimal sum,
                                                   java.lang.String successUrl,
                                                   java.lang.String failUrl)
                                            throws ru.bitel.bgbilling.common.BGException

      Description copied from class: `AbstractQiwiProtocol`
      Метод выставления счета абоненту из ЛК биллинга. Метод возвращет url, на который должен быть перенаправлен абонент после выставления счета.
      Specified by:
        `beginTransaction` in class `AbstractQiwiProtocol`
      Parameters:
        `contractId` - код договора
        `phone` - номер телефона абонента в формате 7xxxxxxxxxx
        `sum` - сумма счета
        `successUrl` - url, куда будет перенаправлен абонент после успешной оплаты. Настраивается в конфигурации модуля, либо приходит в запросе от нового ЛК.
        `failUrl` - url, куда будет перенаправлен абонент в случае неудачной оплаты. Настраивается в конфигурации модуля, либо приходит в запросе от нового ЛК.
      Returns:
        url, на который будет перенаправлен абонент после успешного выставления счета
      Throws:
        `ru.bitel.bgbilling.common.BGException`

    - #### checkTransaction

          public void checkTransaction(Transaction transaction)
                                throws ru.bitel.bgbilling.common.BGException

      Description copied from class: `AbstractQiwiProtocol`
      Проверка текущего состояния транзакции на сервере Qiwi.
      Specified by:
        `checkTransaction` in class `AbstractQiwiProtocol`
      Parameters:
        `transaction` - экземпляр транзакции в бд биллинга
      Throws:
        `ru.bitel.bgbilling.common.BGException`

    - #### cancelTransaction

          public void cancelTransaction(Transaction transaction)
                                 throws ru.bitel.bgbilling.common.BGException

      Description copied from class: `AbstractQiwiProtocol`
      Отмена НЕОПЛАЧЕННОГО выставленного счета.
      Specified by:
        `cancelTransaction` in class `AbstractQiwiProtocol`
      Parameters:
        `transaction` - транзакция, которую хотим отменить.
      Throws:
        `ru.bitel.bgbilling.common.BGException`

    - #### refundTransaction

          public void refundTransaction(Transaction transaction)
                                 throws ru.bitel.bgbilling.common.BGException

      Description copied from class: `AbstractQiwiProtocol`
      Возврат средств (полный или частичный) по оплаченному счету.
      Specified by:
        `refundTransaction` in class `AbstractQiwiProtocol`
      Parameters:
        `transaction` - транзакция, по которой хотим вернуть средства.
      Throws:
        `ru.bitel.bgbilling.common.BGException`

    - #### checkRefundStatus

          public void checkRefundStatus(Transaction transaction)
                                 throws ru.bitel.bgbilling.common.BGException

      Specified by:
        `checkRefundStatus` in class `AbstractQiwiProtocol`
      Throws:
        `ru.bitel.bgbilling.common.BGException`