XML интерфейсы

Документация сервиса

Документация сервиса Robokassa

XML интерфейсы

XML интерфейсы предназначены для создания развёрнутого интерфейса Robokassa, со всевозможными информационными блоками для клиентов Вашего магазина/сайта, а также для построения более глубокой системы взаимодействия Вашего магазина/сайта с Robokassa.

Запросы к интерфейсам можно отправлять методом HTTP GET или HTTP POST, либо их можно использовать как методы XML web-сервиса:

URL для запросов HTTP GET/POST:

Ответ на запрос, переданный методом HTTP GET/POST.

Возвращается в формате XML-документа. Документ имеет следующую структуру:

xml
  
1 2 3 4 5 6 7 8 9 10 11
<?xml version="1.0" encoding="utf-8" ?> <...> <Result> <Code>integer</Code> <Description>string</Description> </Result> <...> Запрошенные данные (возвращаются только в случае успешного выполнения запроса) Required data <...> <...>

Информация о результате в элементе Result

Параметр

Значение

Result

Тип и сумма налога.

Содержит строку:

Code

Результат выполнения запроса. Если во время выполнения запроса произошла ошибка, то в ответе не будет содержаться дополнительных элементов с запрашиваемыми данными.

Возможные значения:

0

— Запрос обработан успешно

2

— Информация о магазине с таким MerchantLogin не найдена или магазин не активирован

1000

— Внутренняя ошибка сервиса

Description

Текстовое описание результата выполнения запроса.

Интерфейс получения списка валют

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

Название метода

GetCurrencies

URL для запросов HTTP GET/POST

Пример запроса методом HTTP GET

https://auth.robokassa.ru/Merchant/WebService/Service.asmx/GetCurrencies?MerchantLogin=demo&Language=ru

Параметры запроса

Параметр

Значение

MerchantLogin

Идентификатор магазина, строка.

Language

Язык для локализованных значений в ответе (названий валют, методов оплаты и т.д.).

Возможные значения:

en

– Английский

ru

– Русский

Ответ на запрос, переданный методом HTTP GET/POST.

Возвращается в формате XML-документа. Документ имеет следующую структуру:

xml
  
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
<?xml version="1.0" encoding="utf-8" ?> <CurrenciesList xmlns="http://auth.robokassa.ru/Merchant/WebService/"> <Result> <Code>integer</Code> <Description>string</Description> </Result> <Groups> <Group Code="string" Description="string"> <Items> <Currency Label="string" Name="string"> <Rate IncSum="decimal" /> </Currency> ... </Items> </Group> ... </Groups> </CurrenciesList>

Описание возвращаемых данных

Параметр

Значение

Groups

Группы валют. Могут использоваться для более удобного отображения валют в пользовательском интерфейсе.

Code

Код группы

Description

Текстовое описание группы

Items

Валюты, входящие в группу

Label

Код валюты

Name

Наименование валюты