---
title: "Update a Secure Fields transaction"
method: PATCH
path: "/v1/transactions/secureFields/{transactionId}"
tags: ["/v1/transactions"]
---

# Update a Secure Fields transaction

`PATCH /v1/transactions/secureFields/{transactionId}`

Use this API to update a Secure Fields transaction. This action is only allowed before the 3D process. At least one property must be updated.

## Path parameters

- `transactionId` integer, required — The `transactionId` received from the [Initialize a Secure Fields transaction](#operation/secureFieldsInit) call

## Request body

- SecureFieldsUpdateRequest
  - `amount` integer — The newly to be used amount in the currency’s smallest unit. For example use 1000 for CHF 10.00.
  - `currency` string, required — 3 letter <a href='https://en.wikipedia.org/wiki/ISO_4217' target='_blank'>ISO-4217</a> character code. For example `CHF` or `USD`
  - `3D` SecureFieldsThreeDSecure — Refer to the official <a href='https://www.emvco.com/specifications/emv-3-d-secure-protocol-and-core-functions-specification-6'>EMVCo. specifications</a> for parameter requirements.
    - `threeDSRequestor` ThreeDSRequestor
      - `threeDSRequestorAuthenticationInd` '01' | '02' | '03' | '04' | '05' | '06'
      - `threeDSRequestorAuthenticationInfo` ThreeDSRequestorAuthenticationInformation
        - `threeDSReqAuthMethod` '01' | '02' | '03' | '04' | '05' | '06'
        - `threeDSReqAuthTimestamp` string, date-time
        - `threeDSReqAuthData` string
      - `threeDSRequestorChallengeInd` '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '82' | '90'
      - `threeDSRequestorDecReqInd` 'Y' | 'N'
      - `threeDSRequestorDecMaxTime` integer
    - `threeDSRequestorURL` string, url
    - `cardholderAccount` CardholderAccount
      - `cardExpiryDate` string
      - `acctInfo` CardholderAccountInformation
        - `chAccDate` string, date-time
        - `chAccChangeInd` '01' | '02' | '03' | '04'
        - `chAccChange` string, date-time
        - `chAccPwChangeInd` '01' | '02' | '03' | '04' | '05'
        - `chAccPwChange` string, date-time
        - `shipAddressUsageInd` '01' | '02' | '03' | '04'
        - `shipAddressUsage` string, date-time
        - `txnActivityDay` integer
        - `txnActivityYear` integer
        - `provisionAttemptsDay` integer
        - `nbPurchaseAccount` integer
        - `suspiciousAccActivity` '01' | '02'
        - `shipNameIndicator` '01' | '02'
        - `paymentAccInd` '01' | '02' | '03' | '04' | '05'
        - `paymentAccAge` string, date-time
      - `acctID` string
    - `cardholder` Cardholder
      - `addrMatch` 'Y' | 'N'
      - `billAddrCity` string
      - `billAddrCountry` string
      - `billAddrLine1` string
      - `billAddrLine2` string
      - `billAddrLine3` string
      - `billAddrPostCode` string
      - `billAddrState` string
      - `email` string
      - `homePhone` CardholderPhoneNumber
        - `cc` string
        - `subscriber` string
      - `mobilePhone` CardholderPhoneNumber
        - `cc` string
        - `subscriber` string
      - `workPhone` CardholderPhoneNumber
        - `cc` string
        - `subscriber` string
      - `cardholderName` string
      - `shipAddrCity` string
      - `shipAddrCountry` string
      - `shipAddrLine1` string
      - `shipAddrLine2` string
      - `shipAddrLine3` string
      - `shipAddrPostCode` string
      - `shipAddrState` string
    - `purchase` Purchase
      - `purchaseInstalData` integer
      - `merchantRiskIndicator` MerchantRiskIndicator
        - `shipIndicator` '01' | '02' | '03' | '04' | '05' | '06' | '07'
        - `deliveryTimeframe` '01' | '02' | '03' | '04'
        - `deliveryEmailAddress` string
        - `reorderItemsInd` '01' | '02'
        - `preOrderPurchaseInd` '01' | '02'
        - `preOrderDate` string, date-time
        - `giftCardAmount` integer
        - `giftCardCurr` string
        - `giftCardCount` string
      - `purchaseAmount` integer
      - `purchaseCurrency` string
      - `purchaseExponent` integer
      - `purchaseDate` string, date-time
      - `recurringExpiry` string, date-time
      - `recurringFrequency` integer
      - `transType` '01' | '03' | '10' | '11' | '28'
    - `acquirer` SecureFieldsThreeDSecureAcquirer
      - `acquirerBin` string
      - `acquirerMerchantId` string
    - `merchant` MerchantData
      - `whiteListStatus` 'Y' | 'N'
    - `broadInfo` string
    - `browserInformation` Browser
      - `browserAcceptHeader` string
      - `browserIP` string
      - `browserJavaEnabled` boolean
      - `browserLanguage` string
      - `browserColorDepth` '1' | '4' | '8' | '15' | '16' | '24' | '32' | '48'
      - `browserScreenHeight` integer
      - `browserScreenWidth` integer
      - `browserTZ` integer
      - `browserUserAgent` string
      - `challengeWindowSize` '01' | '02' | '03' | '04' | '05'
      - `browserJavascriptEnabled` boolean
    - `threeRIInd` '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '12'

## Response `204`

Transaction successfully updated

## Other responses

- `409` — Invalid transaction status

---

[API](https://skmtc.net/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints.md) · [All operations](https://skmtc.net/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pci-proxy/pci-proxy-api-reference-datatrans-endpoints/versions/1f4f905fd175/schema)