Запит проведення C2A Крок 1

{{url}}/ecom/execute_request/payments/v3/google_pay/card_to_account

Вхідні параметри:

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

Об'єкт PaymentData (шифрування зі сторони мерчанта)

paymentMethod

Тип платіжних облікових даних. Наразі CARD підтримується лише

string

Так

CARD

authMethod

Спосіб аутентифікації карткової операції.

PAN_ONLY - PAN картки

CRYPTOGRAM_3DS - криптованний PAN

string

Так

CRYPTOGRAM_3DS

pan

Номер особового рахунку, що стягується. Цей рядок містить лише цифри.

string

Так

1111222233334444

expirationMonth

Місяць закінчення терміну дії картки, де 1 означає січень, 2 означає лютий і так далі.

number

Так

10

expirationYear

Чотиризначний рік закінчення терміну дії картки, наприклад 2020.

number

Так

2025

cryptogram

Криптограма токена.

string

Ні

AVn0rK8BiDxN2D/w2j8LMAABAAA=

eciIndicator

Цей рядок не завжди присутній. Він повертається лише для транзакцій із автентифікованими маркерами пристроїв на Android (CRYPTOGRAM_3DS).

Це значення має передаватися в процесі обробки платежу.

string (1)

Ні

4

messageId

Унікальний ідентифікатор, який ідентифікує повідомлення на випадок, якщо його потрібно буде відкликати або знайти пізніше.

string

Ні

some-message-id

messageExpiration

Дата й час закінчення терміну дії повідомлення в мілісекундах UTC з епохи. Інтегратори повинні відхиляти будь-які повідомлення, термін дії яких минув.

string

Ні

1759309000000

Додаткові стандартні об'єкти для проведення Purchase

merchantRequestId

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

string(36)

Так

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

merchantId

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

string(36)

Так

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

transactionAmount

Сума платежу в копійках

string

Так

2000

desiredThreeDSMode

Ознака яка вказує, чи бажає мерчант використати 3DS в покупці чи ні.

string (50)

Так

За замовчуванням SHOULD

resultRedirectUrl

Url для редиректа клієнта після проходження 3DS аутентифікації

string (1000)

Ні

notificationUrl

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

string (1000)

Ні

notificationEncryption

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

string

Ні

true/false

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

date

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

string

Так

{{currentdateT}}.00+02:00

comment

додаткова опис операції яку заповнює клієнт мерчанта

string (1000)

Ні

///5555.25412

purpose

призначення платежу яке заповнює мерчант

string (255)

Ні

За товар

merchantComment

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

string(255)

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

Ні

merchant Comment id 1258728c1

recipientAccount

Рахунок отримувача

string

Ні

2900000000000

customerData

об'єкт з customer даними

object

Так

senderCustomerId

Id клієнта відправника

string (255)

Так

1258728c1

senderFirstName

ім'я відправника

string (30)

  • значення не може містити виключно цифри

  • не може містити крапки та інші спецсимволи

  • дозволено приймати тільки літерно-цифрові значення

  • може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“

  • дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці

  • Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027

Так

Іваненко

senderLastName

прізвище відправника

string (30)

  • значення не може містити виключно цифри

  • не може містити крапки та інші спецсимволи

  • дозволено приймати тільки літерно-цифрові значення

  • може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“

  • дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці

  • Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027

Так

Іван

senderMiddleName

по-батькові відправника

string (30)

  • значення не може містити виключно цифри

  • не може містити крапки та інші спецсимволи

  • дозволено приймати тільки літерно-цифрові значення

  • може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“

  • дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці

  • Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027

Ні

Іванович

senderEmail

пошта відправника

string (256)

Ні

senderСountry

країна відправника

string (3) ISO 3166, 804 (Ukraine)

Ні

804

senderRegion

область відправника

string (255)

Ні

Київська

senderСity

місто відправника

string (25)

Ні

Київ

senderStreet

вулиця відправника

string (35)

Ні

Січових стрільців

senderAdditionalAddress

додаткові дані адреси відправника (поверх, номер дому, квартира)

string (255)

Ні

23

senderItn

іпн відправника

string (20)

Ні

123456789

senderPassport

паспорт відправника

string (255)

Ні

АН123456

senderIp

IP адреса відправника

string (50)

Ні

123.12.12.12

senderPhone

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

string (20)

