Тестування функціоналу Money Transfer
UKRAINIAN PROCESSING CENTER
Kyiv
Тестування функціоналу
Money Transfer
Версия 1.6
2017
Типи запитів
CardZoneRequest
TransactionRequest
- Card-to-Card
- Card-To-Account
- Reversal on funding
- Account-To-Card
StatusRequest
Приклад повного циклу для операції Card-to-Card
З 3D-secure
- Визначення типу переказу за допомогою сервісу Card Zone
- Визначення технології карти відправника
- <Enrolled>Y</Enrolled> 3D-secure
- <Enrolled>U</Enrolled> не можливо визначити
- Передача параметрів PaReq, TermUrl через HTTP POST на адресу AcsURL
- Запит на отримання авторизаційних даних
- Переказ з карти на карту CardToCard (карта відправника з 3D-secure)
Без 3D-secure з Look-up Authorization (не обов’язково)
- Визначення типу переказу за допомогою сервісу Card Zone
- Look-up авторизація
- Визначення технології карти відправника (3D- secure ?)
- <Enrolled>N</Enrolled>
- <Enrolled>U</Enrolled> не можливо визначити
- Переказ з карти на карту CardToCard (карта відправника не використовує 3D-secure)
- Cross-boarder
- У всіх запитах інформація вказана жирним шрифтом змінюється клієнтською стороною у випадку запиту та серверною частиною у випадку відповіді.
- Для тестування потрібно мати такі дані:
- MerchantId
- TerminalId
- URL для надсилання запитів (вказані нижче)
- Тестові номери кредитних карт
- Всі запити обов’язково надсилаються з цифровим підписом, а відповіді сервера перевіряються на валідність підпису.
- Тег <Signature></Signature> вказано в скороченій формі, оскільки метод формування підпису загально доступний і не входить в рамки тестування функціоналу MT-UPC.
Перевірка сервісу Card Zone
Запит TEST url - https://ecg.test.upc.ua/mt/card_zone WORK url - https://secure.upc.ua/mt/card_zone |
Очікуваний результат (УСПІХ) |
Результат тесту |
<CardZoneRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>123</TrackingId> <CardFromNumber>5409530000000077</CardFromNumber> <CardToNumber>5559490000000148</CardToNumber> <Signature></Signature> </CardZoneRequest> |
<?xml version="1.0" encoding="UTF-8"?> <CardZoneResponse> <Status> <Code>000</Code> <Message>Operations on this card(s) are allowed</Message> </Status>
<CardFromInfo> <CountryCode>UKR</CountryCode> <CardType>MCS</CardType> <Brand>MAST</Brand> <CardZone>DOMESTIC</CardZone> </CardFromInfo>
<CardToInfo> <CountryCode>RUS</CountryCode> <CardType>TNW</CardType> <Brand>MAST</Brand> <CardZone>CROSS_BOARD</CardZone> </CardToInfo>
<Signature></Signature> </CardZoneResponse> |
Успішний статус (000) |
.
Можливі помилки
Запит TEST url - https://ecg.test.upc.ua/mt/card_zone WORK url - https://secure.upc.ua/mt/card_zone |
Неочікуваний результат (ПОМИЛКА) |
Результат тесту |
<CardZoneRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>123</TrackingId> <CardFromNumber>5309530000000077</CardFromNumber> <CardToNumber>5559490000000148</CardToNumber> <Signature></Signature> </CardZoneRequest> 5309530000000077 – карта не існує |
<?xml version="1.0" encoding="UTF-8"?> <CardZoneResponse> <Status> <Code>908</Code> <Message>INCORRECT_CARD_NUMBER (luhn algorith error)</Message> </Status> <Signature></Signature> </CardZoneResponse> |
Неуспішний статус (908) |
Переказ з карти на карту CardToCard (карта не використовує 3D-secure)
Запит TEST url - https://ecg.test.upc.ua/mt/tran WORK url - https://secure.upc.ua/mt/tran |
Очікуваний результат (УСПІХ) |
Результат тесту |
<TransactionRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>fd4e1c67a284</TrackingId> <Amount> <Value>10000</Value> <CurrencyCode>980</CurrencyCode> <Surcharge>100</Surcharge> </Amount>
<Funding> <CVV2>123</CVV2> <CardInfo> <CardNumber>4999999999990011</CardNumber> <ExpYear>2017</ExpYear> <ExpMonth>12</ExpMonth> </CardInfo> </Funding>
<Payment> <RecipientCardNumber>4999999999990011</RecipientCardNumber> </Payment>
<Signature></Signature> </TransactionRequest> |
<?xml version="1.0" encoding="UTF-8"?> <TransactionResponse> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <FundingResult> <Date>2014-03-25 10:25:24 +0200</Date> <CVResult>M</CVResult> <MerchantCliche> <MerchantId>1752739</MerchantId> <TerminalId> E7880539</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>056074</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408410455360</RRN> </FundingResult>
<PaymentResult> <Date>2014-03-25 10:25:24 +0200</Date> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>011838</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408410455629</RRN> </PaymentResult>
<Signature></Signature> </TransactionResponse> |
Успішний статус (000) |
Можливі помилки
Запит TEST url - https://ecg.test.upc.ua/mt/tran |
Неочікуваний результат (ПОМИЛКА) |
Результат тесту |
<TransactionRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>fd4e1c67a284</TrackingId> <Amount> <Value>10000</Value> <CurrencyCode>980</CurrencyCode> <Surcharge>100</Surcharge> </Amount>
<Funding> <CVV2>123</CVV2> <CardInfo> <CardNumber>4999999999990011</CardNumber> <ExpYear>2017</ExpYear> <ExpMonth>12</ExpMonth> </CardInfo> </Funding>
<Payment> <RecipientCardNumber>4999999999990086</RecipientCardNumber> </Payment>
<Signature></Signature> </TransactionRequest> |
<?xml version="1.0" encoding="UTF-8"?> <TransactionResponse> <Status> <Code>903</Code> <Message>Payment auth FAILED, auto reversal was sent</Message> </Status>
<FundingResult> <Date>2014-03-26 11:18:52 +0200</Date> <CVResult>M</CVResult> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>024023</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408511455773</RRN> </FundingResult>
<PaymentResult> <Date>2014-03-26 11:18:52 +0200</Date> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>031215</ApprovalCode> <AuthCode>290</AuthCode> <RRN>408511455654</RRN> </PaymentResult> <Signature></Signature> </TransactionResponse> |
Неуспішний статус (903)
(4999999999990086) недоступний |
Переказ з карти на рахунок CardToAccount
Запит TEST url - https://ecg.test.upc.ua/mt/tran WORK url - https://secure.upc.ua/mt/tran |
Очікуваний результат (УСПІХ) |
Результат тесту |
<TransactionRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>fd4e1c67a2846ce</TrackingId>
<Amount> <Value>10000</Value> <CurrencyCode>980</CurrencyCode> <Surcharge>100</Surcharge> </Amount>
<Funding> <CVV2>123</CVV2> <CardInfo> <CardNumber>4999999999990011</CardNumber> <ExpYear>2017</ExpYear> <ExpMonth>12</ExpMonth> </CardInfo> </Funding> <Signature></Signature> </TransactionRequest> |
<?xml version="1.0" encoding="UTF-8"?> <TransactionResponse> <Status> <Code>000</Code> <Message>Approved</Message> </Status>
<FundingResult> <Date>2014-03-25 10:40:30 +0200</Date> <CVResult>M</CVResult> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>072151</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408410455650</RRN> </FundingResult> <Signature></Signature> </TransactionResponse> |
Успішний статус (000) |
Переказ з рахунку на карту AccountToCard
Запит TEST url - https://ecg.test.upc.ua/mt/tran WORK url - https://secure.upc.ua/mt/tran |
Очікуваний результат (УСПІХ) |
Результат тесту |
<TransactionRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>fd4e1c67a2846ce</TrackingId> <Amount> <Value>10000</Value> <CurrencyCode>980</CurrencyCode> <Surcharge>100</Surcharge> </Amount> <Payment> <RecipientCardNumber>4999999999990011</RecipientCardNumber> <SenderAccountNumber>26385001215533</SenderAccountNumber> </Payment> <Signature></Signature> </TransactionRequest> |
<?xml version="1.0" encoding="UTF-8"?> <TransactionResponse>
<Status> <Code>000</Code> <Message>Approved</Message> </Status>
<PaymentResult> <Date>2014-03-25 10:53:17 +0200</Date> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>056433</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408410455131</RRN> </PaymentResult>
<Signature></Signature> </TransactionResponse> |
Успішний статус (000) |
Перевірка статусу транзакції CardToCard
Запит TEST url - https://ecg.test.upc.ua/mt/status WORK url - https://secure.upc.ua/mt/status |
Очікуваний результат (УСПІХ) |
Результат тесту |
<StatusRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>232323</TrackingId>
<Signature></Signature> </StatusRequest> |
<?xml version="1.0" encoding="UTF-8"?> <StatusResponse> <TransactionResponses> <TransactionResponse> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <FundingResult> <Date>2014-03-25 11:11:37 +0200</Date> <CVResult>M</CVResult> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>051901</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408411455934</RRN> </FundingResult> <PaymentResult> <Date>2014-03-25 11:11:37 +0200</Date> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>026122</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408411455429</RRN> </PaymentResult> </TransactionResponse> </TransactionResponses> <Signature></Signature> </StatusResponse> |
Успішний статус (000) |
Перевірка статусу транзакції CardToCard
Запит TEST url - https://ecg.test.upc.ua/mt/status WORK url - https://secure.upc.ua/mt/status |
Очікуваний результат (УСПІХ) |
Результат тесту |
<StatusRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>121212</TrackingId>
<Signature></Signature> </StatusRequest> |
<?xml version="1.0" encoding="UTF-8"?> <StatusResponse> <TransactionResponses> <TransactionResponse> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <FundingResult> <Date>2014-03-25 11:22:58 +0200</Date> <CVResult>M</CVResult> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>050253</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408411455280</RRN> </FundingResult> </TransactionResponse> </TransactionResponses> <Signature></Signature> </StatusResponse>
|
Успішний статус (000) |
Reversal on funding
Запит a. TEST url - https://ecg.test.upc.ua/mt/reversal |
Очікуваний результат (УСПІХ) |
Результат тесту |
<ReversalRequest> <MerchantId>9752130</MerchantId> <TerminalId>E9879930</TerminalId> <TrackingId>trantest2</TrackingId> <Amount> <Value>100</Value> <CurrencyCode>980</CurrencyCode> <Surcharge>100</Surcharge> </Amount> <Funding> <ApprovalCode>019997</ApprovalCode> <RRN>511110701902</RRN> </Funding> </ReversalRequest> |
<ReversalResponse> <TrackingId>trantest2</TrackingId> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <ReversalResult> <Date>2015-04-21 10:30:05 +0300</Date> <MerchantCliche> <MerchantId>9752130</MerchantId> <TerminalId>E9879930</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>040529</ApprovalCode> <AuthCode>000</AuthCode> <RRN>511110701902</RRN> </ReversalResult> </ReversalResponse> |
Успішний статус (000) |
Перевірка статусу транзакції AccountToCard
Запит TEST url - https://ecg.test.upc.ua/mt/status WORK url - https://secure.upc.ua/mt/status |
Очікуваний результат (УСПІХ) |
Результат тесту |
<StatusRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>101010</TrackingId>
<Signature></Signature> </StatusRequest>
|
<?xml version="1.0" encoding="UTF-8"?> <StatusResponse> <TransactionResponses> <TransactionResponse> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <PaymentResult> <Date>2014-03-25 11:29:03 +0200</Date> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>042670</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408411455157</RRN> </PaymentResult> </TransactionResponse> </TransactionResponses> <Signature></Signature> </StatusResponse> |
Успішний статус (000) |
Якщо відповіді на вищезазначені запити збігаються за структурою з очікуваним результатом то тестування функціоналу MT-UPC вважається завершеним.
Порядок дій по роботі з MT-UPC на прикладі CardToCard транзакції
1. Визначення типу переказу за допомогою сервісу Card Zone
Запит TEST url - https://ecg.test.upc.ua/mt/card_zone WORK url - https://secure.upc.ua/mt/card_zone |
Очікуваний результат (УСПІХ) |
Результат тесту |
<CardZoneRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>123</TrackingId> <CardFromNumber>5309530000000077</CardFromNumber> <CardToNumber>5559490000000148</CardToNumber> <Signature></Signature> </CardZoneRequest> |
<?xml version="1.0" encoding="UTF-8"?> <CardZoneResponse> <Status> <Code>000</Code> <Message>Operations on this card(s) are allowed</Message> </Status> <CardFromInfo> <CountryCode>UKR</CountryCode> <CardType>MCS</CardType> <Brand>MAST</Brand> <CardZone>DOMESTIC</CardZone> </CardFromInfo> <CardToInfo> <CountryCode>UA</CountryCode> <CardType>E</CardType> <Brand>VISA</Brand> <CardZone>DOMESTIC</CardZone> </CardToInfo> <Signature></Signature> </CardZoneResponse> |
Тип пеерказу має бути DOMESTIC |
2. Визначення технології карти відправника (3D- secure ?)
а) 3D- secure
Запит WORK url - https://secure.upc.ua/go/service/03(Емуляція MPI в тестовому середовищі відсутня) |
Очікуваний результат (УСПІХ) |
Результат тесту |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/ecgtest/pub /schema/xmlpay-1.7.xsd"> <Message id="30115" version="1.0"> <XMLMPIRequest> <MerchantID>6859995</MerchantID> <TerminalID>E0129998</TerminalID> <MPIRequestID="28832"> <MPIEnrolRequest> <CardNum>499999******0011</CardNum> (використовується реальна карта) <ExpYear>2017</ExpYear> <ExpMonth>4</ExpMonth> <TotalAmount>100</TotalAmount> <Currency>980</Currency> <Description>Перевод</Description> <DeviceCategory>0</DeviceCategory> </MPIEnrolRequest> </MPIRequest> </XMLMPIRequest> </Message> <Signature></Signature> </ECommerceConnect> |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub/schema /xmlpay-1.5.xsd"> <Message id="30115" version="1.0"> <XMLMPIResponse> <MPIResponse> <Code>0</Code> <MPIEnrolResponse> <Enrolled>Y</Enrolled> <AcsURL> https://acsm.ukrcard.com.ua/ACS/servlet/VPASPayerAuthHTT PServlet?PS=S </AcsURL> <PaReq> <XID>14032516-717962</XID> </MPIEnrolResponse> </MPIResponse> </XMLMPIResponse> </Message> <Signature></Signature> </ECommerceConnect> |
Визначили технологію карти (3D- secure), отримали необхідні дані: AcsURL, PaReq |
б) не можливо визначити
Запит WORK url - https://secure.upc.ua/go/service/03(Емуляція MPI в тестовому середовищі відсутня) |
Неочікуваний результат (ПОМИЛКА) |
Результат тесту |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub /schema/xmlpay-1.7.xsd"> <Message id="30115" version="1.0"> <XMLMPIRequest> <MerchantID>6859995</MerchantID> <TerminalID>E0129998</TerminalID> <MPIRequestID="28832"> <MPIEnrolRequest> <CardNum>499999******0011</CardNum> (використовується реальна карта) <ExpYear>2017</ExpYear> <ExpMonth>4</ExpMonth> <TotalAmount>100</TotalAmount> <Currency>980</Currency> <Description>Перевод</Description> <DeviceCategory>0</DeviceCategory> </MPIEnrolRequest> </MPIRequest> </XMLMPIRequest> </Message> <Signature></Signature> </ECommerceConnect> |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation ="https://secure.upc.ua/go/pub/schema/xmlpay-1.5.xsd"> <Message id="24341" version="1.0"> <XMLMPIResponse> <MPIResponse> <Code>1022</Code> - код помилки. <MPIEnrolResponse> <Enrolled>U</Enrolled> <XID>14032513-713805</XID> </MPIEnrolResponse> </MPIResponse> </XMLMPIResponse> </Message> <Signature></Signature> </ECommerceConnect> |
Визначити технологію карти неможливо. Звертаємо увагу на код помилки MPI і виправляємо причину невдачі. |
3. Передаємо парметри PaReq, TermUrl через HTTP POST на адресу AcsURL
Запит TEST and WORK url - AcsURL |
Очікуваний результат (УСПІХ) |
Результат тесту |
<form method='post' action= AcsURL > <input type='hidden' name='TermUrl' value= TermUrl <input type='hidden' name='PaReq' value= PaReq <input name='button' type='submit' value="В банк"> </form>
TermUrl – URL куди потрібно направити відповідь від Acs банку. |
Власник карти переходить на Acs банку і вводить одноразовий пароль після чого платіжна система надсилає у відповідь Merchant Data I PaRes на вказаний TermUrl через HTTP POST В окремих випадках перехід може бути уявним,обробка даних аутентифікації не може бути завершена, але доказ спроби аутентифікації (CAVV) було згенеровано. |
4.1 Запит на отримання авторизаційних даних (Full 3D Secure)
Запит WORK url - https://secure.upc.ua/go/service/03 |
Очікуваний результат (УСПІХ) |
Результат тесту |
<ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub /schema/xmlpay-1.5.xsd"> <Message id="7418361" version="1.0"> <XMLMPIRequest> <MerchantID>6859995</MerchantID> <TerminalID>E0129998</TerminalID> <MPIRequest ID="1111"> <MPIAuthRequest> <PaRes> eNrNWGmzokrS/isdPR+Ze9lVbnhORBW7ArIjfmOTXRRQkF8/……………… ………………………………NrNWG </PaRes> </MPIAuthRequest> </MPIRequest> </XMLMPIRequest> </Message> <Signature></Signature> </ECommerceConnect> |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns: xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub/schema /xmlpay-1.5.xsd"> <Message id="7418361" version="1.0"> <XMLMPIResponse> <MPIResponse> <Code>0</Code> <MPIAuthResponse> <Status>Y</Status> <CAVV> jMoRyYgNSt0ZAREBBu8LHI+3oZo==</CAVV> <ECI>05</ECI> <CavvAlgorithm>2</CavvAlgorithm> </MPIAuthResponse> </MPIResponse> </XMLMPIResponse> </Message> <Signature></Signature> </ECommerceConnect> |
Отримали дані для авторизації картки з технологією 3D-secure |
Приклад формування тегу PARes для авторизаціїйного запиту VISA: MasterCard:
<PARes> <PARes> <Status>Y</Status> <Status>Y</Status> <CAVV>jELT6UgsfG+oCBEYuBSdBTYAAAA=</CAVV> <CAVV>jKYiciL+YPkBCBAAAUSTA3MAAAA=</CAVV> <ECI>05</ECI> <ECI>02</ECI> <CavvAlgorithm>2</CavvAlgorithm> <CavvAlgorithm>3</CavvAlgorithm> </PARes> </PARes> |
4.2 Запит на отримання авторизаційних даних (Attempt)
Запит WORK url - https://secure.upc.ua/go/service/03 |
Очікуваний результат (УСПІХ) |
Результат тесту |
<ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub /schema/xmlpay-1.5.xsd"> <Message id="7418361" version="1.0"> <XMLMPIRequest> <MerchantID>6859995</MerchantID> <TerminalID>E0129998</TerminalID> <MPIRequest ID="1111"> <MPIAuthRequest> <PaRes> eNrNWGmzokrS/isdPR+Ze9lVbnhORBW7ArIjfmOTXRRQkF8NrNWG </PaRes> </MPIAuthRequest> </MPIRequest> </XMLMPIRequest> </Message> <Signature></Signature> </ECommerceConnect> |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns: xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub/schema /xmlpay-1.5.xsd"> <Message id="7418361" version="1.0"> <XMLMPIResponse> <MPIResponse> <Code>0</Code> <MPIAuthResponse> <Status>A</Status> <CAVV>hoIJ71ONDNFnYwAAADW0AxIAAAA=</CAVV> <ECI>01</ECI> <CavvAlgorithm>3</CavvAlgorithm> </MPIAuthResponse> </MPIResponse> </XMLMPIResponse> </Message> <Signature></Signature> </ECommerceConnect> |
Отримали дані для Attempt авторизації. Для фінальної авторизації |
Приклад формування тегу PARes для авторизаціїйного запиту VISA: MasterCard:
<PARes> <PARes> <Status>A</Status> <Status>A</Status> <CAVV>AAABCFg3aUFBSBAQlTdpEFX/7P4=</CAVV <CAVV>hg8RdVI/XQLFCAEAJXPUBjYAAAA=</CAVV> <ECI>06</ECI> <ECI>01</ECI> <CavvAlgorithm>2</CavvAlgorithm> <CavvAlgorithm>3</CavvAlgorithm> </PARes> </PARes> |
5. Переказ з карти на карту CardToCard (карта відправника з 3D-secure)
Запит TEST url - https://ecg.test.upc.ua/mt/tran WORK url - https://secure.upc.ua/mt/tran |
Очікуваний результат (УСПІХ) |
Результат тесту |
<?xml version="1.0" encoding="UTF-8"?> <TransactionRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>123</TrackingId> <Amount> <Value>10000</Value> <CurrencyCode>980</CurrencyCode> <Surcharge>100</Surcharge> </Amount> <Funding> <PARes> <Status>Y</Status> <CAVV>hoIJ71ONDNFnYwAAADW0AxIAAAA=</CAVV> <ECI>05</ECI> <CavvAlgorithm>2</CavvAlgorithm> </PARes> <CardInfo> <CardNumber>4999999999990011</CardNumber> <ExpYear>2017</ExpYear> <ExpMonth>12</ExpMonth> </CardInfo> </Funding>
<Payment> <RecipientCardNumber>499999999990011</RecipientCardNumber> </Payment> <Signature></Signature> </TransactionRequest> |
<?xml version="1.0" encoding="UTF-8"?> <TransactionResponse> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <FundingResult> <Date>2014-03-27 12:31:41 +0200</Date> <CVResult>M</CVResult> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>086976</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408612455719</RRN> </FundingResult>
<PaymentResult> <Date>2014-03-27 12:31:41 +0200</Date> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>092625</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408612455498</RRN> </PaymentResult> <Signature></Signature></TransactionResponse> |
Успішний статус (000) |
5. Переказ з карти на карту CardToCard (Attempt)
Запит TEST url - https://ecg.test.upc.ua/mt/tran WORK url - https://secure.upc.ua/mt/tran |
Очікуваний результат (УСПІХ) |
Результат тесту |
<?xml version="1.0" encoding="UTF-8"?> <TransactionRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>123</TrackingId> <Amount> <Value>10000</Value> <CurrencyCode>980</CurrencyCode> <Surcharge>100</Surcharge> </Amount> <Funding> <PARes> <Status>A</Status> <CAVV>jMoRyYgNSt0ZAREBBu8LHI+3oZo=</CAVV> <ECI>01</ECI> <CavvAlgorithm>3</CavvAlgorithm> </PARes> <CVV2>123</CVV2> <CardInfo> <CardNumber>4999999999990011</CardNumber> <ExpYear>2017</ExpYear> <ExpMonth>12</ExpMonth> </CardInfo> </Funding>
<Payment> <RecipientCardNumber>4999999999990011</RecipientCardNumber> </TransactionRequest> |
<?xml version="1.0" encoding="UTF-8"?> <TransactionResponse> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <FundingResult> <Date>2014-03-27 12:31:41 +0200</Date> <CVResult>M</CVResult> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>086976</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408612455719</RRN> </FundingResult> <PaymentResult> <Date>2014-03-27 12:31:41 +0200</Date> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>092625</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408612455498</RRN> </PaymentResult> <Signature></Signature> </TransactionResponse> |
У фінальному авторизаційному |
Порядок дій по роботі з MT-UPC на прикладі CardToCard транзакції (картка не використовує 3D-secure)
з Look-up Authorization (не обов’язково)
1. Визначення типу переказу за допомогою сервісу Card Zone
Запит TEST url - https://ecg.test.upc.ua/mt/tran WORK url - https://secure.upc.ua/mt/card_zone |
Очікуваний результат (УСПІХ) |
Результат тесту |
<CardZoneRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>123</TrackingId> <CardFromNumber>530953000000077</CardFromNumber> <CardToNumber>5559490000000148</CardToNumber> <Signature></Signature> </CardZoneRequest> |
<?xml version="1.0" encoding="UTF-8"?> <CardZoneResponse> <Status> <Code>000</Code> <Message>Operations on this card(s) are allowed</Message> </Status> <CardFromInfo> <CountryCode>UKR</CountryCode> <CardType>MCS</CardType> <Brand>MAST</Brand> <CardZone>DOMESTIC</CardZone> </CardFromInfo> <CardToInfo> <CountryCode>UA</CountryCode> <CardType>E</CardType> <Brand>VISA</Brand> <CardZone>DOMESTIC</CardZone> </CardToInfo> <Signature></Signature> </CardZoneResponse> |
Тип переказу має бути DOMESTIC |
2. Look-up авторизація
Запит TEST url - https://ecg.test.upc.ua/go/service/02 WORK url - https://secure.upc.ua/go/service/02 |
Очікуваний результат (УСПІХ) |
Результат тесту |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub/schema/xmlpay-1.4.xsd"> <Message id="748112032436"> <XMLPayRequest> <RequestData> <MerchantID>1700000</MerchantID> <TerminalID>E7000000</TerminalID> <Transactions> <Transaction Id=”2”> <Authorization> <PayData> <Invoice> <OrderID>10vtlpu55</OrderID> <Date>1234567890</Date> <TotalAmount>0</TotalAmount> <Currency>980</Currency> <Description>Rec#15</Description> </Invoice> <Card> <CardNum>4999999999990011</CardNum> <ExpYear>1234</ExpYear> <ExpMonth>12</ExpMonth> </Card> <PARes> <Status>A</Status> <CAVV> </CAVV> <ECI>06</ECI> <CavvAlgorithm>2</CavvAlgorithm> </PARes> </PayData> </Authorization> </Transaction> </RequestData> </XMLPayRequest> </Message> <Signature> ….</Signature> </ECommerceConnect> |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub/schema/xmlpay-1.0.xsd"> <Message id="748112032436" version="1.0"> <XMLPayResponse> <ResponseData> <MerchantID>1700000</MerchantID> <TerminalID>E7000000</TerminalID> <TransactionResults> <TransactionResult> <TranCode>000</TranCode> <ApprovalCode>856257</ApprovalCode> <Rrn>120516000144</Rrn> <Comment>Approved</Comment> <HostCode>000</HostCode> </TransactionResult> <TransactionResult> </ResponseData> </XMLPayResponse> </Message> <Signature> ….</Signature> </ECommerceConnect> |
Код введений клієнтом має співпадати з 6-ти останніми цифрами поля RRN |
3. Визначення технології карти відправника (3D- secure ?)
а) не 3D- secure
Запит WORK URL - https://secure.upc.ua/go/service/03 (Емуляція MPI в тестовому середовищі відсутня) |
Очікуваний результат (УСПІХ) |
Результат тесту |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub /schema/xmlpay-1.7.xsd"> <Message id="30115" version="1.0"> <XMLMPIRequest> <MerchantID>6859995</MerchantID> <TerminalID>E0129998</TerminalID> <MPIRequestID="28832"> <MPIEnrolRequest> <CardNum>499999******0011</CardNum> (використовується реальна карта) <ExpYear>2017</ExpYear> <ExpMonth>4</ExpMonth> <TotalAmount>100</TotalAmount> <Currency>980</Currency> <Description>Перевод</Description> <DeviceCategory>0</DeviceCategory> </MPIEnrolRequest> </MPIRequest> </XMLMPIRequest> </Message> <Signature></Signature> </ECommerceConnect> |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub/schema /xmlpay-1.5.xsd"> <Message id="30115" version="1.0"> <XMLMPIResponse>
<MPIResponse> <Code>1109</Code> <ErrorMessage>PAN is not enrolled</ErrorMessage> <ErrorDetail>Enrolment status: N</ErrorDetail>
<MPIEnrolResponse> <Enrolled>N</Enrolled> <XID>14032516-711111</XID> </MPIEnrolResponse>
</MPIResponse> </XMLMPIResponse> </Message> <Signature></Signature> </ECommerceConnect> |
Визначили технологію карти |
б) не можливо визначити
Запит WORK url - https://secure.upc.ua/go/service/03(Емуляція MPI в тестовому середовищі відсутня) |
Неочікуваний результат (ПОМИЛКА) |
Результат тесту |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://secure.upc.ua/go/pub /schema/xmlpay-1.7.xsd"> <Message id="30115" version="1.0"> <XMLMPIRequest> <MerchantID>6859995</MerchantID> <TerminalID>E0129998</TerminalID> <MPIRequestID="28832"> <MPIEnrolRequest> <CardNum>499999******0011</CardNum> (використовується реальна карта) <ExpYear>2017</ExpYear> <ExpMonth>4</ExpMonth> <TotalAmount>100</TotalAmount> <Currency>980</Currency> <Description>Перевод</Description> <DeviceCategory>0</DeviceCategory> </MPIEnrolRequest> </MPIRequest> </XMLMPIRequest> </Message> <Signature></Signature> </ECommerceConnect> |
<?xml version="1.0" encoding="UTF-8"?> <ECommerceConnect xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation ="https://secure.upc.ua/go/pub/schema/xmlpay-1.5.xsd"> <Message id="24341" version="1.0"> <XMLMPIResponse> <MPIResponse> <Code>1022</Code> - код помилки. <MPIEnrolResponse> <Enrolled>U</Enrolled> <XID>14032513-713805</XID> </MPIEnrolResponse> </MPIResponse> </XMLMPIResponse> </Message> <Signature></Signature> </ECommerceConnect> |
Визначити технологію карти неможливо. Звертаємо увагу на код помилки MPI і виправляємо причину невдачі. |
4. Переказ з карти на карту CardToCard (карта відправника не використовує 3D-secure)
Запит TEST url - https://ecg.test.upc.ua/mt/tran WORK url - https://secure.upc.ua/mt/tran |
Очікуваний результат (УСПІХ) |
Результат тесту |
<?xml version="1.0" encoding="UTF-8"?> <TransactionRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>123</TrackingId> <Amount> <Value>10000</Value> <CurrencyCode>980</CurrencyCode> <Surcharge>100</Surcharge> </Amount> <Funding> <CVV2>123</CVV2> <CardInfo> <CardNumber>4999999999990011</CardNumber> <ExpYear>2017</ExpYear> <ExpMonth>12</ExpMonth> </CardInfo> </Funding> <Payment> <RecipientCardNumber>4999999999990011</RecipientCardNumber> </Payment> <Signature></Signature> |
<?xml version="1.0" encoding="UTF-8"?> <TransactionResponse> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <FundingResult> <Date>2014-03-27 12:31:41 +0200</Date> <CVResult>M</CVResult> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>086976</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408612455719</RRN> </FundingResult> <PaymentResult> <Date>2014-03-27 12:31:41 +0200</Date> <MerchantCliche> <MerchantId>1234567</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>092625</ApprovalCode> <AuthCode>000</AuthCode> <RRN>408612455498</RRN> </PaymentResult> <Signature></Signature> </TransactionResponse> |
Успішний статус (000) |
CROSS BOARDER PAYMENT
Для осуществления cross boarder перевода через сервис Money Transfer на сервисе реализована возможность отправлять переводы из Украины в другие страны.
Поддерживаемые валюты :
980 - гривна; 840 - доллар; 978 - евро
Запрос cross boarder должен содержать tag PaymentInfo с заполненными параметрами в котором передаются данные
Name - имя получателя перевода
SenderPhoneNumber - номер телефона отправителя
Zip - индекс получателя
City - город получателя
Street - улица получателя
DateofBirth - дата рождения отправителя
Request | Response |
<?xml version="1.0" encoding="UTF-8"?> <TransactionRequest> <MerchantId>1752739</MerchantId> <TerminalId>E7880539</TerminalId> <TrackingId>11a211122</TrackingId> <Amount> <Value>10400</Value> <CurrencyCode>978</CurrencyCode> <Surcharge>0</Surcharge> </Amount> <Payment> <SenderPhoneNumber>0952740142</SenderPhoneNumber> <DateOfBirth>19830115</DateOfBirth> <PaymentInfo> <Name>Vasia Pupkin</Name> <Address> <Zip>1234</Zip> <Country>RUS</Country> <City>Kiev</City> <Street>pr.Moskovskiy</Street> </Address> </PaymentInfo> <RecipientCardNumber>4999999999990011</RecipientCardNumber> </Payment> </TransactionRequest> |
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <TransactionResponse> <TrackingId>11a211122</TrackingId> <Status> <Code>000</Code> <Message>Approved</Message> </Status> <PaymentResult> <Date>2017-09-12 13:20:47 +0300</Date> <MerchantCliche> <MerchantId>1752739</MerchantId> <TerminalId>E1234567</TerminalId> <MCC>6012</MCC> </MerchantCliche> <ApprovalCode>089589</ApprovalCode> <AuthCode>000</AuthCode> <RRN>725513732973</RRN> </PaymentResult> </TransactionResponse> |
Формат tag-ов указан в xsd схеме.
Если данные PaymentInfo не заполнены, передаются авторизацию данные полученные при регистрации торговца.
Перевод считается успешным при получении CODE=000
Тестирование проводится на https://ecg.test.upc.ua/mt/tran/ посылкой xml методом POST.