...
Если вы не нашли в списке доступных к подключению ПС, вы можете собственными силами подключить любую другую ПС, используя протокол взаимодействия с сервисами ОпентаоОпенТрейд Коммерс.
2 Общие сведения
Опентао ОпенТрейд Коммерс предоставляет протокол, позволяющий Контрагенту интегрировать способы оплаты, недоступные клиентам ОпентаоОпенТрейд Коммерс, в систему заказов и учета движения средств.
Сокращения
Опентао ОпенТрейд Коммерс - система заказов и учета движения средств. Биллинг.
Контрагент - клиент ОпентаоОпенТрейд Коммерс.
Плательщик - пользователь веб-ресурса Контрагента, совершающий платеж.
...
Для подключения к данному протоколу необходимо:
- являться клиентом ОпентаоОпенТрейд Коммерс;
- подать заявку на услугу "Подключение кастомной платежной системы" в службу технической поддержки Opentao.
- получить Платежный секрет (3.3.1). Дальнейшее требования безопасности по нераспространению обеспечивает Контрагент.
...
Далее следует подробное пошаговое описание последовательности процесса взаимодействия.
3.1 Пример взаимодействия Плательщик, ПС, Контрагент,
...
ОпенТрейд Коммерс при проведении платежа.
1. Плательщик инициализирует оплату.
2-4. Сайт контрагента запрашивает способы оплаты в Опентао ОпенТрейд Коммерс с помощью метода GetPaymentModes и показывает плательщику.
...
6. Сайт Контрагента запрашивает данные системы учета Опентао ОпенТрейд Коммерс для инициализации платежа в ПС с помощью метода GetPaymentParameters
7. Опентао ОпенТрейд Коммерс передает платежные данные в ответ на вызов метода GetPaymentParameters
...
12. ПС возвращает в браузер плательщика ответ - страницу с сообщением об успехи/неудачи платежа.
3.2 Пример взаимодействия ПС, Контрагент,
...
ОпенТрейд Коммерс при оповещении о платеже.
13. ПС уведомляет Контрагента о совершенном платеже
14. Контрагент адаптирует данные, полученные в шаге 13, к параметрам оповещения ОпентаоОпенТрейд Коммерс.
15. Контрагент уведомляет Опентао ОпенТрейд Коммерс о совершенном платеже.
| Раскрыть | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Необходимо передать нижеследующие параметры на адрес оповещения RequestUrl методом RequestMethod (получены от Опентао ОпенТрейд Коммерс на 7 шаге), используя транспорт HTTP. Параметры (описание см. в 3.3.1):
|
16. Опентао ОпенТрейд Коммерс проверяет параметры оповещение. В случае когда все проверки пройдены и статус платежа помечен как Completed - зачисляет средства на счет плательщика.
17. Опентао ОпенТрейд Коммерс подтверждает Контрагенту получение оповещения о платеже.
| Раскрыть | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
Ответ о безошибочной обработке оповещения
Ответ с ошибкой
где
|
...
| Параметр | Описание | Возможное значение | Примечание |
|---|---|---|---|
| instanceKey | Идентификатор Контрагента в системе ОпентаоОпенТрейд Коммерс | ||
| secret | Платежный секрет | Необходим для формирования цифровой подписи 3.4. Выдается Контрагенту от ОпентаоОпенТрейд Коммерс. | |
| orderId | Идентификатор заказа для оплаты | Присутствует если пользователь оплачивает заказ. Отсутствует при пополнении счета | |
| paymentId | Идентификатор платежа во внутренней системе биллинга ОпентаоОпенТрейд Коммерс | ||
| userId | Идентификатор пользователя ОпентаоОпенТрейд Коммерс | ||
| amount | Сумма платежа | Десятичный разделитель — точка, и всегда 2 знака после него. | |
| currency | Цифровой код валюты платежа в формате ISO 4217 | 643 - RUB | http://en.wikipedia.org/wiki/ISO_4217 |
| status | Состояние платежа | Completed - завершен Canceled - отменен | |
| signature | Цифровая подпись зашифрованная по алгоритму MD5 | 32 шестнадцатеричных символа, в верхнем регистре | |
| description | Описание платежа |
...
| Код | Описание |
|---|---|
| Ok | Оповещение обработано |
| VerificationError | Ошибка при проверки входящих данных |
| SignatureVerificationError | Не совпали цифровые подписи: присланная Контрагентом и подсчитанная на стороне ОпентаоОпенТрейд Коммерс |
| InternalError | Внутренняя ошибка сервиса ОпентаоОпенТрейд Коммерс. Необработанная ошибка |
3.4. Правила формирования цифровой подписи при оповещении Контрагентом ОпентаоОпенТрейд Коммерс
MD5 хеширование применяется к тексту, формируемому как последовательность значений ряда параметров, разделенных символом «точка с запятой» — «;».
...