Update Merchant-Initiated Transaction Authorization Options

This section shows you how to update merchant-initiated transaction (MIT) authorization options.

Endpoint

Test:

PATCH https://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/{instrumentIdentifierTokenId}

Production:

PATCH https://api.visaacceptance.com/tms/v1/instrumentidentifiers/{instrumentIdentifierTokenId}

{instrumentIdentifierTokenId}
is the instrument identifier token ID returned in the

field when you created the instrument identifier token. For more information, see Create an Instrument Identifier.

Required Fields for Updating MIT Authorization Options

processingInformation.authorizationOptions. initiator.merchantInitiatedTransaction.previousTransactionId
processingInformation.authorizationOptions. initiator.merchantInitiatedTransaction.originalAuthorizedAmount
processingInformation.authorizationOptions. initiator.merchantInitiatedTransaction.processorTransactionId

Update Merchant-Initiated Transaction Authorization Options

REST Example: Updating MIT Authorization Options

Request

{
    "processingInformation": {
        "authorizationOptions": {
            "initiator": {
                "merchantInitiatedTransaction": {
                    "previousTransactionId": "123456789012345",
                    "originalAuthorizedAmount": "1",
                    "processorTransactionId": "123456789012345123"
                }
            }
        }
    }
}

Response to a Successful Request

{
    "_links": {
        "self": {
            "href": "https://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/7010000000016241111"
        },
        "paymentInstruments": {
            "href": "https://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/7010000000016241111/paymentinstruments"
        }
    },
    "id": "7010000000016241111",
    "object": "instrumentIdentifier",
    "state": "ACTIVE",
    "card": {
        "number": "411111XXXXXX1111"
    },
    "processingInformation": {
        "authorizationOptions": {
            "initiator": {
                "merchantInitiatedTransaction": {
                    "previousTransactionId": "123456789012345",
                    "originalAuthorizedAmount": "1",
                    "processorTransactionId": "123456789012345123"
                }
            }
        }
    },
    "metadata": {
        "creator": "testrest"
    }
}

Update Merchant-Initiated Transaction Authorization Options