Rocket

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

Info

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

Процесс проведения оплаты

Покупатель инициирует покупку криптовалюты на сайте торговца и выбирает rocket в качестве способа оплаты.
Торговец отправляет запрос оплаты в Constantpos.
Constantpos присылает в ответе торговцу инструкцию для оплаты. Инструкция содержит сумму платежа и идентификатор кошелька (номер телефона), на который нужно осуществить перевод.
Торговец отображает покупателю инструкцию для оплаты.
Покупатель копирует реквизиты для оплаты и в течение 20 минут совершает оплату, используя выбранный сервис.
Покупатель предоставляет торговцу информацию об оплате, например номер чека и/или скриншот с подтверждением оплаты.
Торговец отправляет в Constantpos либо запрос на подтверждения оплаты, либо запрос на доказательство оплаты.
Constantpos присылает ответ со статусом подтверждения/доказательства оплаты.
Constantpos после получения информации об оплате, совершенной покупателем, при необходимости, обновляет сумму оплаты и отправляет торговцу автоматическое уведомление.

Оплата

Note

Значение параметра amount в автоматическом уведомлении и в ответе на запрос статуса может отличаться от значения, присланного в первоначальном запросе на оплату, и будет равно фактической сумме платежа согласно информации в системе провайдера.

Запрос

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

Параметр	Тип данных	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения транзакции.
ip * обязательный	string	IP-адрес покупателя, производящего оплату в магазине торговца.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`rocket`
user_id * обязательный	string	Уникальный идентификатор покупателя. Разрешается до трех активных запросов с идентичным `user_id`.
additional_data	object
browser* обязательный	object	Секция параметров браузера покупателя.
ip* обязательный	object	Cтрока агента пользователя текущего браузера. Соответствует параметру navigator.userAgent в JavaScript.

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

{
    "request": {
        "amount": 420000,
        "currency": "BDT",
        "description": "test description",
        "test": false,
        "tracking_id": "your_uniq_number21212",
        "ip": "127.00.00.1",       
        "language": "en",       
        "return_url": "https://example.com",        
        "additional_data": {
            "browser": {
              "user_agent": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:96.0) Gecko/20100101 Firefox/96.0"                
            }
        },
        "method": {         
          "type": "rocket",
          "user_id": "09fce47f-ae55-402f-a181-cc4fab2f2684"
        }
    }
}

Ответ

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

Параметр	Тип данных	Описание
rocket	object
type	string	`rocket`
expired_at	string	Время, до которого нужно осуществить платеж.
target_card	string	Идентификатор кошелька (номер телефона), на который следует произвести платеж.
converted_amount	string	Сумма в USDT, которую получит покупатель в случае успешной транзакции согласно обменному курсу.
need_proof	boolean	Всегда `true`.

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

{
  "transaction": {
    "uid": "c332a926-544b-4596-b84d-6404bc5531ca",
    "type": "payment",
    "status": "pending",
    "amount": 420000,
    "currency": "BDT",
    "description": "test description",
    "created_at": "2024-02-13T10:50:36Z",
    "updated_at": "2024-02-13T10:50:39Z",
    "method_type": "rocket",
    "receipt_url": "https://my.constantpos.com/customer/transactions/c332a926-544b-4596-b84d-6404bc5531ca/ed0e420d4224aba19dbc707328a82f878abd2ff21b9b9fe65953e957f9613d43?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 3715,
      "ref_id": "ELGDH5",
      "message": "Transaction was initialized."
    },
    "rocket": {
      "type": "rocket",
      "expired_at": "2024-02-13T11:20:38Z",
      "target_card": "01789571561",
      "converted_amount": "33.523838 USDT",
      "need_proof": true
    },
    "customer": {
      "email": "null",
      "ip": "127.00.00.1"
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number21212",
    "test": false,
    "language": "en",
    "additional_data": {
      "browser": {
        "user_agent": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:96.0) Gecko/20100101 Firefox/96.0"
      },
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    }
  }
}