VASMS Content Provider API Documentation Ver:1.0.0: Get Failed Charges for Subscriptions

Запрос на получение транзакций - не-успешное списание средств со счетов Абонентов на основании активных подписок.
При наличии новых данных, будет отправлен блок данных в кол-ве: 1...1000 с сортировкой LastBFNTRID ASC.
Внимание: запросы отправлять линейно синхронно с интервалами между ними
- если получен новый блок данных => не менее 1 сек.
- иначе не менее 10 секунд.
В случае нарушения данных интервалов сервис вернет ошибку 'HTTP response status code': 429.

Примечание: Общая схема взаимодействия.

Request

POST http://<APIURL:PORT>/Billing/Charge/GetLastFailures

Request headers

Parameter name	Value	Description	Additional
VASMS-CPID	<uint>	Content Provider ID Уникальный код Контент Провайдера. Предоставляется со стороны VASMS.	Required
VASMS-APIKey	<string>	Content Provider API Key Value Предоставляется со стороны VASMS.	Required
Content-type	application/json; charset=UTF-8		Required

Request body

The request body takes a complete Billing/Charge/GetLastFailures - Request resource, containing the following writable properties:

{
    "CPID": "uint",
    "LastBFNTRID": "uint64"
}

Properties

Name	Type	Description	Additional
CPID	uint	Content Provider ID Уникальный код Контент Провайдера. Предоставляется со стороны VASMS.
LastBFNTRID	uint64	Last Billing Failures Notify Transaction ID Максимальное значение которое было получено ранее. Уникальное значение в составе группы Billing/Charge/GetLastFailures. Первичный запрос => LastBFNTRID=0.

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code	Description	Resource
200	OK Успешная обработка запроса.	Billing/Charge/GetLastFailures - Reply[]
400	Bad Request Ошибочный запрос.	400[]
401	Unauthorized Отказ в доступе. Ошибочный VASMS-CPID и/или VASMS-APIKey.
429	Too Many Requests Слишком много паралельных запросов. (Anti-flood rate limiting).
500	Internal Server Error Системная ошибка на стороне сервера.