On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/payments/developer/vantivcnp/so/payments/payments-processing-basic-intro/pnt-auth-intro.md)  
Filter  
FILTER BY TAG

Authorization with Payment Network Tokens {#pnt-auth-intro}
===========================================================

This section shows you how to successfully process an authorization with payment network tokens.

> Due to mandates from the Reserve Bank of India, merchants based in India cannot store personal account numbers (PAN). Use network tokens instead. For more information on network tokens, see the Network Tokenization section of the [` Token Management Service ` Guide.](https://developer.cybersource.com/docs.md#TokenManagementService "")

Endpoint {#pnt-auth-intro_d19e16}
---------------------------------

Set the ccAuthService_run field to `true`.  
Send the request to `https://ics2ws.ic3.com/commerce/1.x/transactionProcessor`.

Required Fields for Authorizations with Payment Network Tokens {#pnt-req-fields}
================================================================================

> When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see [Relaxed Requirements for Address Data and Expiration Date in Payment Transactions](/docs/cybs/en-us/payments/developer/vantivcnp/so/payments/payments-relax-reqs.md "").

billTo_email
:

billTo_firstName
:

billTo_lastName
:

billTo_street1
:

ccAuthService_networkTokenCryptogram
:

purchaseTotals_currency
:

purchaseTotals_grandTotalAmount
:

token_expirationMonth
:

token_expirationYear
:

Related Information {#pnt-req-fields_section_gbq_mvv_1yb}
---------------------------------------------------------

* [API field reference guide for the Simple Order API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "")

Optional Fields for Authorizations with Payment Network Tokens {#pnt-optional-fields}
=====================================================================================

billTo_city
:

billTo_country
:

billTo_email
:

billTo_firstName
:

billTo_lastName
:

billTo_postalCode
:
Required only for transactions in the U.S. and Canada.

billTo_state
:
Required only for transactions in the U.S. and Canada.

billTo_street1
:

card_accountNumber
:
Set to the token value that you received from the token service provider.

card_cardType
:
It is strongly recommended that you send the card type even if it is optional for your processor. Omitting the card type can cause the transaction to be processed with the wrong card type.

card_expirationMonth
:
Set to the token expiration month that you received from the token service provider.

card_expirationYear
:
Set to the token expiration year that you received from the token service provider.

ccAuthService_cavv
:
For 3-D Secure in-app transactions for Visa and JCB, set to the 3-D Secure cryptogram. Otherwise, set to the network token cryptogram.

ccAuthService_commerceIndicator
:

ccAuthService_networkTokenCryptogram
:

ccAuthService_run
:
Set the value to `true`.

merchantID
:

merchantReferenceCode
:

purchaseTotals_currency
:

purchaseTotals_grandTotalAmount or item_#_unitPrice
:

paymentNetworkToken_transactionType
:

paymentNetworkToken_requestorID

ucaf_authenticationData
:
For Mastercard requests, set this field to the Identity Check cryptogram.

ucaf_collectionIndicator
:
For Mastercard requests, set the value to `2`.

Related Information
-------------------

* [API field reference guide for the Simple Order API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "")
  {#pnt-optional-fields_ul_hbq_mvv_1yb}

Simple Order API Example: Authorizations with Payment Network Tokens {#pnt-ex-so}
=================================================================================

Request

```
<requestMessage>
    <purchaseTotals>
        <currency>USD</currency>
        <grandTotalAmount>16.00</grandTotalAmount>
    </purchaseTotals>
    <card>
        <accountNumber>4111111111111111</accountNumber>
        <expirationMonth>12</expirationMonth>
        <expirationYear>2031</expirationYear>
    </card>
    <ccAuthService run="true">
        <networkTokenCryptogram>qE5juRwDzAUFBAkEHuWW9PiBkWv=</networkTokenCryptogram>
    </ccAuthService>
    <paymentNetworkToken>
        <transactionType>1</transactionType>
    </paymentNetworkToken>
</requestMessage>
```

Successful Response

```
<c:replyMessage>
    <c:merchantReferenceCode>Postman-1684858432</c:merchantReferenceCode>
    <c:requestID>6848584316126969103007</c:requestID>
    <c:decision>ACCEPT</c:decision>
    <c:reasonCode>100</c:reasonCode>
    <c:purchaseTotals>
        <c:currency>USD</c:currency>
    </c:purchaseTotals>
    <c:ccAuthReply>
        <c:reasonCode>100</c:reasonCode>
        <c:amount>16.00</c:amount>
        <c:authorizationCode>888888</c:authorizationCode>
        <c:avsCode>X</c:avsCode>
        <c:avsCodeRaw>I1</c:avsCodeRaw>
        <c:authorizedDateTime>2023-05-23T16:13:51Z</c:authorizedDateTime>
        <c:processorResponse>100</c:processorResponse>
        <c:reconciliationID>78849228NHPFQCKD</c:reconciliationID>
        <c:paymentNetworkTransactionID>123456789619999</c:paymentNetworkTransactionID>
     </c:ccAuthReply>
     <c:card>
         <c:cardType>001</c:cardType>
     </c:card>
</c:replyMessage>
```

RELATED TO THIS PAGE