Перейти к основному содержимому

Руководство по интеграции платежного шлюза CCAvenue | Документация для разработчиков

Руководство по интеграции платежного шлюза CCAvenue

Обновлено: 10 декабря 2025 г
Цель данного документа — описать интеграцию платежной системы с CCAvenue, необходимую для продавца (или поставщика платежных услуг), внедрившего чат-бота с использованием API WhatsApp Business и нуждающегося в приеме платежей от пользователей WhatsApp.
В этом документе описаны необходимые API, которые должны быть интегрированы, и то, как интеграция работает совместно с API WhatsApp Business. Хотя это не исчерпывающее руководство, оно служит общим обзором, помогающим понять процесс интеграции платежного шлюза. Любые специфические или уникальные детали, касающиеся платежного шлюза, должны быть определены продавцом (или BSP).
Что касается интеграции с продуктом WA P2M, в этом документе описаны запросы и ответы, выделенные красным цветом на блок-схеме.

Интеграция CCAvenue с платежами WhatsApp

Настраивать

Для аутентификации на их сервере воспользуйтесь документацией CCAVenue.
Для упрощения объяснения, следующие примеры будут касаться только содержимого конечной полезной нагрузки, которая в конечном итоге будет включена в итоговый объект, необходимый для успешной аутентификации с помощью их API. Важно обратиться к документации CCAvenue за рекомендациями по структуре этого итогового объекта.
Для продолжения вам потребуется следующая информация:
    Аутентификация прошла успешноДанные из настроек платежа, которые вы уже задали в бизнес-аккаунте WhatsApp.
      код категории продавцаVPA продавца

      API для инициирования платежей

      Пример полезной нагрузки для ПОЧТА к https://secure.ccavenue.com/transaction.do
      Запрос
      локон -X POST -д 'card_name=UPI&order_id=67314339998877¤cy=INR&payment_option=OPTUPI&card_type=UPI&merchant_id=2&amount=100.00&re direct_url=https://merchantredirecturl.com'
      Имя Описание Тип
      merchant_id
      Идентификатор продавца (Merchant Id) — это уникальный идентификатор, генерируемый CCAvenue для каждого активированного продавца.
      Числовой
      order_id
      Этот идентификатор используется продавцами для идентификации заказа. Убедитесь, что вы отправляете уникальный идентификатор с каждым запросом.
      Допустимые буквенно-цифровые символы (30): буквы (AZ), (az), цифры, - (дефис), / (косая черта), _ (подчеркивание)
      валюта
      Валюта, в которой вы хотите совершить транзакцию. INR – индийская рупия
      «INR»
      количество
      Сумма заказа
      Числовой (12, 2)
      redirect_url
      CCAvenue отправит статус заказа вместе с параметрами на этот URL. Если вы не отправите это значение, статус заказа будет отправлен обратно на URL, настроенный в модуле динамических уведомлений о событиях в вашей учетной записи MARS. Если в учетной записи MARS не настроен URL, PG отобразит статус заказа на странице подтверждения CCAvenue.
      Допустимые буквенно-цифровые символы (100): буквы (AZ), (az), цифры, / (косая черта),_ (подчеркивание)
      card_type
      Тип карты, используемой клиентом.
      UPI
      «UPI»
      card_name
      Название карты, использованной клиентом. Этот список будет предоставлен компанией CCAvenue.
      UPI
      «UPI»
      Пример ответа от CCAvenue
      {«статус»:"0","enc_response":"68b4c0ff090e439119f91d0ace1930973e5a2fc244b122e255170de2b412d486269678930fc2c17 5a64357a882854f62e5adb6d4476f629df3bb532cc5c82828258ed40b09181949c48e6b9365eabf9d c9e1acb5308f5d6776e2400e0c4ac4282afd81e3a66519b3734192062a49b51d956f93d9cebf4d49 b9480ed6cbcdb5f87e50c7a3bd052dca39718738a49a5e22408a8656052fa506458ca1f904970fdf"}
      Расшифрованный пример ответа
      {"errorCode":"","errorMessage":"","intentUrl":"upi://pay?pa=vpa@samplebank&pn=Infibeam Avenues Limited&tr=123123123123&am=100.0&cu=INR&mc=8299"}
      Проанализируйте ответ
      Используйте значение intentUrl в ответе и передать его в качестве upi_intent_link при настройке параметры объект для отправки в сообщении с подробной информацией о заказе с помощью API WhatsApp.

      Веб-перехватчик статуса

      Когда происходит событие, например, успешная обработка платежа в вашем аккаунте CCAvenue, CCAvenue генерирует объект события. Этот объект события содержит важные сведения, включая тип события и связанные с ним данные. CCAvenue пересылает этот объект события на указанный URL-адрес в настройках веб-перехватчика вашего аккаунта посредством HTTP POST-запроса.

      Статус платежа

      Используйте уведомление веб-хука выше, чтобы узнать статус платежа API статуса платежа.
      Запрос
      Пример полезной нагрузки для ПОЧТА к https://api.ccavenue.com/apis/servlet/DoWebTrans
      {"orderNo":"11111111","referenceNo":"111111111111"}
      Проанализируйте ответ
      Используйте статус заказа полученный из ответа выше и передать соответствующий сообщение о состоянии через API WhatsApp.
      Вернуться наверх