Page tree
Skip to end of metadata
Go to start of metadata

Для обробки транзакцій за технологією Emv 3DS на захищеній сторінці UPC необхідно додатково передати розширені дані про клієнтів, в поле 3DSv2Data значення вказані в форматі json.

Ці дані будуть передані в платіжні системи Directory Servers, а від них в ACS для подальшого аналізу емітентом, і рішення вимагає додаткової перевірки клієнта чи ні.


Tag nameНазва елемента

Опис

Значення
acctInfo
















  
chAccAgeInd

Тривалість перебування власника картки у рахунку у 3DS Requestor.

Прийняті значення:

  • 01 = Немає рахунку (виїзд гостя)
  • 02 = Створено під час цієї транзакції
  • 03 = менше 30 днів
  • 04 = 30-60 днів
  • 05 = Більше 60 днів
chAccChange

Дані про останню зміну рахунку власника картки в 3DS Requestor. Включаючи адресу для виставлення рахунку або доставки, додано новий платіжний рахунок або нових користувачів.

Формат прийнятий: РРРРММДД


chAccChangeIndТривалість часу з моменту останньої зміни даних облікового запису власника картки у 3DS Requestor. Включаючи адресу для виставлення рахунку або доставки, додано новий платіжний рахунок або нових користувачів.

Прийняті значення:

  • 01 = Змінено під час цієї транзакції
  • 02 = Менше 30 днів
  • 03 = 30-60 днів
  • 04 = Більше 60 днів
chAccDateДата, коли власник картки відкрив рахунок у 3DS Requestor.Формат прийнятий: РРРРММДД
chAccPwChangeДату, коли в обліковому записі власника картки в 3DS Requestor було змінено пароль або скинуто обліковий запис.Формат прийнятий: РРРРММДД
chAccPwChangeIndВказує тривалість часу, після того як на рахунку власника картки у 3DS Requestor було змінено пароль або скинуто обліковий запис.

Прийняті значення:

  • 01 = Без змін
  • 02 = Змінено під час цієї транзакції
  • 03 = менше 30 днів
  • 04 = 30-60 днів
  • 05 = Більше 60 днів
nbPurchaseAccountКількість покупок за цим рахунком власника картки протягом попередніх шести місяців.
paymentAccAgeДата зарахування платіжного рахунку на рахунок власника картки у 3DS Requestor.
paymentAccIndВказує тривалість часу, протягом якого платіжний рахунок був зареєстрований на рахунку власника картки у 3DS Requestor

Прийняті значення:

  • 01 = Немає рахунку (виїзд гостя)
  • 02 = Під час цієї транзакції
  • 03 = менше 30 днів
  • 04 = 30-60 днів
  • 05 = Більше 60 днів
provisionAttemptsDay

Кількість спроб додати картку за останні 24 години.


shipAddressUsage

Дата, коли адреса доставки, використана для цієї транзакції, була вперше використана разом із 3DS Requestor.


shipAddressUsageInd

Вказує, коли адреса доставки, використана для цієї транзакції, була вперше використана разом із 3DS Requestor.

Прийняті значення:

  • 01 = Ця транзакція
  • 02 = Менше 30 днів
  • 03 = 30-60 днів
  • 04 = Більше 60 днів
shipNameIndicator

Вказує, чи Ім'я власника картки на рахунку ідентичне імені доставки, що використовується для цієї транзакції.

Прийняті значення:

  • 01 = Ім'я рахунку, ідентичне імені доставки
  • 02 = Ім'я рахунку відрізняється від імені доставки
suspiciousAccActivity

Вказує, чи зазнавав 3DS Requestor підозрілу активність (включаючи попереднє шахрайство) на рахунку власника картки.

Прийняті значення:

  • 01 = Підозрілої діяльності не спостерігалося
  • 02 = Помітна підозріла активність
txnActivityDay

Кількість трансакцій (успішних та скасованих) для цього рахунку власника картки за допомогою 3DS Requestorна всіх платіжних рахунках за попередні 24 години.


txnActivityYear

Кількість транзакцій (успішних та скасованих) для цього рахунку власника картки за допомогою 3DS Requestor на всіх платіжних рахунках у попередньому році.


acctNumber

Номер рахунку, який буде використовуватися в запиті на авторизацію для здійснення платіжних операцій. Може бути представлений PAN, маркер.


acctType

Вказує тип рахунку

  • 01 = Не застосовується
  • 02 = Кредит
  • 03 = Дебет
cardExpiryDate

Дата закінчення терміну дії PAN


cardHolderInfo                   billAddrCity

Місто виставлення рахунку Власника картки, пов’язане з картою, яка використовується для цієї покупки.

(pa: обов’язково, якщо ринковий або регіональний мандат не обмежує надсилання цієї інформації. npa: Обов’язковий (якщо доступний), якщо ринковий або регіональний мандат не обмежує надсилання цієї інформації.)


billAddrCountry

Країна адреси виставлення рахунку Власника картки, пов’язана з картою, яка використовується для цієї покупки.


billAddrLine1

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

  
billAddrLine2

Другий рядок вуличної адреси або еквівалентної місцевої частини адреси виставлення рахунку Власника картки, пов’язаної з карткою, що використовується для цієї покупки.


billAddrLine3

Третій рядок вуличної адреси або еквівалентної місцевої частини адреси виставлення рахунку Власника картки, пов’язаної з карткою, що використовується для цієї покупки.


billAddrPostCode

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


billAddrState

Штат або провінція адреси виставлення рахунку Власника картки, пов’язаної з карткою, що використовується для цієї покупки.


cardholderName

Ім'я власника картки.


email

Адреса електронної пошти, пов’язана з обліковим записом, який або введений Власником картки, або записаний у 3DS Requestor


