Оплата в одну стадию

В этом разделе описана структура запросов для оплаты в одну стадию с использованием платежных карт. Далее описаны требования к запросам:

1. POST-запрос должен отправляться в одну из следующих конечных точек:
   • /v2/payment/card/sale — при передаче реквизитов карты в явном виде;
   • /v2/payment/card/sale/saved — при передаче идентификатора, а не реквизитов карты;
   • /v2/payment/card/sale/token — при передаче токена, а не реквизитов карты.
2. В запросе должны использоваться следующие объекты и параметры:
   • general — объект, содержащий основные идентификационные сведения запроса:
     • project_id — идентификатор проекта, полученный от Rocketpay при интеграции;
     • payment_id — идентификатор платежа, уникальный в рамках проекта мерчанта;
     • signature — подпись запроса, составленная после указания всех параметров запроса (подробнее см. Подписывание и проверка подписи);
   • customer — объект, содержащий сведения о пользователе:
     • ip_address — IP-адрес пользователя;
     • id — идентификатор пользователя в проекте мерчанта;
   • payment — объект, содержащий сведения о платеже:
     • amount — сумма оплаты в дробных единицах валюты без десятичной точки и пробелов за исключением случаев, когда у валюты нет дробной части. Если у валюты нет дробных единиц (то есть количество разрядов дробных единиц равно нулю), то в этом параметре нужно указывать сумму в основных единицах валюты. Подробнее о разрядах дробных единиц у валют см. Коды валют;
     • currency — валюта платежа в формате ISO-4217 alpha-3.
3. В запросе должны содержаться сведения о платежной карте пользователя:
   • при передаче реквизитов карты в явном виде нужно передать следующие данные в объекте card:
     • pan — номер карты,
     • year — год окончания срока действия карты,
     • month — месяц окончания срока действия карты,
     • card_holder — имя держателя карты (в соответствии с указанным на карте),
     • cvv — код проверки подлинности карты (в соответствии с указанным на карте), если такой код у используемой карты есть.

       У некоторых карт код проверки подлинности (CVV) отсутствует, в таких случаях в платежах с применением таких карт параметр cvv не передается. Подробнее о наличии CVV у карт и обязательности параметра cvv узнавайте у своего курирующего менеджера Rocketpay.

   • при передаче идентификатора нужно передать идентификатор, связанный с реквизитами карты в платежной платформе, и код проверки подлинности карты в параметрах saved_account_id и cvv, если такой код поддерживается для используемой карты.

     У некоторых карт код проверки подлинности (CVV) отсутствует, в таких случаях в платежах с применением таких карт параметр cvv не передается. Подробнее о наличии CVV у карт и обязательности параметра cvv узнавайте у своего курирующего менеджера Rocketpay.

   • при передаче токена нужно передать токен и код проверки подлинности карты в параметрах token и cvv, если такой код у используемой карты есть.

     У некоторых карт код проверки подлинности (CVV) отсутствует, в таких случаях в платежах с применением таких карт параметр cvv не передается. Подробнее о наличии CVV у карт и обязательности параметра cvv узнавайте у своего курирующего менеджера Rocketpay.

4. В запросе должен содержаться объект return_url с адресами для перенаправления пользователя в веб-сервис:
   • success — URL-адрес, на который перенаправляется пользователь в случае успешного завершения платежа;
   • decline — URL-адрес, на который перенаправляется пользователь в случае отклонения платежа;
   • return — URL-адрес, на который перенаправляется пользователь до завершения платежа независимо от его исхода. Этот же адрес используется, если не заданы параметры success и decline.
5. При наличии особых региональных требований, а также от требований провайдеров и платежных систем, в запросе может понадобиться указать дополнительные сведения о пользователе:
   • first_name — имя пользователя;
   • last_name — фамилия;
   • middle_name — отчество или среднее имя;
   • day_of_birth — дата рождения;
   • phone — номер телефона с кодом страны;
   • email — адрес электронной почты;
   • zip — почтовый индекс адреса проживания;
   • address — адрес проживания (улица, номер дома);
   • city — город проживания (или иной населенный пункт);
   • district — округ (район, область и т. п.) проживания;
   • state — регион проживания (штат, графство, кантон и т. п.);
   • avs_post_code — почтовый индекс, зафиксированный эмитентом как актуальный для пользователя;
   • avs_street_address — улица и номер дома, зафиксированные эмитентом как актуальные для пользователя.

   За информацией о параметрах, требуемых в каждом конкретном случае, обращайтесь к своему курирующему менеджеру Rocketpay. Если вы не передадите в запросе необходимые сведения, вам потребуется выполнить процедуру дополнения информации о платеже.

6. Дополнительно могут использоваться любые другие параметры, указанные в спецификации.

Вот пример запроса:

{
  "general": {
      "project_id": 42,
      "payment_id": "456789",
      "signature": "v7KNMpfogAxwRIL9tVftZ1ZZ5D/aZAeb0VMdeR+CqGrNxYyilUwSm...=="
  },
  "customer": {
      "ip_address": "248.121.176.220",
      "id": "customer_12"
  },
  "payment": {
      "amount": 400000,
      "currency": "USD"
  },
  "return_url": {
        "success": "http://example.com/return",
        "decline": "http://example.com/decline",
        "return": "http://example.com/return"
  },
//при передаче реквизитов карты в явном виде:
  "card": {
      "pan": "4242424242424243",
      "year": 2025,
      "month": 8,
      "card_holder": "JOHN SMITH",
      "cvv": "123"
  }
//при передаче идентификатора ранее сохраненной платежной карты:
    "saved_account_id": 2345678,
    "cvv": "123"

//при передаче токена ранее сохраненной платежной карты:
    "token": "f365bb1729f9b72fd9c09703a751c979f3becc679f29c3e35c91d18070d15654",
    "cvv": "123"   
}