UAPAY - національний платіжний сервіс

Створення платежу (Init Charge Card)

Метод для створення платежу на поповнення карти в 2 кроки. Це - перший крок - створення платежу в базі даних.
Чекає sessionId для авторизації та даних по самому платежу - зовнішній ідентифікатор, карта, сума ...
Сума переказу може передаватися 2-ма варіантами:

  1. Передачею загальної суми платежу (сума переказу + сума комісії) в параметрі data.totalAmount
  2. Передачею суми переказу і комісії в окремих полях data.amount и data.commissionAmount. В даному випадку обидва поля обов'язкові. Цей варіант потрібен для перевірки вірності розрахунку комісії

URI

POST /api/funding/initChargeCard

Запит:

Ключ
Опис
Тип
Чи обов'язковий параметр?
Приклад
params



sessionIdid сесії кліентаstring, uuidтак

"f22b8709-18c9-40e1-a4fa-77aa5b524fc6"

data



externalIdId операції у зовнішній системі. Повинен бути унікальнимstringтак"xyz123"
cardTo.panПан карти для поповненняstring, panякщо немає cardTo.id"1111222233334444"
cardTo.idId карти для поповненняstring, uuidякщо немає cardTo.pan

"004ce685-4948-407a-a11a-57151e8d1c12"

totalAmountСума поповнення в копійках (тіло і комісія)integerякщо немає amount10000
amount

Сума тіла перекладу поповнення в копійках

integerякщо немає totalAmount10000

commissionAmount

Сума комісії перекладу в копійкахintegerякщо немає totalAmount10000
currencyЦифровий код валютиintegerтак980
descriptionДодатковий опис до переказуstringні"За послуги"


Приклад поповнення по ПАНу картки
{
    "params": {
        "sessionId": "f22b8709-18c9-40e1-a4fa-77aa5b524fc6"
    },
    "data": {
        "externalId": "100",
        "cardTo": {
            "pan": "1111222233334444"
        },
        "totalAmount": 10600,
        "currency": 980,
		"description": "3809711122233"
    }
}


Приклад поповнення по id карты
{
	"params": {
		"sessionId": "f22b8709-18c9-40e1-a4fa-77aa5b524fc6"
	},
	"data": {
		"externalId": "101",
		"cardTo": {
			"id": "004ce685-4948-407a-a11a-57151e8d1c12"
		},
	"amount": 10000,
	"commissionAmount": 600,
	"currency": 980
	}
}

Відповідь:

Ключ
Опис
Тип
Приклад
status

Статус. 0 - помилка, 1 - успіх

integer

1

data




id

id операції в системі UAPAY

string, uuid

"004ce685-4948-407a-a11a-57151e8d1bd7"

externalId

Id операції у зовнішній системі. Повинен бути унікальним

string

"xyz123"


Приклад успішної відповіді
{
    "status": 1,
    "data": {
        "id": "9d970a89-cf1f-4f29-86f4-3e13d47139cc",
        "externalId": "100"
    }
}

UAPAY - національний платіжний сервіс
pay@uapay.ua