Update a Payment Instrument

This section shows you how to update a payment instrument token.

Endpoint

Test:
PATCH
https://apitest.cybersource.com
/tms/v1/paymentinstruments/
{paymentInstrumentTokenId}
Production:
PATCH
https://api.cybersource.com
/tms/v1/paymentinstruments/
{paymentInstrumentTokenId}
Production in India:
PATCH
https://api.in.cybersource.com
/tms/v1/paymentinstruments/
{paymentInstrumentTokenId}
The
{paymentInstrumentTokenId}
 is the payment instrument token ID you want to retrieve. For more information, see Create a Payment Instrument.

Required Fields for Updating a Payment Instrument Using the REST API

paymentInstrumentTokenId
Include the ID of the payment instrument token you want to retrieve in the URL path.

Optional Fields for Updating a Payment Instrument Using the REST API

default
bankAccount.type
card.issueNumber
card.startMonth
card.startYear
card.useAs
tokenizedInformation.requestorID
tokenizedInformation.transactionType
buyerInformation.companyTaxID
buyerInformation.currency
buyerInformation.dateOfBirth
buyerInformation.personalIdentification.id
buyerInformation.personalIdentification.type
buyerInformation.personalIdentification.issuedBy.administrativeArea
billTo.address2
processingInformation.billPaymentProgramEnabled
processingInformation.bankTransferOptions.SECCode
merchantInformation.merchantDescriptor.alternateName

REST Example: Updating a Payment Instrument

Request 
        

         
          
PATCH 
            
https://apitest.cybersource.com
            
/tms/v1/paymentinstruments/F39763E8CFDF2354E053AF598E0AF684
          


{
  "card": {
    "expirationMonth": "12",
    "expirationYear": "2031",
    "type": "visa"
  },
  "billTo": {
    "firstName": "John",
    "lastName": "Doe",
    "company": "Company Name",
    "address1": "1 Market St",
    "address2": "Unit B"
    "locality": "San Francisco",
    "administrativeArea": "CA",
    "postalCode": "94105",
    "country": "US",
    "email": "
          
test@cybs.com
          
",
    "phoneNumber": "4158880000"
  },
  "instrumentIdentifier": {
    "id": "7010000000016241111"
  }
}
Response to a Successful Request 
        
{
  "_links": {
    "self": {
      "href": "
          
https://apitest.cybersource.com
          
/tms/v1/paymentinstruments/F39763E8CFDF2354E053AF598E0AF684"
    }
  },
  "id": "F39763E8CFDF2354E053AF598E0AF684",
  "object": "paymentInstrument",
  "state": "ACTIVE",
  "card": {
    "expirationMonth": "12",
    "expirationYear": "2031",
    "type": "visa"
  },
  "billTo": {
    "firstName": "Jack",
    "lastName": "Smith",
    "company": "Company Name",
    "address1": "1 Market St",
    "address2": "Unit B",
    "locality": "San Francisco",
    "administrativeArea": "CA",
    "postalCode": "94105",
    "country": "US",
    "email": "updatedemail@vas.com",
    "phoneNumber": "4158888674"
  },
  "metadata": {
    "creator": "testrest"
  },
  "_embedded": {
    "instrumentIdentifier": {
      "_links": {
        "self": {
          "href": "
          
https://apitest.cybersource.com
          
/tms/v1/instrumentidentifiers/7010000000016241111"
        },
        "paymentInstruments": {
          "href": "
          
https://apitest.cybersource.com
          
/tms/v1/instrumentidentifiers/7010000000016241111/paymentinstruments"
        }
      },
      "id": "7010000000016241111",
      "object": "instrumentIdentifier",
      "state": "ACTIVE",
      "card": {
        "number": "411111XXXXXX1111"
      },
      "processingInformation": {
        "authorizationOptions": {
          "initiator": {
            "merchantInitiatedTransaction": {
              "previousTransactionId": "123456789619999"
            }
          }
        }
      },
      "metadata": {
        "creator": "testrest"
      }
    }
  }
}