Ні

380630000000

senderBirthday

день народження відправника

string (50)

Ні

31.12.2000

senderGender

Гендер відправника

string (50)

Ні

Male/Female

senderZipCode

індекс відправника

string (50)

Ні

49000

recipientCustomerId

Id клієнта отримувача

string (255)

Ні

1258728c1

recipientFirstName

ім'я отримувача

string (30)

  • значення не може містити виключно цифри

  • не може містити крапки та інші спецсимволи

  • дозволено приймати тільки літерно-цифрові значення

  • може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“

  • дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці

  • Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027

Ні

Іваненко

recipientLastName

прізвище отримувача

string (30)

  • значення не може містити виключно цифри

  • не може містити крапки та інші спецсимволи

  • дозволено приймати тільки літерно-цифрові значення

  • може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“

  • дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці

  • Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027

Ні

Іван

recipientMiddleName

по-батькові отримувача

string (30)

  • значення не може містити виключно цифри

  • не може містити крапки та інші спецсимволи

  • дозволено приймати тільки літерно-цифрові значення

  • може приймати пробіл та дефіс, але НЕ може складатися виключно з “ “ или “-“

  • дефіс чи пробіл може бути всередині, але не може бути на початку чи кінці

  • Для символу апострофу використовуйте єдиний доступний символ utf8 - ' який в: utf 16 - u0027 utf32 - 00000027

Ні

Іванович

recipientEmail

пошта отримувача

string (256)

Ні

recipientСountry

країна отримувача

string (3) ISO 3166, 804 (Ukraine)

Ні

804

recipientRegion

область отримувача

string (255)

Ні

Київська

recipientСity

місто отримувача

string (25)

Ні

Київ

recipientStreet

вулиця отримувача

string (35)

Ні

Січових стрільців

recipientAdditionalAddress

додаткові дані адреси отримувача (поверх, номер дому, квартира)

string (255)

Ні

23

recipientItn

іпн отримувача

string (20)

Ні

123456789

recipientPassport

паспорт отримувача

string (255)

Ні

АН123456

recipientIp

IP адреса клієнта отримувача

string (50)

Ні

123.12.12.12

recipientPhone

номер телефону отримувача

string (20)

Ні

380630000000

recipientBirthday

день народження отримувача

string (50)

Ні

31.12.2000

recipientGender

Гендер отримувача

string (50)

Ні

Male/Female

recipientZipCode

індекс отримувача

string (50)

Ні

49000

Вихідні параметри

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

type

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

string

CARD_2_ACCOUNT

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

62

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

bankCode

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

string

BANK_ALLIANCE

paymentSystem

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

string

MasterCard

productType

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

string

C2A

notificationUrl

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

string

paymentServiceType

тип оплати

string

CARD/APPLE_PAY/GOOGLE_PAY

notificationEncryption

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

string

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

cardNumberMask

маскований номер карти

string

5573********0304

desiredThreeDSMode

ознака яка вказує, чи бажає мерчант використати 3DS в покупці чи ні.

string

MUST/SHOULD/MUST_NOT

threeDSMode

параметр який вказує, використовувася 3DS у покупці чи ні

string

MUST- проводимо оплату з 3DS MUST_NOT- проводимо оплату без 3DS

statusThreeDs

статус проведення 3DS

string

Y - успіший 3ds N - не успішний 3ds

threeDSServerTransId

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

string

b6c35fdb-28c1-454d-a2f3-51098c26bda4

acsTransId

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

string

3e17fabb-71e6-498e-8794-ef8c95c5ba6f

dsTransId

Id транзакціі згенерований Directory Server

string

12ebc556-82d3-4e35-9fb8-77ac18b050ea

eci

Electronic Commerce Indicator Код, який вказує рівень безпеки транзакції

string

02

processingMerchantId

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

string

AE100000

processingTerminalId

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

string

AE100000

redirect3dsUrl

url для редиректа клієнта на сторінку емітента для проходження 3DS

string

txnType

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

enum

Можливі значення: NONCVV/noncvv- при отриманні даного значення введення cvv та його перевірка не відбувається

senderCustomerId

Id клієнта відправника

string

1258728c1

senderFirstName

ім'я відправника

string

Іваненко

senderLastName

прізвище відправника

string

Іван

senderMiddleName

по-батькові відправника

string

Іванович

