China domestic processing

Suggest Edits

Fiserv has partnered with Huifu, a payment provider in China, to offer the ability to route Chinese transactions and settle domestically in China.
This solution includes China UnionPay, Alipay and WeChat Pay with a redirection of the consumer to pages in Chinese language provided by the local partner.

The following represents an example of a transaction request with payment method “CUP Domestic”:

<?xml version="1.0" encoding="UTF-8"?>
<ns4:IPGApiOrderRequest 
xmlns:ns4="http://ipg-online.com/ipgapi/schemas/ipgapi" xmlns:ns2="http://ipg-online.com/ipgapi/schemas/a1" 
xmlns:ns3="http://ipg-online.com/ipgapi/schemas/v1">
    <ns3:Transaction>
        <ns3:CUPDomesticTxType>
            <ns3:StoreId>471230011057</ns3:StoreId>
            <ns3:Type>sale</ns3:Type>
        </ns3:CUPDomesticTxType>
        <ns3:CUPDomesticInformation>
            <ns3:CustomerId>123</ns3:CustomerId>
            <ns3:ProductCode>400005</ns3:ProductCode>
            <ns3:ProductQuantity>1</ns3:ProductQuantity>
            <ns3:ProductPrice>1</ns3:ProductPrice>
            <ns3:ProductDescription>product01</ns3:ProductDescription>
            <ns3:RedirectUrl>http://www.testURL.com</ns3:RedirectUrl>
           	<ns3:BankId>abc</ns3:BankId>
        </ns3:CUPDomesticInformation>
        <ns3:Payment>
            <ns3:ChargeTotal>2</ns3:ChargeTotal>
            <ns3:Currency>840</ns3:Currency>
        </ns3:Payment>
        <ns3:TransactionDetails>
            <ns3:OrderId>API-TestTxn</ns3:OrderId>
        </ns3:TransactionDetails>
    </ns3:Transaction>
</ns4:IPGApiOrderRequest>

The RedirectURL in the request is where Chinese platform (PNR) is going to redirect you to after the processing is done at their end.

Please note, that for payment method “CUP_domestic” the element ‘BankId’ is mandatory and the element ‘CustomerId’ is recommended to be submitted in case your consumer knows its value.

For payment method Alipay please use the elements AlipayTxType AND AlipayDomesticInformation.
For payment method WeChat please use the elements WeChatTxType ANDWeChatDomesticInformation.

The following represents an example of a transaction response:

<?xml version="1.0" encoding="UTF-8"?><ipgapi:IPGApiOrderResponse 
xmlns:ipgapi="http://ipg-online.com/ipgapi/schemas/ipgapi" xmlns:a1="http://ipgonline.com/ipgapi/schemas/a1" 
xmlns:v1="http://ipg-online.com/ipgapi/schemas/v1">
 <ipgapi:ApprovalCode>?:waiting CHINAPNR</ipgapi:ApprovalCode>
 <ipgapi:AVSResponse>PPX</ipgapi:AVSResponse>
 <ipgapi:CommercialServiceProvider>FDMS-HK</ipgapi:CommercialServiceProvider>
 <ipgapi:OrderId>API-TestTxn</ipgapi:OrderId>
 <ipgapi:IpgTransactionId>8383903542</ipgapi:IpgTransactionId>
 <ipgapi:ProcessorResponseCode>000000</ipgapi:ProcessorResponseCode>
 <ipgapi:ProcessorResponseMessage>ChinaPnRsuccess</ipgapi:ProcessorResponseMessage>
 <ipgapi:TDate>1548783233</ipgapi:TDate>
 <ipgapi:TDateFormatted>2019.10.29 18:33:53 (MEZ)</ipgapi:TDateFormatted>
 <ipgapi:TerminalID>0010001</ipgapi:TerminalID>
 <ipgapi:TransactionResult>WAITING</ipgapi:TransactionResult>
 <ipgapi:TransactionTime>1548783233</ipgapi:TransactionTime>
 <ipgapi:RedirectUrl>https://hfgj.chinapnr.com/pay/redirectGw.htm?sequenceId=2000019929&amp;mac=6783F30480FE694B429ABCA1685ED</ipgapi:RedirectUrl>
</ipgapi:IPGApiOrderResponse

The RedirectURL in the IPG response is where you need to redirect your consumer so that they can continue with the transaction processing on PNR platform side.

Updated about 2 months ago

API Products

Point of Sale

Developer

Resources