UAPAY - національний платіжний сервіс
Отримання даних по інвойсу (Invoices show)
Метод для показу даних інвойсу
URI
POST api/invoicer/invoices/show
Запит:
Ключ | Опис | Тип | Обов'язковість | Приклад |
---|---|---|---|---|
params | ||||
sessionId | id сесії клієнта | string, uuid | так | "00684a7f-3d5c-43f4-b4d1-ea994226be9c" |
id | id інвойсу | string, uuid | так | "6e391161-94ff-41a3-bd22-c6d77509bff6" |
Приклад запиту
{
"params": {
"sessionId": "00684a7f-3d5c-43f4-b4d1-ea994226be9c",
"id": "5ecb426d-185b-40e8-857a-e40c9864e5de"
}
}
Відповідь:
Ключ | Опис | Тип | Приклад |
---|---|---|---|
status | Статус. 0 - помилка, 1 - успіх | integer | 1 |
data | |||
id | id інвойсу | string, uuid | "edacfce8-eb97-4f4f-8fa2-0fb044932ac3" |
invoiceNumber | номер інвойсу | integer | 14 |
clientId | id клієнта | integer | 1 |
systemType | тип платіжної системи | string | "P2P"|"ECOM"|"BILLER" |
amount | сума платежу | integer | 100 |
reusability | параметр багаторазового використання інвойсу | boolean | true |
description | опис призначення інвойсу | string | "тестовый платеж" |
invoiceStatus | статус інвойсу | string | "ACTIVE" или "'INACTIVE'" |
redirectUrl | адреса перенаправлення | string | |
callbackUrl | адреса відправки пост-відповідей | string | |
createdAt | дата створення інвойсу | integer | |
type | тип інвойсу | string | "PAY", "HOLD", "SUBSCRIBE" |
електронна пошта, задана при створенні інвойсу | string | "test@uapay.ua" | |
extraInfo | поле для передачі додаткової інформації щодо інвойсу | object | |
serviceData[].{} | масив даних по сервісах (тільки для systemType = "ECOM", крім type = "SUBSCRIBE") ['serviceId','destination','destinationName','account','mfo','okpo','bankName','description','amount'] | ||
payments | дані щодо платежів за цим інвойсом | array | "[ ]" |
payments[].{} | об'єкт з даними за платежами ['invoiceId','paymentId','number', 'receiptId', 'amount','commission','currency','cardFromMasked','cardToMasked','cardFromId','cardToId','sendOperationId', 'receiveOperationId','paymentStatus','status','paidAt','reversedAt','finishedAt','canceledAt','createdAt','updatedAt', 'chequeLink'] | ||
clientName | назва клієнта | string | |
cardToId | id карти зарахування | string, uuid | |
recurringData | дані за рекурентними платежами | object | |
recurringData.{}.endSubscribeDate | Дата завершення підписки | string | |
recurringData.{}.prevPaymentDate | Дата останнього платежу по інвойсу | string | |
recurringData.{}.nextPaymentDate | Дата наступного платежу по інвойсу | string | |
extraPayerProvidedData |
| object |
|
extraPayerProvidedData.{}.phone | номер телефону отриманий при створенні платежу | string | "380434343444" |
extraPayerProvidedData.{}.email | email отриманий при створенні платежу | string | "kjdskdj@dsdl.cl" |
Возможные статусы платежей:
Статус | Описание |
---|---|
FINISHED | Платіж завершено успішно, гроші відправлено одержувачу |
HOLDED | Необхідно підтвердження. Для завершення списання коштів потрібно виконати підтвердження. |
CANCELED | Процес оплати не завершений та платіж був відхилений (обірвалося з'єднання, платіж зупинений на проміжному етапі з вини платника). |
REVERSED | Платіж повернуто, кошти повернулися відправнику. |
REJECTED | Платіж не відбувся з технічних причин. |
NEEDS_CONFIRMATION | Платіж очікує підтвердження (лукап або 3ds). |
PENDING | Платіж знаходиться в стані оплати (проміжний статус) |
Приклад відповіді
UAPAY - національний платіжний сервіс
pay@uapay.ua