senderEmail

пошта відправника

string

senderCountry

країна відправника

string

Україна

senderRegion

область відправника

string

Київська

senderCity

місто відправника

string

Київ

senderStreet

вулиця відправника

string

Січових стрільців

senderAdditionalAddress

додаткові дані адреси відправника (поверх, номер дому, квартира)

string

23

senderItn

іпн відправника

string

123456789

senderPassport

паспорт відправника

string

АН123456

senderIp

ip адреса відправника

string

123.12.12.12

senderPhone

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

string

380630000000

senderBirthday

день народження відправника

string

31.12.2000

senderGender

гендер відправника

string

M

senderZipCode

індекс відправника

string

12000

senderBankCode

назва банку емітента відправника

string

BANK_ALLIANCE

senderPaymentSystem

назва мпс емітента відправника

string

MasterCard

senderCardNumberMask

маскований номер карти відправника

string

5573********0304

recipientCustomerId

Id клієнта відправника

string

1258728c1

recipientFirstName

ім'я отримувача

string

Іваненко

recipientLastName

прізвище отримувача

string

Іван

recipientMiddleName

по-батькові отримувача

string

Іванович

recipientEmail

пошта отримувача

string

recipientCountry

країна отримувача

string

Україна

recipientRegion

область отримувача

string

Київська

recipientCity

місто отримувача

string

Київ

recipientStreet

вулиця отримувача

string

Січових стрільців

recipientAdditionalAddress

додаткові дані адреси отримувача (поверх, номер дому, квартира)

string

23

recipientItn

іпн отримувача

string

123456789

recipientPassport

паспорт отримувача

string

АН123456

recipientIp

ip адреса отримувача

string

123.12.12.12

recipientPhone

номер телефону отримувача

string

380630000000

recipientBirthday

день народження отримувача

string

31.12.2000

recipientGender

гендер отримувача

string

M

recipientZipCode

індекс отримувача

string

12000

recipientBankCode

назва банку емітента отримувача

string

BANK_ALLIANCE

recipientPaymentSystem

назва мпс емітента отримувача

string

MasterCard

recipientCardNumberMask

маскований номер карти отримувача

string

5573********0304

Приклад тіла запиту

{
	"paymentData": "{{encryptedPaymentData}}",
	"merchantRequestId": "{{requestUUIDT}}",
	"desiredThreeDSMode": "MUST_NOT",
	"notificationUrl": "https://api-ecom-prod.bankalliance.ua/mock",
	"resultRedirectUrl": "",
	"purpose": "purpose",
	"comment": "comment",
	"merchantId": "137d9304-0368-11ed-b939-0242ac120002",
	"currencyCode": "980",
	"transactionAmount": "100",
	"customerData": {
        "senderCustomerId": "1234567",
        "senderFirstName": "John",
        "senderLastName": "Doe",
        "senderMiddleName": "Fall",
        "senderEmail": "test@gmail.com",
        "senderCountry": "sender_country",
        "senderRegion": "sender_region",
        "senderCity": "sender_city",
        "senderStreet": "sender_street",
        "senderAdditionalAddress": "N 6",
        "senderItn": "12345",
        "senderPassport": "12345",
        "senderIp": "165.222.87.224",
        "senderPhone": "380967542344",
        "senderBirthday": "12/12/2000",
        "senderGender": "Male",
        "senderZipCode": "12345",
        "recipientCustomerId": "1234567",
        "recipientFirstName": "Yura",
        "recipientLastName": "Bura",
        "recipientMiddleName": "TestMiddle",
        "recipientEmail": "res@gmail",
        "recipientCountry": "804",
        "recipientRegion": "res_reg",
        "recipientCity": "res_dnipro",
        "recipientStreet": "res_street",
        "recipientAdditionalAddress": "res_addres",
        "recipientItn": "res_iin",
        "recipientPassport": "res_pasport",
        "recipientIp": "165.222.87.224",
        "recipientPhone": "380967542344",
        "recipientBirthday": "12/12/2000",
        "recipientGender": "Female",
        "recipientZipCode": "77777"
    },
	"date": "{{currentdateT}}.00+00:00"
}

Приклад тіла відповіді без 3DS

