# performThreeDSecureLookup

Mutation · GraphQL API

Attempt to perform 3D Secure Authentication on credit card payment method. This may consume the payment method and return a new single-use payment method.

## Authentication

- CLIENT
- SERVER

## Input

- `input` (`PerformThreeDSecureLookupInput!`) — required

## Returns [PerformThreeDSecureLookupPayload](/braintree/graphql/reference/types/perform-three-d-secure-lookup-payload)

Top-level fields returned when performing a 3D Secure Lookup.

### Returned fields

- `clientMutationId` (`String`): An identifier used to reconcile requests and responses. 255 characters maximum.
- `threeDSecureLookupData` (`ThreeDSecureLookupData`): Data fields containing information from the MPI provider about the 3D Secure Lookup result.
- `paymentMethod` (`PaymentMethod`): A single-use payment method.

## Examples

### Perform 3D Secure lookup

Top-level fields for performing a 3D Secure Lookup.

```graphql
mutation performThreeDSecureLookup($input: PerformThreeDSecureLookupInput!) {
  performThreeDSecureLookup(input: $input) {
    clientMutationId
    threeDSecureLookupData {
      acsUrl
      authenticationId
      version
      pareq
      md
      termUrl
      transactionId
    }
    paymentMethod {
      __typename
      id
      legacyId
      usage
      createdAt
      details {
        __typename
        ... on CustomActionsPaymentMethodDetails {
          __typename
          actionName
          fields {
            name
            displayValue
          }
        }
        ... on CreditCardDetails {
          __typename
          brandCode
          last4
          bin
          binData {
            prepaid
            healthcare
            debit
            durbinRegulated
            commercial
            payroll
            issuingBank
            countryOfIssuance
            productId
            prepaidReloadable
            business
            consumer
            corporate
            purchase
          }
          expirationMonth
          expirationYear
          cardholderName
          uniqueNumberIdentifier
          origin {
            type
            details {
              __typename
              ... on ApplePayOriginDetails {
                __typename
                paymentInstrumentName
                bin
                merchantTokenIdentifier
                dpanLastTwo
                isDeviceToken
                last4
                paymentAccountReference
              }
              ... on GooglePayOriginDetails {
                __typename
                googleTransactionId
                bin
                last4
                paymentAccountReference
              }
              ... on MasterpassOriginDetails {
                __typename
                bin
              }
              ... on MetaCheckoutOriginDetails {
                __typename
                containerId
                bin
              }
              ... on NetworkTokenOriginDetails {
                __typename
                bin
              }
              ... on SamsungPayOriginDetails {
                __typename
                bin
              }
              ... on VisaCheckoutOriginDetails {
                __typename
                callId
                bin
              }
              ... on PayPalLocalPaymentOriginDetails {
                __typename
                captureId
                customField
                paymentId
                transactionFee {
                  value
                  currencyCode
                }
                blikAliases {
                  key
                  label
                }
              }
              ... on CardPresentOriginDetails {
                __typename
                authorizationMode
                pinVerified
                inputMode
                terminalId
                readerId
                storeId
              }
              ... on EmvCardOriginDetails {
                __typename
                authorizationMode
                pinVerified
                inputMode
                terminalId
                applicationPreferredName
                applicationIdentifier
                terminalVerificationResult
                cardSequenceNumber
                applicationInterchangeProfile
                terminalTransactionDate
                terminalTransactionType
                cashbackAmount
                applicationUsageControl
                terminalCountryCode
                applicationCryptogram
                cryptogramInformationData
                cardholderVerificationMethodResults
                applicationTransactionCounter
                unpredictableNumber
                issuerActionCodeDefault
                issuerActionCodeDenial
                issuerActionCodeOnline
                readerId
                storeId
              }
            }
          }
          billingAddress {
            company
            addressLine1
            addressLine2
            fullName
            adminArea2
            adminArea1
            postalCode
            countryCode
            phone {
              countryPhoneCode
              phoneNumber
              extensionNumber
            }
          }
          threeDSecure {
            authentication {
              cavv
              directoryServerTransactionId
              eciFlag
              liabilityShifted
              liabilityShiftPossible
              cardEnrolled
              authenticationStatus
              version
              xId
              threeDSecureServerTransactionId
              acsTransactionId
              paresStatus
              transactionStatus
              transactionStatusReason
            }
          }
          cardOnFileNetworkTokenized
          paymentAccountReference
        }
        ... on PayPalAccountDetails {
          __typename
          billingAgreementId
          billingAddress {
            company
            addressLine1
            addressLine2
            fullName
            adminArea2
            adminArea1
            postalCode
            countryCode
            phone {
              countryPhoneCode
              phoneNumber
              extensionNumber
            }
          }
          shippingAddress {
            company
            addressLine1
            addressLine2
            fullName
            adminArea2
            adminArea1
            postalCode
            countryCode
            phone {
              countryPhoneCode
              phoneNumber
              extensionNumber
            }
          }
          email
          phone
          payerId
          firstName
          lastName
          cobrandedCardLabel
          origin {
            type
            details {
              __typename
              ... on ApplePayOriginDetails {
                __typename
                paymentInstrumentName
                bin
                merchantTokenIdentifier
                dpanLastTwo
                isDeviceToken
                last4
                paymentAccountReference
              }
              ... on GooglePayOriginDetails {
                __typename
                googleTransactionId
                bin
                last4
                paymentAccountReference
              }
              ... on MasterpassOriginDetails {
                __typename
                bin
              }
              ... on MetaCheckoutOriginDetails {
                __typename
                containerId
                bin
              }
              ... on NetworkTokenOriginDetails {
                __typename
                bin
              }
              ... on SamsungPayOriginDetails {
                __typename
                bin
              }
              ... on VisaCheckoutOriginDetails {
                __typename
                callId
                bin
              }
              ... on PayPalLocalPaymentOriginDetails {
                __typename
                captureId
                customField
                paymentId
                transactionFee {
                  value
                  currencyCode
                }
                blikAliases {
                  key
                  label
                }
              }
              ... on CardPresentOriginDetails {
                __typename
                authorizationMode
                pinVerified
                inputMode
                terminalId
                readerId
                storeId
              }
              ... on EmvCardOriginDetails {
                __typename
                authorizationMode
                pinVerified
                inputMode
                terminalId
                applicationPreferredName
                applicationIdentifier
                terminalVerificationResult
                cardSequenceNumber
                applicationInterchangeProfile
                terminalTransactionDate
                terminalTransactionType
                cashbackAmount
                applicationUsageControl
                terminalCountryCode
                applicationCryptogram
                cryptogramInformationData
                cardholderVerificationMethodResults
                applicationTransactionCounter
                unpredictableNumber
                issuerActionCodeDefault
                issuerActionCodeDenial
                issuerActionCodeOnline
                readerId
                storeId
              }
            }
          }
          limitedUseOrderId
          selectedFinancingOption {
            term
            monthlyPayment {
              value
              currencyCode
            }
            discountPercentage
            discountAmount {
              value
              currencyCode
            }
          }
          fundingSourceDescription
          vaultedBillingAgreementId
        }
        ... on SamsungPayCardDetails {
          __typename
          brand
          brandCode
          bin
          binData {
            prepaid
            healthcare
            debit
            durbinRegulated
            commercial
            payroll
            issuingBank
            countryOfIssuance
            productId
            prepaidReloadable
            business
            consumer
            corporate
            purchase
          }
          sourceCardLast4
        }
        ... on VenmoAccountDetails {
          __typename
          username
          venmoUserId
        }
        ... on UsBankAccountDetails {
          __typename
          accountholderName
          accountType
          ownershipType
          bankName
          last4
          routingNumber
          verified
          achMandate {
            acceptedAt
          }
        }
        ... on SEPADirectDebitAccountDetails {
          __typename
          merchantOrPartnerCustomerId
          last4
          bankReferenceToken
          mandateType
        }
      }
      customer {
        __typename
        id
        legacyId
      }
    }
  }
}
```

