Authorization with `Dynamic Currency Conversion` {#cp-services-dcc-auth-intro}
==============================================================================

This section provides the information you need in order to process an authorization with `Dynamic Currency Conversion`.

Endpoint {#cp-services-dcc-auth-intro_d7e16}
--------------------------------------------

**Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#cp-services-dcc-auth-intro_d7e25}  
**Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#cp-services-dcc-auth-intro_d7e35}

Required Fields for Authorization with `Dynamic Currency Conversion` {#cp-services-dcc-auth-api-req-fields}
===========================================================================================================

[clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "")
:

[clientReferenceInformation.comments](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-comments.md "")
:
Set the value to `UseIndustryDesignatedValue`.

[clientReferenceInformation.partner.developerId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-developer-id.md "")
:
`Cybersource` provides the value for this field.

[clientReferenceInformation.partner.solutionId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-solution-id.md "")
:
`Cybersource` provides the value for this field.

[clientReferenceInformation.partner.thirdPartyCertificationNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-partner-third-party-certnum.md "")
:

[clientReferenceInformation.transactionId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-transaction-id.md "")
:
Set the value to a unique value to manage timeout scenarios when a response is not received.

[merchantInformation.transactionLocalDateTime](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/merch-info-aa/merch-info-transaction-local-date-time.md "")
:

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.currencyConversion.indicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency-conversion-ind.md "")
:

[orderInformation.amountDetails.exchangeRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-exchange-rate-a.md "")
:

[orderInformation.amountDetails.originalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-orginal-amount.md "")
:

[orderInformation.amountDetails.originalCurrency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-original-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

[paymentInformation.card.type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-type-a.md "")
:

[pointOfSaleInformation.emv.cardSequenceNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-emv-card-sequence-num.md "")
:
Set the value to the EMV Tag 5F34 value personalized on the chip. Otherwise, do not include the field.

[pointOfSaleInformation.emv.tags](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-emv-tags.md "")
:

[pointOfSaleInformation.terminalCapability](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-terminal-capability.md "")
:

[pointOfSaleInformation.terminalPinCapability](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-terminal-pin-capability.md "")
:

[pointOfSaleInformation.trackData](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-track-data.md "")
:

[processingInformation.commerceIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-commerce-ind.md "")
:
Set the value to `retail`.

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 "")

Optional Fields for Authorization with `Dynamic Currency Conversion` {#cp-services-dcc-auth-api-opt-fields}
===========================================================================================================

[orderInformation.amountDetails.currencyConversion.reconciliationId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/currency-conv-aa/currency-conv-reconciliation-id.md "")
:

[orderInformation.amountDetails.exchangeRateTimeStamp](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-exchange-rate-time-stamp.md "")
:

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

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

REST Example: Authorization with `Dynamic Currency Conversion` {#cp-services-dcc-auth-api-ex-rest}
==================================================================================================

Request

```
{
  "clientReferenceInformation": {
    "code": "CRI Code",
    "comments": "IndustrySpecificValue",
    "partner": {
      "developerId": "ptpDevID",
      "solutionId": "ptpSolutionId",
      "thirdPartyCertificationNumber": "ptpTPCN"
    },
    "transactionId": "uniqueTranId123"
  },
  "merchantInformation": {
    "transactionLocalDateTime": "20240122115959"
  },
  "orderInformation": {
    "amountDetails": {
      "currency": "USD",
      "totalAmount": 9900.00,
      "exchangeRate": 1.05,
      "originalAmount": 9428.57,
      "originalCurrency": "EUR",
      "currencyConversion": {
        "indicator": 1
      }
    }
  },
  "paymentInformation": {
    "card": {
      "type": "001"
    }
  },
  "pointOfSaleInformation": {
    "entryMode": "contactless",
    "terminalCapability": 4,
    "terminalPinCapability": 0,
    "trackData": ";417666222xx10034=311220111523358?",
    "emv": {
      "cardSequenceNumber": "03",
      "tags": "820220008407A0000000031010950500000000009F33030060C09F02060000009900009F03060000000001009F1A0208409C01005F2A0208409A032404179F3704543B54D19F3501219F34031F03025F3401039F10201F220100A000000000564953414C3354455354434153450000000000000000009F2608F152DAE24E7A27DA9F2701809F360200029F6E0420700080"
    }
  },
  "processingInformation": {
    "commerceIndicator": "retail"
  }
}
```

Response to a Successful Request

```
{
  "_links": {
    "authReversal": {
      "method": "POST",
      "href": "/pts/v2/payments/7413044040886819903813/reversals"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/payments/7413044040886819903813"
    },
    "capture": {
      "method": "POST",
      "href": "/pts/v2/payments/7413044040886819903813/captures"
    }
  },
  "clientReferenceInformation": {
    "code": "CRI Code",
    "comments": "IndustrySpecificValue",
    "partner": {
      "developerId": "ptpDevID",
      "solutionId": "ptpSolutionId"
    },
    "transactionId": "uniqueTranId123"
  },
  "id": "7413044040886819903813",
  "orderInformation": {
    "amountDetails": {
      "authorizedAmount": "9900.00",
      "currency": "USD"
    }
  },
  "paymentAccountInformation": {
    "card": {
      "type": "001"
    }
  },
  "paymentInformation": {
    "accountFeatures": {
      "category": "A",
      "group": "0"
    },
    "tokenizedCard": {
      "type": "001"
    },
    "card": {
      "type": "001"
    }
  },
  "pointOfSaleInformation": {
    "emv": {
      "tags": "9F36020015910AB58D60185BEF0247303072179F180430303031860E04DA9F580903B1BAEDFD1438BA48"
    }
  },
  "processorInformation": {
    "systemTraceAuditNumber": "739787",
    "approvalCode": "831000",
    "networkTransactionId": "016153570198200",
    "retrievalReferenceNumber": "506523739787",
    "transactionId": "016153570198200",
    "responseCode": "00",
    "avs": {
      "code": "2"
    }
  },
  "reconciliationId": "7413044040886819903813",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2025-03-06T23:40:04Z"
}
```