{
    "type": "CARD_2_ACCOUNT",
    "rrn": "410213187859",
    "purpose": "purpose",
    "comment": "comment",
    "coinAmount": null,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "17128431233853bBBN9JV2NG",
    "ecomOperationId": "60ae2b45-995a-42c4-bdf5-76e3e8c2a85b",
    "merchantName": null,
    "approvalCode": null,
    "status": "SUCCESS",
    "transactionType": 62,
    "merchantRequestId": "42840103-507e-4541-857d-d66f3ae52332",
    "transactionCurrency": "980",
    "merchantCommission": null,
    "createDateTime": "2024.09.19 15:29:25.675",
    "modificationDateTime": "2024.09.19 15:29:25.675",
    "transactionResponseInfo": {
        "actionCode": null,
        "responseCode": null,
        "description": "Операція успішна"
    },
    "bankCode": null,
    "paymentSystem": null,
    "productType": "C2A",
    "notificationUrl": "https://webhook.site/55533b14-b72b-4d6b-b9bc-1906103240ba",
    "paymentServiceType": "GOOGLE_PAY",
    "notificationEncryption": false,
    "senderCardNumberMask": null,
    "desiredThreeDSMode": "MUST_NOT",
    "threeDSMode": "MUST_NOT",
    "statusThreeDs": null,
    "threeDSServerTransId": null,
    "redirect3dsUrl": null,
    "recipientAccount": null,
    "senderCustomerId": null,
    "senderFirstName": null,
    "senderLastName": null,
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": null,
    "senderRegion": null,
    "senderCity": null,
    "senderStreet": null,
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "recipientCustomerId": null,
    "recipientFirstName": null,
    "recipientLastName": null,
    "recipientMiddleName": null,
    "recipientEmail": null,
    "recipientCountry": null,
    "recipientRegion": null,
    "recipientCity": null,
    "recipientStreet": null,
    "recipientAdditionalAddress": null,
    "recipientItn": null,
    "recipientPassport": null,
    "recipientIp": null,
    "recipientPhone": null,
    "recipientBirthday": null,
    "recipientGender": null,
    "recipientZipCode": null
}

Приклад тіла відповіді з 3DS

{
    "type": "CARD_2_ACCOUNT",
    "rrn": null,
    "purpose": "purpose",
    "comment": "comment",
    "coinAmount": null,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712843252781OgXAcDp-0Gn",
    "ecomOperationId": "ec2ce45b-9a97-4507-980a-f8249e9ef84f",
    "merchantName": null,
    "approvalCode": null,
    "status": "REQUIRED_3DS",
    "transactionType": 62,
    "merchantRequestId": "a8fec362-b5ed-42c7-b2fd-c89e9d0ec508",
    "transactionCurrency": "980",
    "merchantCommission": null,
    "createDateTime": "2024.09.19 15:29:25.675",
    "modificationDateTime": "2024.09.19 15:29:25.675",
    "transactionResponseInfo": {
        "actionCode": null,
        "responseCode": null,
        "description": null
    },
    "bankCode": null,
    "paymentSystem": null,
    "productType": "C2A",
    "notificationUrl": "https://webhook.site/cbf8c83a-ee1e-47c6-899c-eca5731ff084/mock",
    "paymentServiceType": "GOOGLE_PAY",
    "notificationEncryption": false,
    "senderCardNumberMask": null,
    "desiredThreeDSMode": "MUST",
    "threeDSMode": "MUST",
    "statusThreeDs": null,
    "threeDSServerTransId": "b6c35fdb-28c1-454d-a2f3-51098c26bda4",
    "redirect3dsUrl": null,
    "recipientAccount": null,
    "senderCustomerId": null,
    "senderFirstName": null,
    "senderLastName": null,
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": null,
    "senderRegion": null,
    "senderCity": null,
    "senderStreet": null,
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "recipientCustomerId": null,
    "recipientFirstName": null,
    "recipientLastName": null,
    "recipientMiddleName": null,
    "recipientEmail": null,
    "recipientCountry": null,
    "recipientRegion": null,
    "recipientCity": null,
    "recipientStreet": null,
    "recipientAdditionalAddress": null,
    "recipientItn": null,
    "recipientPassport": null,
    "recipientIp": null,
    "recipientPhone": null,
    "recipientBirthday": null,
    "recipientGender": null,
    "recipientZipCode": null
}
PreviousC2ANextЗапит проведення c2a Крок 2 (3DS)

Last updated