### Perform 3D Secure lookup 3D Secure

Attempt to perform 3D Secure Authentication on credit card payment method. This may consume the payment method and return a new single-use payment method.

```graphql
mutation performThreeDSecureLookup3DSecure($input: PerformThreeDSecureLookupInput!, $authenticationInsightInput: AuthenticationInsightInput!)  {
  performThreeDSecureLookup(input: $input) {
    clientMutationId
    threeDSecureLookupData {
      acsUrl
      authenticationId
      version
      pareq
      md
      termUrl
      transactionId
    }
    paymentMethod {
      __typename
      id
      legacyId
      usage
      createdAt
      details {
        __typename
        ... on CustomActionsPaymentMethodDetails {
          __typename
          actionName
          fields {
            name
            displayValue
          }
        }
        ... on CreditCardDetails {
          __typename
          brandCode
          last4
          bin
          binData {
            prepaid
            healthcare
            debit
            durbinRegulated
            commercial
            payroll
            issuingBank
            countryOfIssuance
            productId
            prepaidReloadable
            business
            consumer
            corporate
            purchase
          }
          expirationMonth
          expirationYear
          cardholderName
          uniqueNumberIdentifier
          origin {
            type
            details {
              __typename
              ... on ApplePayOriginDetails {
                __typename
                paymentInstrumentName
                bin
                merchantTokenIdentifier
                dpanLastTwo
                isDeviceToken
                last4
                paymentAccountReference
              }
              ... on GooglePayOriginDetails {
                __typename
                googleTransactionId
                bin
                last4
                paymentAccountReference
              }
              ... on MasterpassOriginDetails {
                __typename
                bin
              }
              ... on MetaCheckoutOriginDetails {
                __typename
                containerId
                bin
              }
              ... on NetworkTokenOriginDetails {
                __typename
                bin
              }
              ... on SamsungPayOriginDetails {
                __typename
                bin
              }
              ... on VisaCheckoutOriginDetails {
                __typename
                callId
                bin
              }
              ... on PayPalLocalPaymentOriginDetails {
                __typename
                captureId
                customField
                paymentId
                transactionFee {
                  value
                  currencyCode
                }
                blikAliases {
                  key
                  label
                }
              }
              ... on CardPresentOriginDetails {
                __typename
                authorizationMode
                pinVerified
                inputMode
                terminalId
                readerId
                storeId
              }
              ... on EmvCardOriginDetails {
                __typename
                authorizationMode
                pinVerified
                inputMode
                terminalId
                applicationPreferredName
                applicationIdentifier
                terminalVerificationResult
                cardSequenceNumber
                applicationInterchangeProfile
                terminalTransactionDate
                terminalTransactionType
                cashbackAmount
                applicationUsageControl
                terminalCountryCode
                applicationCryptogram
                cryptogramInformationData
                cardholderVerificationMethodResults
                applicationTransactionCounter
                unpredictableNumber
                issuerActionCodeDefault
                issuerActionCodeDenial
                issuerActionCodeOnline
                readerId
                storeId
              }
            }
          }
          billingAddress {
            company
            addressLine1
            addressLine2
            fullName
            adminArea2
            adminArea1
            postalCode
            countryCode
            phone {
              countryPhoneCode
              phoneNumber
              extensionNumber
            }
          }
          threeDSecure {
            authentication {
              cavv
              directoryServerTransactionId
              eciFlag
              liabilityShifted
              liabilityShiftPossible
              cardEnrolled
              authenticationStatus
              version
              xId
              threeDSecureServerTransactionId
              acsTransactionId
              paresStatus
              transactionStatus
              transactionStatusReason
            }
            authenticationInsight(input: $authenticationInsightInput) {
              merchantAccountId
              customerAuthenticationRegulationEnvironment
              customerAuthenticationIndicator
            }
          }
          cardOnFileNetworkTokenized
          paymentAccountReference
        }
        ... on PayPalAccountDetails {
          __typename
          billingAgreementId
          billingAddress {
            company
            addressLine1
            addressLine2
            fullName
            adminArea2
            adminArea1
            postalCode
            countryCode
            phone {
              countryPhoneCode
              phoneNumber
              extensionNumber
            }
          }
          shippingAddress {
            company
            addressLine1
            addressLine2
            fullName
            adminArea2
            adminArea1
            postalCode
            countryCode
            phone {
              countryPhoneCode
              phoneNumber
              extensionNumber
            }
          }
          email
          phone
          payerId
          firstName
          lastName
          cobrandedCardLabel
          origin {
            type
            details {
              __typename
              ... on ApplePayOriginDetails {
                __typename
                paymentInstrumentName
                bin
                merchantTokenIdentifier
                dpanLastTwo
                isDeviceToken
                last4
                paymentAccountReference
              }
              ... on GooglePayOriginDetails {
                __typename
                googleTransactionId
                bin
                last4
                paymentAccountReference
              }
              ... on MasterpassOriginDetails {
                __typename
                bin
              }
              ... on MetaCheckoutOriginDetails {
                __typename
                containerId
                bin
              }
              ... on NetworkTokenOriginDetails {
                __typename
                bin
              }
              ... on SamsungPayOriginDetails {
                __typename
                bin
              }
              ... on VisaCheckoutOriginDetails {
                __typename
                callId
                bin
              }
              ... on PayPalLocalPaymentOriginDetails {
                __typename
                captureId
                customField
                paymentId
                transactionFee {
                  value
                  currencyCode
                }
                blikAliases {
                  key
                  label
                }
              }
              ... on CardPresentOriginDetails {
                __typename
                authorizationMode
                pinVerified
                inputMode
                terminalId
                readerId
                storeId
              }
              ... on EmvCardOriginDetails {
                __typename
                authorizationMode
                pinVerified
                inputMode
                terminalId
                applicationPreferredName
                applicationIdentifier
                terminalVerificationResult
                cardSequenceNumber
                applicationInterchangeProfile
                terminalTransactionDate
                terminalTransactionType
                cashbackAmount
                applicationUsageControl
                terminalCountryCode
                applicationCryptogram
                cryptogramInformationData
                cardholderVerificationMethodResults
                applicationTransactionCounter
                unpredictableNumber
                issuerActionCodeDefault
                issuerActionCodeDenial
                issuerActionCodeOnline
                readerId
                storeId
              }
            }
          }
          limitedUseOrderId
          selectedFinancingOption {
            term
            monthlyPayment {
              value
              currencyCode
            }
            discountPercentage
            discountAmount {
              value
              currencyCode
            }
          }
          fundingSourceDescription
          vaultedBillingAgreementId
        }
        ... on SamsungPayCardDetails {
          __typename
          brand
          brandCode
          bin
          binData {
            prepaid
            healthcare
            debit
            durbinRegulated
            commercial
            payroll
            issuingBank
            countryOfIssuance
            productId
            prepaidReloadable
            business
            consumer
            corporate
            purchase
          }
          sourceCardLast4
        }
        ... on VenmoAccountDetails {
          __typename
          username
          venmoUserId
        }
        ... on UsBankAccountDetails {
          __typename
          accountholderName
          accountType
          ownershipType
          bankName
          last4
          routingNumber
          verified
          achMandate {
            acceptedAt
          }
        }
        ... on SEPADirectDebitAccountDetails {
          __typename
          merchantOrPartnerCustomerId
          last4
          bankReferenceToken
          mandateType
        }
      }
      customer {
        __typename
        id
        legacyId
      }
    }
  }
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)