On This Page

{#jumplink-list}  
[Markdown](/docs/vas/en-us/urban-mobility/developer/ctv/rest/mass-transit/um-processing-amex-auth-intro.md)  
Filter  
FILTER BY TAG

American Express Delayed Online Authorization with EMV Data {#um-processing-amex-auth-intro}
============================================================================================

This section describes how to process an American Express delayed online authorization with EMV data for a nominal amount of 1.00 USD or more. The required function code is 100.

Endpoint {#um-processing-amex-auth-intro_d7e16}
-----------------------------------------------

**Production:** `POST ``https://api.visaacceptance.com``/pts/v2/payments`{#um-processing-amex-auth-intro_d7e25}  
**Test:** `POST ``https://apitest.visaacceptance.com``/pts/v2/payments`{#um-processing-amex-auth-intro_d7e35}

Required Fields for a American Express Delayed Online Authorization with EMV Data Using the REST API {#um-processing-amex-do-auth-reqd-fields}
==============================================================================================================================================

clientReferenceInformation.code
:

clientReferenceInformation.comments
:
Set this field to `TransitDA BAU nominal value auth`.

clientReferenceInformation.partner.solutionId
:
`Visa Acceptance Solutions` provides the value for this field.

clientReferenceInformation.partner.thirdPartyCertificationNumber
:
`Visa Acceptance Solutions` provides the value for this field.

clientReferenceInformation.transactionId
:

orderInformation.amountDetails.currency
:

orderInformation.amountDetails.totalAmount
:

paymentInformation.card.type
:
Set this field to `003`.

pointOfSaleInformation.catLevel
:
Set this field to `2`.

pointOfSaleInformation.emv.cardSequenceNumber
:
Set this field to `00`.

pointOfSaleInformation.emv.tags
:

pointOfSaleInformation.entryMode
:
Set this field to `contactless`.

pointOfSaleInformation.terminalCapability
:
Set this field to `5`.

pointOfSaleInformation.terminalId
:

pointOfSaleInformation.terminalPinCapability
:
Set this field to `0`.

pointOfSaleInformation.trackData
:

processingInformation.captureOptions.dateToCapture
:

processingInformation.commerceIndicator
:
Set this field to `retail`.

processingInformation.industryDataType
:
Set this field to `transit`.

REST Example: American Express Delayed Online Authorization with EMV Data {#um-processing-amex-do-auth-ex-rest}
===============================================================================================================

Request

```
{ 
   "orderInformation": { 
      "amountDetails": { 
         "currency": "EUR", 
         "totalAmount": "8.00" 
      } 
   }, 
   "paymentInformation": { 
      "card": { 
         "type": "003" 
      } 
   }, 
   "processingInformation": { 
      "captureOptions": { 
         "dateToCapture": "0901" 
      }, 
      "industryDataType": "transit", 
      "commerceIndicator": "retail"
      } 
   }, 
   "pointOfSaleInformation": { 
      "emv": { 
         "tags": "9A032309019C01005F2A0209789F1A0203809F02060000000000009F03060000000000009F36020002820219C08408A000000025010901950500000080009F100706020103A400029F2608D89D7C3CA015E11C9F2701809F33030008889F34031F02029F3704A5CCF3EE9F6E04180000E05F340100", 
         "cardSequenceNumber": "00" 
      }, 
      "catLevel": "2", 
      "entryMode": "contactless", 
      "trackData": ";341111XXXXXXXXXX=241270215041234500000?", 
      "terminalId": "12345678", 
      "terminalCapability": "5", 
      "terminalPinCapability": "0" 
   }, 
   "clientReferenceInformation": { 
      "comments": "TransitDA BAU full value auth",
      "code": "v7qWAImW6e", 
      "partner": { 
         "solutionId": "BUALWMZK", 
         "thirdPartyCertificationNumber": "condue211609" 
      }, 
      "transactionId": "Fg1xkLJGMmmmvwbB9qWAImW6e" 
   } 
}
```

{#um-processing-amex-do-auth-ex-rest_codeblock_tms_qh4_jyb}  
Response to a Successful Request

```
{
   "_links": { 
      "authReversal": {
         "method": "POST", 
                "href": "/pts/v2/payments/6984003567376178404953/reversals" 
           }, 
           "self": { 
                "method": "GET", 
                "href": "/pts/v2/payments/6984003567376178404953" 
           }, 
      "capture": { 
                "method": "POST", 
         "href": "/pts/v2/payments/6984003567376178404953/captures" 
      } 
   },
   "clientReferenceInformation": { 
      "code": "v7qWAImW6e", 
      "partner": { 
         "solutionId": "BUALWMZK" 
      }, 
           "transactionId": "Fs8xkLJGNslmvwbZ9qWAImW6e" 
   }, 
   "id": "6984003567376178404953", 
   "orderInformation": {
      "amountDetails": { 
         "authorizedAmount": "8.00",
         "currency": "EUR"
      } 
   },
   "paymentAccountInformation": { 
      "card": {
         "type": "003"
      } 
   }, 
   "paymentInformation": { 
      "accountFeatures": { 
         "category": "AX", 
         "group": "0"
      },
      "tokenizedCard": { 
         "type": "003" 
      }, 
      "card": {
         "type": "003" 
      }
   },
   "pointOfSaleInformation": { 
      "emv": { 
         "tags": "9F2701809F34033F00005F340100910AEE43F0FD6F46AABF3030" 
      } 
   },
   "processorInformation": { 
      "systemTraceAuditNumber": "037809", 
      "approvalCode": "437964",
      "networktransactionId": "000002605437964",
      "retrievalReferenceNumber": "330009037809",
      "transactionId": "000002605437964",
      "responseCode": "00",
      "avs": {
         "code": "2"
      } 
   },
   "reconciliationId": "6984003567376178404953", 
   "status": "AUTHORIZED",
   "submitTimeUtc": "2023-10-27T09:52:39Z" 
}   
```

RELATED TO THIS PAGE