I am looking for the API to convert that can convert the LVT in the Authorization transaction and receive a High Value Token (HVT) in the response message. Can you please provide the API details alongwith Sample request + response structure. Many Thanks!
Hi Madhur,
I assume you are coding directly to the eComm platform using the cnpAPI. You can find the inflormation you requested in the eProtect Integration Guide (Worldpay eProtect Integration Guide V7.5 ) Section 2.5.2. Below are the Request and Response examples from that section.
Note that in the request the value of 000 for the <cardValidationNum> element in the request signifies that we should use the CVV from the information captured by eProtect.
<cnpOnlineRequest version="12.6" xmlns="http://www.vantivcnp.com/schema" merchantId="100">
<authentication>
<user>User Name</user>
<password>Password</password>
</authentication>
<authorization id="834262" reportGroup="ABC Division" customerId="038945">
<orderId>65347567</orderId>
<amount>40000</amount>
<orderSource>ecommerce</orderSource>
<billToAddress>
<name>John Smith</name>
<addressLine1>100 Main St</addressLine1>
<city>Boston</city>
<state>MA</state>
<zip>12345</zip>
<email>jsmith@someaddress.com</email>
<phone>555-123-4567</phone>
</billToAddress>
<paypage>
<paypageRegistrationId>cDZJcmd1VjNlYXNaSlRMTGpocVZQY1NNlYE4ZW5UTko4NU 9KK3p1L1p1VzE4ZWVPQVlSUHNITG1JN2I0NzlyTg=</paypageRegistrationId>
<expDate>1021</expDate>
<cardValidationNum>000</cardValidationNum>
</paypage>
</authorization>
</cnpOnlineRequest>
<cnpOnlineResponse version="12.6" xmlns="http://www.vantivcnp.com/schema" response="0" message="Valid Format">
<authorizationResponse id="834262" reportGroup="ABC Division" customerId="038945">
<cnpTxnId>969506</cnpTxnId>
<orderId>65347567</orderId>
<response>000</response>
<responseTime>2018-09-25T15:13:43</responseTime>
<postDate>2018-09-25</postDate>
<message>Approved</message>
<authCode>123457</authCode>
<fraudResult>
<avsResult>11</avsResult>
<cardValidationResult>P</cardValidationResult>
</fraudResult>
<tokenResponse>
<cnpToken>1111000100090005</cnpToken>
<tokenResponseCode>801</tokenResponseCode>
<tokenMessage>Account number was successfully registered</tokenMessage>
<type>VI</type>
<bin>402410</bin>
</tokenResponse>
</authorizationResponse>
</cnpOnlineResponse>
I hope this helps. If you have any other questions, you can add them to this thread or post a new one.
Tom
Hello Tom, Thank you so much for reverting ! I am assuming using the above request we are doing ZERO Dollar Authentication + Convertion of LVT to HVT.
<tokenResponse>
<cnpToken>1111000100090005</cnpToken>
<tokenResponseCode>801</tokenResponseCode>
<tokenMessage>Account number was successfully registered</tokenMessage>
. . .
</tokenResponse>
The LVT is the <paypageRegistrationId> element in the request and the <cnpToken> is the HVT returned in the response. The example I posted shows an Auth for $400 (<amount>40000</amount>), but you can do a $0 Auth to convert while performing an AVS and CVV check, which is usually the purpose of a $0 Auth.
If, on the other hand, you are simply looking to convert the LVT to HVT before the LVT expires (24 hours), you can also use a Register Token Request (<registerTokenRequest>), which is a non-financial transaction (request and response examples below).
<cnpOnlineRequest version="12.6" xmlns="http://www.vantivcnp.com/schema"
merchantId="100">
<authentication>
<user>userName</user>
<password>password</password>
</authentication>
<registerTokenRequest id="99999" reportGroup="RG1">
<orderId>F12345</orderId>
<paypageRegistrationId>3854058282021647186</paypageRegistrationId>
</registerTokenRequest>
</cnpOnlineRequest>
<cnpOnlineResponse version="12.6" xmlns="http://www.vantivcnp.com/schema" id="123"
response="0" message="Valid Format" cnpSessionId="987654321">
<registerTokenResponse id="99999" reportGroup="RG1">
<cnpTxnId>21122700</cnpTxnId>
<cnpToken>1111000100360002</cnpToken>
<bin>400510</bin>
<type>VI</type>
<response>801</response>
<responseTime>2018-09-26T17:21:51</responseTime>
<message>Account number was successfully registered</message>
</registerTokenResponse>
</cnpOnlineResponse>
Big thanks Tom !
My last question - can we perform Authorization using HVT ?
Yes. You can use the HVT any place you would normally use a card number. You just replace the <card> structure with the <token> structure.
Tom
So , will it be like this :
<cnpOnlineRequest version="12.6" xmlns="http://www.vantivcnp.com/schema" merchantId="100">
<authentication>
<user>User Name</user>
<password>Password</password>
</authentication>
<authorization id="834262" reportGroup="ABC Division" customerId="038945">
<orderId>65347567</orderId>
<amount>40000</amount>
<orderSource>ecommerce</orderSource>
<billToAddress>
<name>John Smith</name>
<addressLine1>100 Main St</addressLine1>
<city>Boston</city>
<state>MA</state>
<zip>12345</zip>
<email>jsmith@someaddress.com</email>
<phone>555-123-4567</phone>
</billToAddress>
<token>
<cnpToken>Token</cnpToken>
<expDate>Card Expiration Date</expDate>
<cardValidationNum>Card Validation Number</cardValidationNum>
<type>Method of Payment</type>
</token>
</authorization>
</cnpOnlineRequest>
Yes. Looks good to me. :O)
Hi Madhur,
I assume you are coding directly to the eComm platform using the cnpAPI. You can find the inflormation you requested in the eProtect Integration Guide (Worldpay eProtect Integration Guide V7.5 ) Section 2.5.2. Below are the Request and Response examples from that section.
Note that in the request the value of 000 for the <cardValidationNum> element in the request signifies that we should use the CVV from the information captured by eProtect.
<cnpOnlineRequest version="12.6" xmlns="http://www.vantivcnp.com/schema" merchantId="100">
<authentication>
<user>User Name</user>
<password>Password</password>
</authentication>
<authorization id="834262" reportGroup="ABC Division" customerId="038945">
<orderId>65347567</orderId>
<amount>40000</amount>
<orderSource>ecommerce</orderSource>
<billToAddress>
<name>John Smith</name>
<addressLine1>100 Main St</addressLine1>
<city>Boston</city>
<state>MA</state>
<zip>12345</zip>
<email>jsmith@someaddress.com</email>
<phone>555-123-4567</phone>
</billToAddress>
<paypage>
<paypageRegistrationId>cDZJcmd1VjNlYXNaSlRMTGpocVZQY1NNlYE4ZW5UTko4NU 9KK3p1L1p1VzE4ZWVPQVlSUHNITG1JN2I0NzlyTg=</paypageRegistrationId>
<expDate>1021</expDate>
<cardValidationNum>000</cardValidationNum>
</paypage>
</authorization>
</cnpOnlineRequest>
<cnpOnlineResponse version="12.6" xmlns="http://www.vantivcnp.com/schema" response="0" message="Valid Format">
<authorizationResponse id="834262" reportGroup="ABC Division" customerId="038945">
<cnpTxnId>969506</cnpTxnId>
<orderId>65347567</orderId>
<response>000</response>
<responseTime>2018-09-25T15:13:43</responseTime>
<postDate>2018-09-25</postDate>
<message>Approved</message>
<authCode>123457</authCode>
<fraudResult>
<avsResult>11</avsResult>
<cardValidationResult>P</cardValidationResult>
</fraudResult>
<tokenResponse>
<cnpToken>1111000100090005</cnpToken>
<tokenResponseCode>801</tokenResponseCode>
<tokenMessage>Account number was successfully registered</tokenMessage>
<type>VI</type>
<bin>402410</bin>
</tokenResponse>
</authorizationResponse>
</cnpOnlineResponse>
I hope this helps. If you have any other questions, you can add them to this thread or post a new one.
Tom