Ви знаходитеся тут: Головна / Подключение Ecommerce / eCommerce xml

eCommerce xml

створив(ла) Igor Uleschenko Востаннє змінено: Лис 05, 2019 15:38

 

UKRAINIAN PROCESSING CENTER

Kyiv

 

 

           

logo_ecommerce_3.jpg
 

Тестирование приема платежей
посредством обмена XML сообщениями.

 

 

 

 

 

 

Version: 1.3

 

2017

 

 

Входящая информация

 

Перед началом реального функционирования электронной торговой системы разработчикам этой системы необходимо выполнить работы по программированию интерфейса взаимодействия с платежным сервером. Для этого необходимо в процесинговом центре  получить следующие данные:

 

            - Merchant ID

            - Terminal ID

            - Сертификат платежного сервера UPC для аутентификации ответов

            - Адрес, логин и пароль для входа в административную панель

 

Возможные типы запросов:

  • Проверка на участие карты в программе SecureCode/3dSecure (XMLMPIRequest);
  • Преавторизация (Preauthorization);
  • Поставторизация (Postauthorization);
  • Авторизация (Authorization);
  • Возврат/Реверсал (Refund);
  • Запрос состояния транзакции (TransactionStateReq).
  • Рекуррентный платеж (Recurrent)

 

Примечание:

Обмен xml сообщениями осуществляется обязательно с цифровыми подписями.
Тег <Signature></ Signature> указан в сокращенной форме, поскольку метод формирования подписи общедоступный, и не входит в рамки тестирования функционала

При выполнении доработки /тестирования разработчик должен заполнять запросы своими данными (MID/TID, OrderID …)

 

Формат и описание элементов

 

Родительские элемент Дочерний элемент Формат Описание
RequestData MerchantID n7 Идентификатор торговца
TerminalID an8 Идентификатор терминала
Invoice OrderID ans1..20 Идентификатор заказа в системе. Должен быть уникальным.
Date N12 Время формирования запроса в формате yyMMddHHmmss
TotalAmount N1..12 Сумма транзакции в минимальных единицах валюты.
Currency N3 Код валюты по ISO 4217
Description ans1…512 Описание
Card CardNum N10…19 Номер карты в открытом виде
CardType Зарезервировано, не используется
ExpYear N4 Год даты истечения действия карты
ExpMonth N2 Месяц даты истечения действия карты
CVNum N3 CVC2/CVV2
NameOnCard Зарезервировано, не используется
ExtData Зарезервировано, не используется
Card Зарезервировано, не используется
RefundData RefundAmount n1..12 Сумма возврата в минимальных единицах валюты.
AuthorizationRef ApprovalCode an1..6 Код авторизации
PreauthorizationRef Rrn n12 Reference retrieval number
TransactionResult TranCode n3
ApprovalCode an1..6 Код авторизации
Comment asn64 Комментарий к коду завершения
CVResult A2 Значение проверки CVNum , может принимать значения ‘M’, ‘P’, ‘U’, ‘N’. Вторим елементом значения может бить цифра или буква указивающая на результат проверки  CAVV (список значений ниже )
HostCode n3 Код завершения процессинговой системы ( отличается от TranCode )
ExtData n3 Дополнительные данные

n – numeric decimal digit, 0-9        s – special character      a – alphabetic

 

1 - CAVV failed validation – authentication.

2 - CAVV passed validation – authentication.

3 - CAVV passed validation – attempted authentication.

A 3-D Secure Authentication Results Code value of 07 from the Issuer Attempts

Server indicates that authentication was attempted.

Issuer attempts CAAV key was used to generate the CAVV.

4 - CAVV failed validation – attempted authentication.

A 3-D Secure Authentication Results Code value of 07 from the Issuer Attempts

Server indicates authentication was attempted.

Issuer attempts CAAV key was used to generate the CAVV.

5 - Not used (reserved for future use).

6 - CAVV not verified, issuer not participating in CAVV verification (See Note 1).

7 - CAVV failed verification – attempted authentication.

3-D Secure Authentication Results Code value of 07 from Visa Attempts Service indicates that an authentication attempt was performed.

Visa CAAV attempts key was used to generate the CAVV.

8 - CAVV passed verification – attempted authentication.

3-D Secure Authentication Results Code value of 07 from Visa Attempts Service indicates that an authentication attempt was performed.

Visa CAAV attempts key was used to generate the CAVV.

9 - CAVV failed verification – attempted authentication.

A 3-D Secure Authentication Results Code value of 08 from Visa Attempts Service indicates that an authentication attempt was performed when the issuer ACS was not available.

Visa CAAV attempts key was used to generate the CAVV.

A - CAVV passed verification – attempted authentication.

A 3-D Secure Authentication Results Code value of 08 from Visa Attempts Service indicates that an authentication attempt was performed when the issuer ACS was not available.

Visa CAAV attempts key was used to generate the CAVV.

B - CAVV passed verification – attempted authentication, no liability shift (See Note 1).

C - CAVV was not verified – attempted authentication (See Note 1).

If 3-D Secure Authentication Results Code value is 07 in the CAVV and the issuer did not return a CAVV results code in the authorization response, or Field 44.13 = 0 in the response message and the CAVV encryption keys do not exist in V.I.P., V.I.P. sets the value to C in Field 44.13.

D - CAVV was not verified – cardholder authentication (See Note 1).

 

Порядок выполнения запросов

 

mpi1.jpg

1 . Проверка на участие карты в программе SecureCode/3dSecure (XMLMPIRequest). Запрос является опциональным и не должен влиять на дальнейшее прохождение транзакции.

2. В зависимости от выбранной схемы роботы, выполняется либо запрос преавторизация (Preauthorization) либо непосредственно авторизация (Authorization).

3. Если в выбранной схеме торговец использует преавторизацию (Preauthorization) то следующим этапом является завершение преавторизации - поставторизация (Postauthorization).  Команда может быть успешно выполнена в 30-дневный период от момента совершения авторизации (Preauthorization).

4. Запрос возврата/Реверсала (Refund) выполняется только на операцию авторизация (Authorization/Postauthorization).

5. Запрос состояния транзакции (TransactionStateReq) можно выполнить как на операцию преавторизация (Preauthorization) так и на операцию авторизация (Authorization/Postauthorization).

.

.

.

.

.

.

.

.

.

.

.

Использование функций Merchant Plug-in Interface

 

mpi2.jpg

 

  1. Покупатель с помощью своего web-браузера заходит на сайт продавца (мерчанта), выбирает необходимый товар и вводит номер карты, срок действия, CVV2 код.