PhonePe

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

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

Оплата

Запрос

Info

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

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

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

Ответ

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

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

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

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

Info

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

Оплата

Запрос

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

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

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

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

Ответ

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

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

{
  "transaction": {
    "uid": "20935610-518e-4c43-8fb8-6ff365868b67",
    "type": "payment",
    "status": "pending",
    "amount": 20000,
    "currency": "INR",
    "description": "description",
    "created_at": "2023-12-26T15:37:36Z",
    "updated_at": "2023-12-26T15:37:37Z",
    "method_type": "phone_pe",
    "receipt_url": "https://my.constantpos.com/customer/transactions/20935610-518e-4c43-8fb8-6ff365868b67/019400668ab48cc40a10e1c06b0d38faac2e9c9dfe66e23b9def5cf1028d4c46",
    "payment": {
      "status": "pending",
      "gateway_id": 3572,
      "ref_id": "FSVTBJ2023122690736",
      "message": "Transaction Initiated Successfully",
      "bank_code": "200"
    },
    "phone_pe": {
      "type": "phone_pe"
    },
    "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": "phonepe://pay?ver=01&mode=15&am=200.00&mam=200.00&cu=INR&pa=payee1@example1&pn=1SHOP&mc=5816&tr=PAYEE1PPTG7yW0tdjk2QFEx2khguHC&mid=PARB6332&msid=WES-4382&mtid=WES-4382&tn=PRB",
      "method": "GET",
      "fields": [
            {
                "name": "deep_link",
                "value": "phonepe://pay?ver=01&mode=15&am=200.00&mam=200.00&cu=INR&pa=payee1@example1&pn=1SHOP&mc=5816&tr=PAYEE1PPTG7yW0tdjk2QFEx2khguHC&mid=PARB6332&msid=WES-4382&mtid=WES-4382&tn=PRB"
            }
      ]
    }
  }
}