Типы данных

ID — Строка, длиной 24 символа представляющая собой уникальный идентификатор объекта в системе Payme Business.

Timestamp — Положительное, целое число состоящее из 13 цифр и определяющее количество миллисекунд, прошедших с полуночи 1 января 1970 года UTC.

{
    "method" : "CreateTransaction",
    "params" : {
        ...
        "time" : 1399114284039, // Sat May 03 2014 15:51:24.039
        ...
    }
}

Amount — Положительное, целое число, больше нуля представляющее сумму в тийинах.

Account — Поле “account” представляет собой JSON объект. Набор полей объекта определяется бизнес – логикой конкретного сервиса мерчанта.


Пример

//для мобильного оператора

{
    "account" : {
        "phone" : "903595731"
    }
}

//для интернет провайдера

{
    "account" : {
        "login" : "shsts2645135"
    }
}

//для интернет магазина

{
    "account" : {
        "user" : "2599",
        "order" : "AC-532"
    }
}


Список получателей (Receiver)

Имя Тип Описание
id ID Идентификатор получателя в реестре Payme Business.
amount Amount Сумма платежа в тийинах.


Транзакции (Transaction)

Имя Тип Описание
id ID Идентификатор транзакции Payme Business.
time Timestamp Время создания транзакции Payme Business.
amount Amount Сумма платежа в тийинах.
account Account Счет покупателя.
create_time Timestamp Время добавления транзакции в биллинге мерчанта.
perform_time Timestamp Время проведения транзакции в биллинге мерчанта.
cancel_time Timestamp Время отмены транзакции в биллинге мерчанта.
transaction String Номер или идентификатор транзакции в биллинге мерчанта. Формат строки определяется мерчантом.
state State Состояние транзакции.
reason Reason Необязательное поле, причина отмены транзакции.
receivers Receiver[ ] Список Получателей. Необязательный параметр. В случае если Владелец приложения является Получателем, данное поле следует опустить или присвоить ему значение NULL.


Состояния транзакции (Transaction State)

Код Описание
1 Транзакция успешно создана, ожидание подтверждения (начальное состояние 0).
2 Транзакция успешно завершена (начальное состояние 1).
-1 Транзакция отменена (начальное состояние 1).
-2 Транзакция отменена после завершения (начальное состояние 2).


Граф состояний транзакции


Причина отмены транзакции (Reason)

Код Описание
1 Один или несколько получателей не найдены или не активны в Payme Business.
2 Ошибка при выполнении дебетовой операции в процессингом центре.
3 Ошибка выполнения транзакции.
4 Транзакция отменена по таймауту.
5 Возврат денег.
10 Неизвестная ошибка.


Состояния чека

Код Описание
0 Чек создан. Ожидание подтверждения оплаты.
1 Первая стадия проверок. Создание транзакции в биллинге мерчанта.
2 Списание денег с карты.
3 Закрытие транзакции в биллинге мерчанта.
4 Чек оплачен.
20 Чек стоит на паузе для ручного вмешательства.
21 Чек в очереди на отмену.
30 Чек в очереди на закрытие транзакции в биллинге мерчанта.
50 Чек отменен.