On This Page

{#jumplink-list}  
[Markdown](/content/cybsdeveloper2021/amer/en/docs/cybs/en-us/urban-mobility/developer/ctv/rest/mass-transit/um-processing-tms/um-processing-sale-debtrecov-tkn-intro.md)  
Filter  
FILTER BY TAG

Mass Transit Tap-Initiated Sale for Debt Recovery with a Token {#um-processing-sale-debtrecov-tkn-intro}
========================================================================================================

This section describes how to process a tap-initiated sale for debt recovery with a token.  
A sale transaction is a bundled authorization and capture. When a cardholder attempts to use a blocked card at the transit reader, create a fresh debt recovery sale request using the chip data from the new tap, along with the fare amount of the previous declined authorization.

Endpoint
--------

**Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`  
**Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`

Required Fields for a Tap-Initiated Sale for Debt Recovery with a Token Using the REST API {#um-processing-sale-debtrecov-tkn-reqd-fields}
==========================================================================================================================================

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

[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.entryMode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-entry-mode.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.terminalId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/pos-info-aa/pos-info-terminal-id.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 "")
:

[processingInformation.authorizationOptions.debtRecoveryIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-debt-recovery-ind.md "")
:
Set this field to `true`.

[processingInformation.authorizationOptions.deferredAuthIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-deferred-auth-ind.md "")
:
Set this field to `true`.

[processingInformation.capture](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-capture-a.md "")
:
Set this field to `true`.

[processingInformation.captureOptions.dateToCapture](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-capture-ops-date-to-capture.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 this field to `retail`.

[processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "")
:
Set this field to `transit`.

[processingInformation.reconciliationId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-reconciliation-id.md "")
:

[tokenInformation.jti](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/token-info-aa/token-info-jti.md "")
:

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

REST Example: Performing a Tap-Initiated Sale for Debt Recovery with a Token {#um-processing-sale-debtrecov-tkn-ex-rest}
========================================================================================================================

Request

```
{
    "clientReferenceInformation": {
        "transactionId": "12987654321",
        "partner": {
            "thirdPartyCertificationNumber": "123456789012"
        }
    },
    "processingInformation": {
        "industryDataType": "transit",
        "reconciliationId": "dsgfsgsgsfdsgf",
        "captureOptions": {
            "dateToCapture": "0114"
        },
        "capture": "true",
        "processingInformation.commerceIndicator" : "retail",
        "authorizationOptions": {
            "debtRecoveryIndicator": "true",
            "deferredAuthIndicator": "true"
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "10.00",
            "currency": "THB"
        }
    },
    "paymentInformation": {
        "card": {
            "type": "001"    
        }
    },
    "tokenInformation": {
        "jti": "a76392f4-cde4-97aa-1111-0242ac14c005"
    },
    "pointOfSaleInformation": {
        "terminalId": "12345678",
        "catLevel": "2",
        "entryMode": "contactless",
        "terminalCapability": "5",
        "terminalPinCapability": "0"
    }
}
```

Response to a Successful Request

```
{
    "_links": {
        "void": {
            "method": "POST",
            "href": "/pts/v2/payments/6502821914766725604006/voids"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/payments/6502821914766725604006"
        }
    },
    "clientReferenceInformation": {
        "code": "123456",
        "transactionId": "12987654321"
    },
    "id": "6502821914766725604006",
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "10.00",
            "authorizedAmount": "10.00",
            "currency": "THB"
        }
    },
    "paymentAccountInformation": {
        "card": {
            "type": "001"
        }
    },
    "paymentInformation": {
        "accountFeatures": {
            "category": "A",
            "group": "0"
        },
        "tokenizedCard": {
            "type": "001"
        },
        "card": {
            "type": "001"
        }
    },
    "pointOfSaleInformation": {
        "emv": {
            "tags": "5004564953419F26087C14E9BE1F1065094F07A0000000031010820220009F360203709F0702C0809F2701409F100706010A03902000950500000000009F3704DB6AD1679A032111145F3401019F1A0203809F33036008C89F34031F03029F3501259F02060000000000009F03060000000000005F2A0209789C01005F2D046974656E9F0607A00000000310108407A00000000310109F21031726589F6E04207000009F40052000000001DFFEC30A020100"
        }
    },
    "processorInformation": {
        "systemTraceAuditNumber": "114880",
        "approvalCode": "831000",
        "networktransactionId": "016153570198200",
        "retrievalReferenceNumber": "210811114880",
        "transactionId": "12987654321",
        "responseCode": "00",
        "avs": {
            "code": "2"
        }
    },
    "reconciliationId": "dsgfsgsgsfdsgf",
    "status": "AUTHORIZED",
    "submitTimeUtc": "2022-04-18T11:43:11Z"
}
```

RELATED TO THIS PAGE