homePhone

Код країни, довжина 1-3

Абонент; макс. довжина 15

Example'homePhone':{‘Cc’:’044’,‘Subscriber’:’55555555’}
mobilePhone
Example' mobilePhone':{‘Cc’:’044’,‘Subscriber’:’55555555’}
shipAddrCity

Міська частина адреси доставки, яку запитує Власник картки.


shipAddrCountry

 


shipAddrLine1

 


shipAddrLine2

 


shipAddrLine3

 


shipAddrPostCode

 


shipAddrState

 


workPhone

 


merchantId

Ідентифікатор продавця, призначений еквайєром.


merchantRiskIndicato        deliveryEmailAddress

 


deliveryTimeframe

Позначає терміни доставки товарів.

Прийняті значення:

  • 01 = Електронна доставка
  • 02 = доставка в той же день
  • 03 = доставка на ніч
  • 04 = Дводенна або більше доставка
giftCardAmount

 


giftCardCount

 


giftCardCurr

 


preOrderDate

 


preOrderPurchaseInd

 


reorderItemsInd

 


shipIndicator

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

Прийняті значення:

  • 01 = Надіслати на платіжну адресу власника картки
  • 02 = Надіслати на іншу підтверджену адресу у файлі продавця
  • 03 = Надіслати на адресу, яка відрізняється від платіжної адреси власника картки
  • 04 = "Доставка в магазин" / отримання в місцевому магазині (Адреса магазину повинна бути заповнена в полях адреси доставки)
  • 05 = Цифрові товари (включає онлайн-послуги, електронні подарункові картки та коди погашення)
  • 06 = Квитки на подорожі та події, не відправлені
  • 07 = Інше (наприклад, ігри, цифрові послуги, що не постачаються, передплата на emedia тощо)
priorTransID 

Ідентифікатор транзакції сервера 3DS для попередньої аутентифікованої транзакції власника картки.

example: 59ae264e-b0f4-43c7-870e-4d14bd52806e
threeRIInd 

Вказує тип запиту 3RI

Прийняті значення:

  • 01 = Повторна транзакція
  • 02 = транзакція розстрочки
  • 03 = Додати картку
  • 04 = Зберігати інформацію про картку
  • 05 = Перевірка рахунку

Приклад web-формы для передачі:

<form action="https://ecg.test.upc.ua/go/enter" method="POST">
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
	<input name="Version" type="hidden" value="1">
	<input name="MerchantID" type="hidden" value="1111111">
	<input name="TerminalID" type="hidden" value="E1111111">
	<input name="TotalAmount" type="hidden" value="1000">
	<input name="Currency" type="hidden" value="980">
	<input name="locale" type="hidden" value="ru">
	<input type="HIDDEN" name="PurchaseTime" value="150611110821">
	<input name="OrderID" type="hidden" value="121sdsdss2sd">
	<input name="PurchaseDesc" type="hidden" value="tran test">
	<input name="Signature" type="hidden" value="">
	<input name="3DSv2Data " type="hidden" value="{acctInfo:{
		'chAccAgeInd':'03',
		'chAccChange':'20160712',
		'chAccChangeInd':'04',
		'chAccDate':'20140328',
		'chAccPwChange':'20170328',
		'chAccPwChangeInd':'02',
		'nbPurchaseAccount':'11',
		'paymentAccAge':'20160917',
		'paymentAccInd':'02',
		'provisionAttemptsDay':'3',
		'shipAddressUsage':'20160714',
		'shipAddressUsageInd':'02',
		'shipNameIndicator':'02',
		'suspiciousAccActivity':'02',
		'txnActivityDay':'1',
		'txnActivityYear':'21'},
		'acctType':'03',
		'authenticationInd':'01',
		'authenticationInfo':{
			'threeDSReqAuthData':'login GP',
			'threeDSReqAuthMethod':'02',
			'threeDSReqAuthTimestamp':'201711071307'
		},
		'cardHolderInfo':{
				'billAddrCity':'Sydney',
				'billAddrCountry':'036',
				'billAddrLine1':'Unit 1',
				'billAddrLine2':'123 Street Suburb',
				'billAddrLine3':'abc Line 3',
				'billAddrPostCode':'2000',
				'billAddrState':'NSW',
				'cardholderName':'Suda Ichiro',
				'email':'abc@123.com',
			'homePhone':{
				'cc':'61',
				'subscriber':'90123917131'
			},
			'mobilePhone':{
				'cc':'61',
				'subscriber':'0421522329'
			},
			'workPhone':{
				'cc':'61',
				'subscriber':'89102183192'
				},
			'shipAddrCity':'Sydney',
			'shipAddrCountry':'036',
			'shipAddrLine1':'Unit 1',
			'shipAddrLine2':'123 Street',
			'shipAddrLine3':'abc Line 3',
			'shipAddrPostCode':'2000',
			'shipAddrState':'NSW'
		},
		'challengeInd':'01',
		'eventCallbackUrl':'http://localhost:8082/3ds-notify',
		'merchantId':'123456789012345',
		'merchantRiskIndicator':{
			'deliveryEmailAddress':'test@123.com',
			'deliveryTimeframe':'02',
			'giftCardAmount':'123',
			'giftCardCount':'02',
			'giftCardCurr':'840',
			'preOrderDate':'20170519',
			'preOrderPurchaseInd':'02',
			'reorderItemsInd':'01','shipIndicator':'01'},
			'purchaseAmount':'200','purchaseCurrency':'036',
			'purchaseDate':'20190521104643',
			'purchaseInstalData':'24',
			'transType':'03'
		}">
	<input type="submit">
</form>


  • No labels