On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/payments/developer/ctv/rest/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.

> IMPORTANT
> 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_d16e16}
---------------------------------

**Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#pnt-auth-intro_d16e25}  
**Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#pnt-auth-intro_d16e35}

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

> IMPORTANT  
> 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/ctv/rest/payments/payments-relax-reqs.md "").

orderInformation.amountDetails.currency
:

orderInformation.amountDetails.totalAmount
:

orderInformation.billTo.address1
:

orderInformation.billTo.email
:

orderInformation.billTo.firstName
:

orderInformation.billTo.lastName
:

paymentinformation.tokenizedCard.cryptogram
:

paymentinformation.tokenizedCard.expirationMonth
:

paymentinformation.tokenizedCard.expirationYear
:

paymentInformation.tokenizedCard.transactionType
:

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

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

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

You can use these optional fields to include additional information when processing an authorization with a payment network token.

clientReferenceInformation.code
:

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

consumerAuthenticationInformation. ucafAuthenticationData
:
For Mastercard requests using 3-D Secure, set this field to the Identity Check cryptogram.

consumerAuthenticationInformation. ucafCollectionIndicator
:
For Mastercard requests using 3-D Secure, set the value to `2`.

orderInformation.amountDetails.currency
:

orderInformation.amountDetails.totalAmount
:

orderInformation.billTo.address1
:

orderInformation.billTo.country
:

orderInformation.billTo.email
:

orderInformation.billTo.firstName
:

orderInformation.billTo.lastName
:

orderInformation.billTo.locality
:

orderInformation.billTo.postalCode
:
Required only for transactions in the US and Canada.

orderInformation.billTo.administrativeArea
:
Required only for transactions in the US and Canada.

processingInformation.commerceIndicator
:

paymentInformation.tokenizedCard.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.

paymentInformation.tokenizedCard.cryptogram
:

paymentInformation.tokenizedCard.expirationMonth
:
Set to the token expiration month that you received from the token service provider.

paymentInformation.tokenizedCard.expirationYear
:
Set to the token expiration year that you received from the token service provider.

paymentInformation.tokenizedCard.number
:
Set to the token value that you received from the token service provider.

paymentInformation.tokenizedCard.requestorId
:
Required on `Visa Platform Connect`

paymentInformation.tokenizedCard.transactionType
:

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

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

REST Example: Authorizations with Payment Network Tokens {#pnt-ex-rest}
=======================================================================

Request

```keyword
{
  "orderInformation" : {
    "billTo": {
        "country": "US",
        "lastName": "Kim",
        "address1": "201 S. Division St.",
        "postalCode": "48104-2201",
        "locality": "Ann Arbor",
        "administrativeArea": "MI",
        "firstName": "Kyong-Jin",
        "email": "test@cybs.com"
        },
    "amountDetails" : {
      "totalAmount" : "100",
      "currency" : "USD"
    }
  },
    "paymentInformation" : {
    "tokenizedCard" : {
      "expirationYear" : "2031",
      "number" : "4111111111111111",
      "expirationMonth" : "12",
      "transactionType" : "1",
      "cryptogram" : "qE5juRwDzAUFBAkEHuWW9PiBkWv="
    }
  }
}
```

Response to a Successful Request

```
{
    "_links": {
        "authReversal": {
            "method": "POST",
            "href": "/pts/v2/payments/6838294805206235603954/reversals"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/payments/6838294805206235603954"
        },
        "capture": {
            "method": "POST",
            "href": "/pts/v2/payments/6838294805206235603954/captures"
        }
    },
    "clientReferenceInformation": {
        "code": "1683829480593"
    },
    "id": "6838294805206235603954",
    "orderInformation": {
        "amountDetails": {
            "authorizedAmount": "100.00",
            "currency": "USD"
        }
    },
    "paymentAccountInformation": {
        "card": {
            "type": "001"
        }
    },
    "paymentInformation": {
        "tokenizedCard": {
            "type": "001"
        },
        "card": {
            "type": "001"
        }
    },
    "pointOfSaleInformation": {
        "terminalId": "111111"
    },
    "processorInformation": {
        "approvalCode": "888888",
        "networkTransactionId": "123456789619999",
        "transactionId": "123456789619999",
        "responseCode": "100",
        "avs": {
            "code": "1"
        }
    },
    "reconciliationId": "60332034UHI9PRJ0",
    "status": "AUTHORIZED",
    "submitTimeUtc": "2023-05-11T18:24:40Z"
}
```

RELATED TO THIS PAGE