PayTM

Вариант интеграции QP

Для этого варианта интеграции поддерживаются следующие операции:

Оплата

Запрос

Info

Уточните поддерживаемые валюты и страны у аккаунт менеджера.

Отправьте запрос оплаты со следующими дополнительными параметрами:

Параметр	Тип данных	Описание
method	object	Секция параметров способа оплаты.
type * обязательный	string	`paytm`
customer	object	Cекция информации о покупателе.
first_name * обязательный	string	Имя клиента.
last_name * обязательный	string	Фамилия клиента.
email * обязательный	string	Адрес электронной почты клиента.

Ответ

Секция paytm из ответа на запрос будет иметь все те же параметры, что были присланы в запросе, а также один дополнительный параметр form с необходимыми параметрами, чтобы сформировать веб-форму для перехода на оплату.

Вариант интеграции GP

Описание процесса оплаты

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

Оплата

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

Параметр	Тип данных	Описание
request	object
amount * обязательный	bigInteger	Сумма транзакции, должна быть целым числом в минимальных денежных единицах, например, 50000 (500 рупий). Последние цифры значения параметра должны быть `00`.
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`paytm`

Info

Этот вариант интеграции поддерживает только валюту INR.

Пример запроса

{
  "request": {
    "amount": 20000,
    "currency": "INR",
    "description": "description",
    "test": false,
    "return_url": "https://your_return_url.com",
    "method": {
      "type": "paytm"
    }
  }
}

Ответ

Ответ на запрос выплаты средств будет дополнительно содержать секцию form. Направьте покупателя на URL, переданный как значение параметра form.action.

Пример ответа

{
  "transaction": {
      "uid": "a705e07d-bd83-49ea-a76c-8bb7eec96e43",
      "type": "payment",
      "status": "pending",
      "amount": 20000,
      "currency": "INR",
      "description": "description",
      "created_at": "2023-12-27T08:14:14Z",
      "updated_at": "2023-12-27T08:14:15Z",
      "method_type": "paytm",
      "receipt_url": "https://my.constantpos.com/customer/transactions/a705e07d-bd83-49ea-a76c-8bb7eec96e43/341fcbfe857acd16eedaab92e8d724f6e166ab91c6571cd6efe2ee3e4ebcfc7f",
      "payment": {
          "status": "pending",
          "gateway_id": 3572,
          "ref_id": "31RFIW2023122714415",
          "message": "Transaction Initiated Successfully",
          "bank_code": "200"
      },
      "paytm": {
          "type": "paytm"
      },
      "customer": {
          "email": null,
          "ip": null
      },
      "manually_corrected_at": null,
      "message": "Transaction Initiated Successfully",
      "test": false,
      "additional_data": {
          "payment_method": {
              "type": "alternative"
          }
      },             
      "gateway": {
          "iframe": true
      },
      "form": {
        "action": "paytmmp://pay?ver=01&mode=15&am=200.00&mam=200.00&cu=INR&pa=payee1@example1&pn=1SHOP&mc=5816&tr=PAYEE1PPTDcCYne5jLHfkiuVaeafGs&mid=PARB6332&msid=WES-4382&mtid=WES-4382&tn=PRB",
        "method": "GET",
        "fields": [
            {
                "name": "deep_link",
                "value": "paytmmp://pay?ver=01&mode=15&am=200.00&mam=200.00&cu=INR&pa=payee1@example1&pn=1SHOP&mc=5816&tr=PAYEE1PPTDcCYne5jLHfkiuVaeafGs&mid=PARB6332&msid=WES-4382&mtid=WES-4382&tn=PRB"
            }
        ]
    }
  }
}