On This Page

{#jumplink-list}  
[Markdown](/docs/vas/en-us/cp-retail/integration/ctv/rest/cp-retail/cp-services-mpos-intro/cp-services-auth-mpos-embed-reader-sw-pin-intro.md)  
Filter  
FILTER BY TAG

Authorization with an mPOS Using an Embedded Reader and Software PIN Entry {#cp-services-auth-mpos-embed-reader-sw-pin-intro}
=============================================================================================================================

This section describes how to process a mobile point-of-sale (mPOS) authorization using an embedded reader with software PIN entry. This type of transaction is also known as a Tap to Phone with PIN transaction.

Fields Specific To This Use Case
--------------------------------

These API fields and values are specific to this use case:

pointOfSaleInformation.pinEntrySolution
:
Set the value to `PCI-SPoC`.

pointOfSaleInformation.terminalPinCapability
:

Endpoint {#cp-services-auth-mpos-embed-reader-sw-pin-intro_d7e16}
-----------------------------------------------------------------

**Production:** `POST ``https://api.visaacceptance.com``/pts/v2/payments`{#cp-services-auth-mpos-embed-reader-sw-pin-intro_d7e25}  
**Test:** `POST ``https://apitest.visaacceptance.com``/pts/v2/payments`{#cp-services-auth-mpos-embed-reader-sw-pin-intro_d7e35}

Required Fields for Processing an Authorization with an mPOS Using an Embedded Reader and Software PIN Entry {#cp-services-auth-mpos-embed-reader-sw-pin-api-reqfields}
=======================================================================================================================================================================

[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.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 "")
:
`Visa Acceptance Solutions` provides the value for this field.

clientReferenceInformation.transactionId
:

[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.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.catLevel](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-cat-level.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 "")
:

[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.entryMode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-entry-mode.md "")
:
Set the value to `contactless`.

[pointOfSaleInformation.pinEntrySolution](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-pin-entry-solution.md "")
:
Set the value to `PCI-SPoC`.

[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`.

Mastercard-Specific Field
-------------------------

[pointOfSaleInformation.isDedicatedHardwareTerminal](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-is-dedicated-hardware-terminal.md "")
:
Set the value to `1`.

REST Example: Processing an Authorization with an mPOS Using an Embedded Reader and Software PIN Entry for Mastercard {#cp-services-auth-mpos-embed-reader-sw-pin-mc-api-ex-rest}
=================================================================================================================================================================================

Request

```
{
    "clientReferenceInformation" : {
        "code" : "123456",
        "transactionId": "12233445677",
        "partner": {
            "thirdPartyCertificationNumber":"123456789012"
        }
    },
    "processingInformation": {
        "commerceIndicator": "retail"
    },
    "pointOfSaleInformation": {
        "trackData": "%B4111111111111111^TEST/CYBS         ^2512201019761100      00868000000?;",
        "catLevel": "6",
        "isDedicatedHardwareTerminal": "1",
        "terminalPinCapability": "4",
        "pinEntrySolution": "PCI-SPoC",
        "emv": {
            "cardSequenceNumber": "01",
            "tags": "9F3303204000950500000000009F3704518823719F100706011103A000009F260
        81E1756ED0E2134E29F36020015820200009C01009F1A0208409A030006219F02060000000020005
        F2A0208409F0306000000000000"
        },
        "entryMode": "contactless",
        "terminalCapability": "4"
    },
    "paymentInformation": {
        "card": {
            "type": "002"
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "9900.00",
            "currency": "USD"
        }
    }
}
```

Response for a Successful Request

```
{
    "_links": {
        "authReversal": {
            "method": "POST",
            "href": "/pts/v2/payments/6873925966666764004953/reversals"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/payments/6873925966666764004953"
        },
        "capture": {
            "method": "POST",
            "href": "/pts/v2/payments/6873925966666764004953/captures"
        }
    },
    "clientReferenceInformation": {
        "code": "123456"
    },
    "id": "6873925966666764004953",
    "orderInformation": {
        "amountDetails": {
            "authorizedAmount": "9900.00",
            "currency": "USD"
        }
    },
    "paymentAccountInformation": {
        "card": {
            "type": "002"
        }
    },
    "paymentInformation": {
        "tokenizedCard": {
            "type": "002"
        },
        "card": {
            "type": "002"
        }
    },
    "pointOfSaleInformation": {
        "terminalId": "111111",
        "emv": {
            "tags": "9F02060000000009009C01009A030608025F2A0209789F1A0208409F260856BF2
        99472BDB0C782025C009F360245679F370412135414950540800080009F1E04001122339F1020060
        11A03900000112233445566778899AABBCCDD0390000011223344556677889F5301039F410301223
        39F03060001020304058407A00000000410109F2701809F34035E03009F090243219F3501059F330
        3E0B8C89110001122334455667788010203040506079F5B1000112233445566778801020304050607"
        }
    },
    "processorInformation": {
        "approvalCode": "888888",
        "networkTransactionId": "123456789619999",
        "transactionId": "123456789619999",
        "responseCode": "100",
        "avs": {
            "code": "1"
        }
    },
    "reconciliationId": "718515862J420LJ2",
    "status": "AUTHORIZED",
    "submitTimeUtc": "2023-06-22T00:09:56Z"
}
```

REST Example: Processing an Authorization with an mPOS Using an Embedded Reader and Software PIN Entry for Visa {#cp-services-auth-mpos-embed-reader-sw-pin-visa-api-ex-rest}
=============================================================================================================================================================================

Request

```
{
    "clientReferenceInformation" : {
        "code" : "123456",
        "transactionId": "12233445677",
        "partner": {
            "thirdPartyCertificationNumber":"123456789012"
        }
    },
    "processingInformation": {
        "commerceIndicator": "retail"
    },
    "pointOfSaleInformation": {
        "trackData": "%B4111111111111111^TEST/CYBS         ^2512201019761100      00868000000?;",
        "catLevel": "6",
        "terminalPinCapability": "4",
        "pinEntrySolution": "PCI-SPoC",
        "emv": {
            "cardSequenceNumber": "01",
            "tags": "9F3303204000950500000000009F3704518823719F100706011103A000009F260
        81E1756ED0E2134E29F36020015820200009C01009F1A0208409A030006219F02060000000020005
        F2A0208409F0306000000000000"
        },
        "entryMode": "contactless",
        "terminalCapability": "4"
    },
    "paymentInformation": {
        "card": {
            "type": "001"
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "9900.00",
            "currency": "USD"
        }
    }
}
```

Response for a Successful Request

```
{
    "_links": {
        "authReversal": {
            "method": "POST",
            "href": "/pts/v2/payments/6873925966666764004953/reversals"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/payments/6873925966666764004953"
        },
        "capture": {
            "method": "POST",
            "href": "/pts/v2/payments/6873925966666764004953/captures"
        }
    },
    "clientReferenceInformation": {
        "code": "123456"
    },
    "id": "6873925966666764004953",
    "orderInformation": {
        "amountDetails": {
            "authorizedAmount": "9900.00",
            "currency": "USD"
        }
    },
    "paymentAccountInformation": {
        "card": {
            "type": "001"
        }
    },
    "paymentInformation": {
        "tokenizedCard": {
            "type": "001"
        },
        "card": {
            "type": "001"
        }
    },
    "pointOfSaleInformation": {
        "terminalId": "111111",
        "emv": {
            "tags": "9F02060000000009009C01009A030608025F2A0209789F1A0208409F260856BF2
        99472BDB0C782025C009F360245679F370412135414950540800080009F1E04001122339F1020060
        11A03900000112233445566778899AABBCCDD0390000011223344556677889F5301039F410301223
        39F03060001020304058407A00000000410109F2701809F34035E03009F090243219F3501059F330
        3E0B8C89110001122334455667788010203040506079F5B1000112233445566778801020304050607"
        }
    },
    "processorInformation": {
        "approvalCode": "888888",
        "networkTransactionId": "123456789619999",
        "transactionId": "123456789619999",
        "responseCode": "100",
        "avs": {
            "code": "1"
        }
    },
    "reconciliationId": "718515862J420LJ2",
    "status": "AUTHORIZED",
    "submitTimeUtc": "2023-06-22T00:09:56Z"
}
```

RELATED TO THIS PAGE