Merchant-Initiated Resubmission Transaction with `TMS` {#credentials-resub-mit-tms-intro} ========================================================================================= A resubmission transaction is an authorization that you resubmit to recover an outstanding debt from the customer. A common scenario is when a card was initially declined due to insufficient funds, but the goods or services were already delivered to the customer. This section describes how to process a merchant-initiated resubmission transaction using these `TMS` token types: **Customer** : Customer tokens store one or more customer payment instrument tokens and shipping address tokens. : Including a customer token eliminates the need to include billing information, card information, and the previous transaction's ID. : ``` "paymentInformation": { "customer": { "id": "07C9CA98022DA498E063A2598D0AA400" } } ``` **Payment Instrument** : Payment instrument tokens store an instrument identifier token, card information, and billing information. Payment instruments are not linked to a customer token. : Including a payment instrument eliminates the need to include billing information, card information, and the previous transaction's ID. : ``` "paymentInformation": { "paymentInstrument": { "id": "07CA24EF20F9E2C9E063A2598D0A8565" } } ``` **Instrument Identifier** : Instrument identifier tokens store only a PAN. Including an instrument identifier eliminates the need to include a PAN and the previous transaction's ID. : ``` "paymentInformation": { "instrumentIdentifier": { "id": "7010000000016241111" } } ``` Supported Card Types -------------------- These are the supported card types for processing credentialed transactions: * American Express{#credentials-resub-mit-tms-intro_d7e271} {#credentials-resub-mit-tms-intro_d7e271} * Carta Si{#credentials-resub-mit-tms-intro_d7e274} {#credentials-resub-mit-tms-intro_d7e274} * Cartes Bancaires{#credentials-resub-mit-tms-intro_d7e277} {#credentials-resub-mit-tms-intro_d7e277} * Dankort{#credentials-resub-mit-tms-intro_d7e280} {#credentials-resub-mit-tms-intro_d7e280} * Delta{#credentials-resub-mit-tms-intro_d7e283} {#credentials-resub-mit-tms-intro_d7e283} * Eurocard{#credentials-resub-mit-tms-intro_d7e287} {#credentials-resub-mit-tms-intro_d7e287} * JCB{#credentials-resub-mit-tms-intro_d7e290} {#credentials-resub-mit-tms-intro_d7e290} * Maestro (UK Domestic){#credentials-resub-mit-tms-intro_d7e293} {#credentials-resub-mit-tms-intro_d7e293} * Mastercard{#credentials-resub-mit-tms-intro_d7e296} {#credentials-resub-mit-tms-intro_d7e296} * Visa{#credentials-resub-mit-tms-intro_d7e299} {#credentials-resub-mit-tms-intro_d7e299} * Visa Electron{#credentials-resub-mit-tms-intro_d7e302} {#credentials-resub-mit-tms-intro_d7e302} Endpoint {#credentials-resub-mit-tms-intro_d8e16} ------------------------------------------------- **Production:** `POST ``https://api.visaacceptance.com``/pts/v2/payments`{#credentials-resub-mit-tms-intro_d8e25} **Test:** `POST ``https://apitest.visaacceptance.com``/pts/v2/payments`{#credentials-resub-mit-tms-intro_d8e35} Required Fields for MIT Resubmission Transaction with `TMS` {#credentials-resub-mit-tms-req-fields} =================================================================================================== orderInformation.amountDetails.currency : orderInformation.amountDetails.totalAmount : paymentInformation.\[tokentype\].id : Where \[tokentype\] is the `TMS` token type you are using: : * customer * instrumentIdentifier * paymentInstrument {#credentials-resub-mit-tms-req-fields_ul_lx4_s3d_1dc} processingInformation. authorizationOptions. initiator. merchantInitiatedTransaction. reason : Set the value to `1`. : Required only for Discover, Mastercard, and Visa. Instrument Identifier Required Fields ------------------------------------- If you are using the paymentInformation.instrumentIdentifier.id token, include these required fields in addition to the required fields listed above. orderInformation.billTo.address1 : orderInformation.billTo.administrativeArea : orderInformation.billTo.country : orderInformation.billTo.email : orderInformation.billTo.firstName : orderInformation.billTo.lastName : orderInformation.billTo.locality : orderInformation.billTo.phoneNumber : orderInformation.billTo.postalCode : paymentInformation.card.expirationMonth : paymentInformation.card.expirationYear : Card-Specific Required Fields ----------------------------- Include these fields when processing an authorization with these card types. The listed card type requires an additional field. Diners Club : processorInformation.cardReferenceData: : Required only for token transactions. Set this field to the processorInformation.cardReferenceData field that was in the response message when you obtained the customer's credentials. : issuerInformation.transactionInformation: : Required only for token transactions. Set this field to the processorInformation.transactionID field that was in the response message when you obtained the customer's credentials. Discover : processingInformation.authorizationOptions.initiator. merchantInitiatedTransaction.originalAuthorizedAmount : Set to the original transaction amount. : processorInformation.cardReferenceData : Required only for token transactions. Set this field to the processorInformation.cardReferenceData field that was in the response message when you obtained the customer's credentials. : issuerInformation.transactionInformation : Required only for token transactions. Set this field to the processorInformation.transactionID field that was in the response message when you obtained the customer's credentials. REST Example: MIT Resubmission Transaction with a `TMS` Instrument Identifier {#credentials-resub-mit-tms-iid-ex-rest} ====================================================================================================================== Request ```keyword { "processingInformation": { "authorizationOptions": { "initiator": { "merchantInitiatedTransaction": { "reason": "1" } } } }, "paymentInformation": { "card": { "expirationMonth": "12", "expirationYear": "2031" }, "instrumentIdentifier": { "id": "7010000000016241111" } }, "orderInformation": { "amountDetails": { "totalAmount": "102.21", "currency": "USD" }, "billTo": { "firstName": "John", "lastName": "Doe", "address1": "1 Market St", "locality": "san francisco", "administrativeArea": "CA", "postalCode": "94105", "country": "US", "email": "test@vas.com", "phoneNumber": "4158880000" } } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/6976922830456934003954/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6976922830456934003954" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6976922830456934003954/captures" } }, "clientReferenceInformation": { "code": "1697692283160" }, "id": "6976922830456934003954", "orderInformation": { "amountDetails": { "authorizedAmount": "102.21", "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "instrumentIdentifier": { "id": "7010000000016241111", "state": "ACTIVE" }, "card": { "type": "001" } }, "pointOfSaleInformation": { "terminalId": "111111" }, "processingInformation": { "paymentSolution": "015" }, "processorInformation": { "paymentAccountReferenceNumber": "V0010013022298169667504231315", "approvalCode": "888888", "networkTransactionId": "123456789619999", "transactionId": "123456789619999", "responseCode": "100", "avs": { "code": "X", "codeRaw": "I1" } }, "reconciliationId": "62700184NNMR6XFK", "status": "AUTHORIZED", "submitTimeUtc": "2023-10-19T05:11:23Z" } ``` REST Example: MIT Resubmission Transaction with a `TMS` Payment Instrument {#credentials-resub-mit-tms-pid-ex-rest} =================================================================================================================== Request ``` { "processingInformation": { "authorizationOptions": { "initiator": { "merchantInitiatedTransaction": { "reason": "1" } } } }, "paymentInformation": { "paymentInstrument": { "id": "080AE120369A7947E063A2598D0A718F" } }, "orderInformation": { "amountDetails": { "totalAmount": "102.21", "currency": "USD" } } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/6976917718796256603955/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6976917718796256603955" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6976917718796256603955/captures" } }, "clientReferenceInformation": { "code": "1697691771976" }, "id": "6976917718796256603955", "orderInformation": { "amountDetails": { "authorizedAmount": "102.21", "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "instrumentIdentifier": { "id": "7010000000016241111", "state": "ACTIVE" }, "paymentInstrument": { "id": "080AE120369A7947E063A2598D0A718F" }, "card": { "type": "001" } }, "pointOfSaleInformation": { "terminalId": "111111" }, "processingInformation": { "paymentSolution": "015" }, "processorInformation": { "paymentAccountReferenceNumber": "V0010013022298169667504231315", "approvalCode": "888888", "networkTransactionId": "123456789619999", "transactionId": "123456789619999", "responseCode": "100", "avs": { "code": "X", "codeRaw": "I1" } }, "reconciliationId": "62700629BNN13VGW", "status": "AUTHORIZED", "submitTimeUtc": "2023-10-19T05:02:52Z" } ``` REST Example: MIT Reauthorization Transaction with a `TMS` Customer {#credentials-resub-mit-tms-cid-ex-rest} ============================================================================================================ Request ``` { "processingInformation": { "authorizationOptions": { "initiator": { "merchantInitiatedTransaction": { "reason": "1" } } } }, "paymentInformation": { "customer": { "id": "080AC9AB60C92AA2E063A2598D0A0C74" } }, "orderInformation": { "amountDetails": { "totalAmount": "102.21", "currency": "USD" } } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/6976916433716228003955/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6976916433716228003955" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6976916433716228003955/captures" } }, "clientReferenceInformation": { "code": "1697691643458" }, "id": "6976916433716228003955", "orderInformation": { "amountDetails": { "authorizedAmount": "102.21", "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "instrumentIdentifier": { "id": "7010000000016241111", "state": "ACTIVE" }, "paymentInstrument": { "id": "080AE6DB37B09557E063A2598D0AA4C9" }, "card": { "type": "001" }, "customer": { "id": "080AC9AB60C92AA2E063A2598D0A0C74" } }, "pointOfSaleInformation": { "terminalId": "111111" }, "processingInformation": { "paymentSolution": "015" }, "processorInformation": { "paymentAccountReferenceNumber": "V0010013022298169667504231315", "approvalCode": "888888", "networkTransactionId": "123456789619999", "transactionId": "123456789619999", "responseCode": "100", "avs": { "code": "X", "codeRaw": "I1" } }, "reconciliationId": "62700435FNN143RY", "status": "AUTHORIZED", "submitTimeUtc": "2023-10-19T05:00:43Z" } ```