Image Added

1 Проблематика

Если вы не нашли в списке доступных к подключение подключению ПС, вы можете собственными силами подключить любую другую ПС, используя протокол взаимодействия с сервисами ОпентаоОпенТрейд Коммерс.

2 Общие сведения

Опентао ОпенТрейд Коммерс предоставляет протокол, позволяющий Контрагенту интегрировать способы оплаты, недоступные клиентам ОпентаоОпенТрейд Коммерс, в систему заказов и учета движения средств.

Сокращения

• ОпенТрейд Коммерс -- система заказов и учета движения средств. Биллинг.
• Контрагент — клиент ОпенТрейд Коммерс.
• Плательщик — пользователь веб-ресурса Контрагента, совершающий платеж.
• ПС — платежная система.

Подключение

Для подключения к данному протоколу необходимо:

• являться клиентом ОпенТрейд Коммерс;
• подать заявку на услугу «Подключение кастомной платежной системы» в службу технической поддержки OpenTrade Commerce.
• получить Платежный секрет (3.3.1). Дальнейшее требования безопасности по нераспространению обеспечивает Контрагент.

3 Общее описание протокола

Image Added

Диаграмма последовательности взаимодействия всех участников платежа

Сам процесс взаимодействия является обобщенным примером. В некоторых реальных ситуациях процесс может несколько отличаться от представленного на диаграмме.

...

Далее следует подробное пошаговое описание последовательности процесса взаимодействия.

3.1 Пример взаимодействия Плательщик, ПС,

...

Контрагент,

...

ОпенТрейд Коммерс при проведении платежа.

1. Плательщик иницализирует инициализирует оплату.
2-4. Сайт контрагента запрашивает способы оплаты в Опентао метод ОпенТрейд Коммерс с помощью метода GetPaymentModes и показывает плательщику.

5. Плательщик выбирает способ оплаты и заполняет платежные данные, т.к. такие как сумма платеж и др.

6. Сайт Контрагента запрашивает данные системы учета Опентао ОпенТрейд Коммерс для инициаиализации инициализации платежа в ПС с помощью метода GetPaymentParameters

...

...

...

public class PaymentFormAnswer
{
	public PaymentForm Result { get; set; }
	public OtapiErrorCode ErrorCode { get; set; }
	public string ErrorDescription { get; set; }
	public string SubErrorCode { get; set; }
}
public class PaymentForm
{
    public string RequestMethod { get; set; }
    public string RequestUrl { get; set; }
    [ XmlArrayItem( "Parameter" ) ] 
	public PaymentFormParameter[] Parameters { get; set; }
}
public class PaymentFormParameter
{
    public string Name { get; set; }
    public string Value { get; set; }
}

<?xml version="1.0" encoding="utf-8"?>
<PaymentFormAnswer>
  <ErrorCode>Ok</ErrorCode>
  <Result>
    <RequestMethod>POST</RequestMethod>
    <RequestUrl>http://example.com/test.php</RequestUrl>
    <Parameters>
      <Parameter>
        <Name>paymentId</Name>
        <Value>222</Value>
      </Parameter>
      <Parameter>
        <Name>userId</Name>
        <Value>0000000001</Value>
      </Parameter>
      <Parameter>
        <Name>amount</Name>
        <Value>500.15</Value>
      </Parameter>
      <Parameter>
        <Name>currency</Name>
        <Value>643</Value>
      </Parameter>
      <Parameter>
        <Name>description</Name>
        <Value>Top up the account USR-0000000001 (user 0000000001, payment 222)</Value>
      </Parameter>
    </Parameters>
  </Result>
</PaymentFormAnswer>

...

...

...

...

...

...

...

...

...

...

...

...

8. Контрагент на основе данных, полученных на шаге 7, формирует платежную форму с учетом требования требований ПС.

9. По данным, полученным из платежной формы, ПС формирует контракт, отправляет его плательщику и ждет подтверждения оплаты.

...

12. ПС возвращает в браузер плательщика ответ - страницу с сообщением об успехи/неудачи платежа.

3.2

...

 Пример взаимодействия ПС, Контрагент,

...

ОпенТрейд Коммерс при оповещении о платеже.

13. ПС уведомляет Контрагента о совершенном платеже

14. Контрагент адаптирует данные, полученные в шаге 13, к параметрам оповещения ОпентаоОпенТрейд Коммерс.

15. Контрагент уведомляет Опентао ОпенТрейд Коммерс о совершенном платеже.

...

...

...

...

1616. Опентао ОпенТрейд Коммерс проверяет параметры оповещение. В случае когда все проверки пройдены - и статус платежа помечен как Completed — зачисляет средства на счет плательщика.

17. Опенато ОпенТрейд Коммерс подтверждает Контрагенту получение оповещения о платеже.

<?xml version="1.0" encoding="utf-8"?>
<NoticeAnswer>
  <PaymentId>222</PaymentId>
  <ErrorCode>Ok</ErrorCode>
</NoticeAnswer>

<?xml version="1.0" encoding="utf-8"?>
<NoticeAnswer>
  <PaymentId>222</PaymentId>
  <ErrorCode>VerificationError</ErrorCode>
  <ErrorDescription>Unknown notification status: 'Overpaid'</ErrorDescription>
</NoticeAnswer>

PaymentId 

ErrorCode 

ErrorDescription 

18. Контрагент подтверждает ПС получение оповещения о платеже.

3.3.

...

Таблицы данных

3.

...

3.1 Платежные параметры

...

3.3.2 Описание NoticeErrorCode

3.4. Правила формирования цифровой подписи при оповещении Контрагентом ОпенТрейд Коммерс

MD5 хеширование применяется к тексту, формируемому как последовательность значений ряда параметров, разделенных символом «точка с запятой» — «;». 

Пример: