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
id
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

REST Example: Updating MIT Authorization Options

Light Dark
Request
1234567891011
{"processingInformation": { "authorizationOptions": { "initiator": { "merchantInitiatedTransaction": { "previousTransactionId": "123456789012345", "originalAuthorizedAmount": "1", "processorTransactionId": "123456789012345123" } } } }}
Response to a Successful Request
12345678910111213141516171819202122232425262728
{"_links": { "self": { "href": "https://apitest.visaacceptance.comhttps://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/7010000000016241111" }, "paymentInstruments": { "href": "https://apitest.visaacceptance.comhttps://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" }}