Быстрый запуск

  1. Зарегистрируйте заказ.
  2. Перенаправьте покупателя на страницу платежа.
  3. Выполните запрос состояния заказа.
  4. При необходимости произведите отмену заказа или возврат средств.

1. Регистрация заказа

Регистрация заказа осуществляется с помощью метода register.do (интерфейс REST)/registerOrder (интерфейс WSDL).

Интерфейс REST 

userName=username-api&password=password&amount=15000&returnUrl=https://test.ru

Интерфейс WSDL 

<soapenv:Body>
   <mer:registerOrder>
      <order amount="15000">
         <returnUrl>https://test.ru</returnUrl>
      </order>
   </mer:registerOrder>
</soapenv:Body>

2. Перенаправление покупателя на платёжную страницу

Перенаправьте пользователя на formUrl, полученный в ответе на запрос регистрации заказа. Ниже представлены примеры ответа на запрос регистрации заказа.

Интерфейс REST 

{"orderId":"70906e55-7114-41d6-8332-4609dc6590f4","formUrl":"https://3dsec.sberbank.ru/payment/merchants/test/payment_ru.html?mdOrder=70906e55-7114-41d6-8332-4609dc6590f4"}

Интерфейс WSDL 

<soap:Body>
   <ns1:registerOrderResponse xmlns:ns1="http://engine.paymentgate.ru/webservices/merchant">
      <return orderId="05fcbc62-7ee6-4f1a-b3d5-6ca41a982283" errorCode="0" errorMessage="Успешно">
         <formUrl>https://3dsec.sberbank.ru/payment/merchants/test/payment_ru.html?mdOrder=05fcbc62-7ee6-4f1a-b3d5-6ca41a982283 </formUrl>
      </return>
   </ns1:registerOrderResponse>
</soap:Body>

3. Запрос состояния заказа

Отправьте в шлюз запрос о состоянии заказа с помощью метода getOrderStatusExtended.do (интерфейс REST)/getOrderStatusExtended (интерфейс WSDL).

Интерфейс REST 

orderId=b8d70aa7-bfb3-4f94-b7bb-aec7273e1fce

Интерфейс WSDL 

    <soapenv:Body>
       <mer:getOrderStatusExtended>
          <order orderId="942e8534-ac73-4e3c-96c6-f6cc448018f7" language="en">
             <!--Optional:-->
             <merchantOrderNumber> </merchantOrderNumber>
            </order>
       </mer:getOrderStatusExtended>
    </soapenv:Body>

Состояние заказа будет возвращено в параметре orderSatus.

По значению этого параметра определяется состояние заказа в платёжной системе. Отсутствует, если заказ не был найден. Ниже представлен список возможных значений:

  • 0 - заказ зарегистрирован, но не оплачен;
  • 1 - предавторизованная сумма удержана (для двухстадийных платежей);
  • 2 - проведена полная авторизация суммы заказа;
  • 3 - авторизация отменена;
  • 4 - по транзакции была проведена операция возврата;
  • 5 - инициирована авторизация через сервер контроля доступа банка-эмитента;
  • 6 - авторизация отклонена.

4. Отмена или возврат платежа

После совершения платежа или холдирования средств на счёте покупателя вы можете сделать возврат или отмену платежа в личном кабинете.

{(rater>id=rater6|name=Была ли статья полезна?|type=vote)}