/
Apple Pay, Google Pay Authorization

Apple Pay, Google Pay Authorization

июн. 27, 2023

Платежі Apple Pay, Google Pay (з застосування криптограм)

Інструкції по активації Google Pay для прямої інтеграції

Якщо ви віддаєте перевагу інтегруватися безпосередньо з Google Pay API, дотримуйтесь інструкцій Google.

  1. Отримайте зашифровані платіжні дані платника, повернуті Google Pay.
  2. Надішліть зашифровані платіжні дані на свій сервер.
  3. Повторно надішліть зашифровані платіжні дані зі свого сервера на UPC платіжного API https://secure.upc.ua/go/service/02 в параметрі <TAVV>
  4. Отримайте остаточну відповідь про платіж від UPC-сервера з деталями замовлення
  5. Повідомте платнику про результат платежу



Приклад

<ExtDataToken>

<TAVV>Cryptogram</TAVV>

</ExtDataToken>



Повідомлення Авторизації (Authorization)

POST        https://ecg.test.upc.ua/go/service/02

Тестове середовище


POST        https://secure.upc.ua/go/service/02

Робоче середовище



Приклад запиту на авторизацію
<?xml version="1.0" encoding="UTF-8"?>
<ECommerceConnect
	xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
	xmlns:nonamespaceschemalocation="https://secure.upc.ua/go/pub/schema/xmlpay-1.4.xsd"
	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.4.xsd">
	<Message id="15967003274935781442886718696099" version="1.0">
		<XMLPayRequest>
			<RequestData>
				<MerchantID>1750000</MerchantID>
				<TerminalID>E1750000</TerminalID>
				<Transactions>
					<Transaction>
						<Authorization>
							<PayData>
								<Invoice>
									<OrderID>testapple</OrderID>
									<Date>29092021140000</Date>
									<TotalAmount>1000</TotalAmount>
									<Currency>980</Currency>
									<Description>Rec#15</Description>
								</Invoice>
								<Card>
									<CardNum>4999999999990011</CardNum>
									<ExpYear>2050</ExpYear>
									<ExpMonth>12</ExpMonth>
                                    <ExtDataToken>
                                       <TAVV>AIlPcGMN6wIEBDqtqPmhGgADFA==</TAVV>
                                    </ExtDataToken>         
                                </Card>
							</PayData>
						</Authorization>
					</Transaction>
				</Transactions>
			</RequestData>
		</XMLPayRequest>
	</Message>
	<Signature></Signature>
</ECommerceConnect>


Приклад відповіді на запит авторизації
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<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.28.xsd">
    <Message id="123" version="1">
        <XMLPayResponse>
            <ResponseData>
                <MerchantID>1750000</MerchantID>
                <TerminalID>E1750000</TerminalID>
                <TransactionResults>
                    <TransactionResult>
                        <TranCode>000</TranCode>
                        <ApprovalCode>992440</ApprovalCode>
                        <Rrn>234612635816</Rrn>
                        <Comment>Approved</Comment>
                        <CVResult>M</CVResult>
                        <HostCode>000</HostCode>
                    </TransactionResult>
                </TransactionResults>
            </ResponseData>
        </XMLPayResponse>
    </Message>
   <Signature></Signature>
</ECommerceConnect> 
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             

Приклад

Також по токенам ApplePay/GooglePay можна додатково проводити 3DSecure перевірку (аналогічно звичайним картам). Тоді кінцевий запит на списання авторизацію (списання) буде містити тег Pares, який, в свою чергу, буде включати в себе результат аутентифікації клієнта.
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 
Приклад запиту на авторизацію (запит включає 3DSecure дані)
<?xml version="1.0" encoding="UTF-8"?>
<ECommerceConnect
	xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
	xmlns:nonamespaceschemalocation="https://secure.upc.ua/go/pub/schema/xmlpay-1.4.xsd"
	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.4.xsd">
	<Message id="15967003274935781442886718696099" version="1.0">
		<XMLPayRequest>
			<RequestData>
				<MerchantID>1750000</MerchantID>
				<TerminalID>E1750000</TerminalID>
				<Transactions>
					<Transaction>
						<Authorization>
							<PayData>
								<Invoice>
									<OrderID>testapple2</OrderID>
									<Date>29092021140000</Date>
									<TotalAmount>1000</TotalAmount>
									<Currency>980</Currency>
									<Description>Rec#15</Description>
								</Invoice>
								<Card>
									<CardNum>4999999999990011</CardNum>
									<ExpYear>2050</ExpYear>
									<ExpMonth>12</ExpMonth>
                                    <ExtDataToken>
                                       <TAVV>AIlPcGMN6wIEBDqtqKlmGgADFA==</TAVV>
                                    </ExtDataToken>         
                                </Card>
                                <PARes>
									<Status>Y</Status>
									<CAVV>AAABCFg3aUFBSBAQlTdpEFX/7P4=</CAVV>
									<ECI>05</ECI>
                                    <EMV3ds>
                                        <DServerTransID>5ec68480-265e-48fa-b8b2-94f66b1e7259</DServerTransID>
                                    </EMV3ds>
                                </PARes>
                          </PayData>
						</Authorization>
					</Transaction>
				</Transactions>
			</RequestData>
		</XMLPayRequest>
	</Message> 
   <Signature></Signature>
 </ECommerceConnect>

Приклад відповіді на запит авторизації
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<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.28.xsd">
    <Message id="123" version="1">
        <XMLPayResponse>
            <ResponseData>
                <MerchantID>1750000</MerchantID>
                <TerminalID>E1750000</TerminalID>
                <TransactionResults>
                    <TransactionResult>
                        <TranCode>000</TranCode>
                        <ApprovalCode>846251</ApprovalCode>
                        <Rrn>234612638392</Rrn>
                        <Comment>Approved</Comment>
                        <CVResult>M</CVResult>
                        <HostCode>000</HostCode>
                    </TransactionResult>
                </TransactionResults>
            </ResponseData>
        </XMLPayResponse>
    </Message>   
  <Signature></Signature> 
</ECommerceConnect>