REFUND

{{url}}/ecom/jws/payments/refund_v1

Поверненіня застосовується у разі необхідності повернути кошти клієнту по успішно здійсненій операції платежу. В результаті даної операції кошти будуть повернені на ту карту, з якої проводився розрахунок по оригінальній операції.

Вхідні параметри частини payload JWS :

Параметр
Опис
Формат даних
Обов'язковість
Приклад

merchantRequestId

унікальний ідентифікатор згенерований системою мерчанта, використовується для можливості дізнатися статусоперації якщо запит закінчився невідомою помилкою чи дісконектом

string (36)

Так

137d9304-0368-11ed-b939-0242ac120002

merchantId

Id мерчанту згенерований в Єкомі

string(36)

Так

137d9304-0368-11ed-b939-0242ac120002

operationId

ідентифікатор платіжної операції згенерований КБ по якій проводиться повернення

string

Так

137d9304-0368-11ed-b939-0242ac120002

coinAmount

сума повернення в копійках

string

Так

2500

date

дата та час платежу

string

Так

{{currentdateT}}.00+00:00

notificationUrl

url, на який буде відправлено CallBack

string (1000)

Ні

https://merchant.notification_url

notificationEncryption

ознака криптування данних CallBack

string

Ні

true/false

Якщо параметр не передано або передано false, то дані в CallBack будуть не закриптовані

merchantComment

додаткова інформація\коментар мерчанта по замовленню

string(255)

a-zA-Z0-9 ,.;:@#$%'-=+1,256$

НІ

merchant Comment id 1258728c1

Вихідні параметри частини payload JWS :

Параметр
Опис
Формат даних
Приклад

type

тип транзакції

string

REFUND

rrn

rrn номер транзакції в МПС

string

2554256963

purpose

призначення платежу

string

За товар

comment

коментар

string

тест

coinAmount

сума платежу

int

2000

merchantId

Id мерчанту

string

137d9304-0368-11ed-b939-0242ac120002

operationId

Id транзакціі

string

1712844596346b9F-WwrWZpq

ecomOperationId

Id транзакціі в системі Ecom

string

8c3303e9-7396-43b8-af4e-31d9facdde9b

merchantName

найменування торговця

string

KB test terminal

approvalCode

код авторизаціі

string

39203

status

статус транзакціі

string

SUСCESS FAIL PENDING REQUIRED_3DS DESIRED_THREEDS_MODE_ERROR

transactionType

тип транзакції у цифровому значенні

string

76 - повернення по операції Purchase 213 - повернення по операції Preauth 214 - повернення по операції Complition

merchantRequestId

Id запиту мерчанта

string

72837906-f526-4aef-8d11-58d80b44cb75

transactionCurrency

валюта платежу

string

980

merchantCommission

сума комісії

string

2

createDateTime

дата створення платежу

string

2024.09.19 15:29:25.675

modificationDateTime

дата модифікаціі платежу

string

2024.09.19 15:29:25.675

actionCode

код відповіді

string

0

responseCode

деталі відповіді

string

0

description

опис відповіді

string

approved

processingMerchantId

Id мерчанту в ПЦ

string

AE100000

processingTerminalId

Id терміналу в ПЦ

string

AE100000

bankCode

назва банку емітента

string

BANK_ALLIANCE

paymentSystem

назва мпс емітента

string

MasterCard

productType

тип продукту термінала

string

PURCHASE

notificationUrl

url, на який відправлено CallBack

string

paymentServiceType

тип оплати

string

CARD/APPLE_PAY/GOOGLE_PAY

notificationEncryption

ознака криптування данних CallBack

string

true/false Якщо параметр не передано або передано false, то дані в CallBack будуть не закриптовані

originalOperationId

id під яким створено оригінальну операцію

string

1712843529623cHAHkmt-G5u

originalCoinAmount

Сума оригінального платежу

int

100

originalEcomOperationId

id в системі Еком під яким створено оригінальну операцію

string

c25ee1cb-a052-439b-b075-bcb632615b11

rrnOriginal

rrn номер оригінальної транзакції в МПС

string

123456789

Приклади :

JWS Payload — тіло запиту перед підписанням

JWS Payload — тіло відповіді перед підписанням без 3дс
JWS Payload — тіло відповіді перед підписанням з 3дс

Last updated