JPMorgan Chase Authentication API

Authentication

Operations 3

POST /authentications Prepare a 3DS authentication #
POST /authentications/{authentication-id} Perform a 3DS authentication #
GET /authentications/{authentication-id} Retrieve an authentication request #

Documentation

📖
Documentation
https://developer.payments.jpmorgan.com/api
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fembedded-finance-solutions%2Fembedded-payments%2Fonboarding-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Fconsumer-profile%2Fconsumer-profile-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Ftokenization%2Ftokenization-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Freporting%2Freporting-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Ftreasury%2Freceivables%2Frequest-to-pay-api.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Fonline-payments%2Fcheckout%2Fcheckout-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Fdispute-management%2Fdispute-management-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Ffraud-solutions%2Falerts-and-decisioning%2Foas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Fproduct-configuration%2Fproduct-configuration-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2F3-d-secure%2F3-d-secure-1.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Faccount-updater%2Faccount-updater-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Ftreasury%2Fglobal-payments%2Fglobal-payments%2Fglobal-payments-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fliquidity-account-solutions%2Fbda-balances%2Faccounts-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Ffraud-solutions%2Fvalidation-services%2Fvalidation-services-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Fwallet-decryption%2Fwallet-decryption-oas.md

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/jp-morgan-chase-authentication-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jp-morgan-chase-authentication-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: 3-D Secure Authentication API
  description: Standalone authentication API for processing consumer payments
  version: 2.5.1
  contact:
    name: 3-D Secure API Support
    url: https://developer.payments.jpmorgan.com/contact/support
    email: ms.pit.team@jpmorgan.com
servers:
- url: https://api-ms.payments.jpmorgan.com/api/v2
  description: PRODUCTION - OAUTH
- url: https://api-ms-test.payments.jpmorgan.com/api/v2
  description: CLIENT TESTING - OAUTH
- url: https://api-mock.payments.jpmorgan.com/api/v2
  description: MOCK
security:
- BearerAuth: []
tags:
- name: Authentication
  description: Authentication
paths:
  /authentications:
    post:
      summary: Prepare a 3DS authentication
      operationId: V2SuthenticationPost
      tags:
      - Authentication
      description: Prepare a 3DS authentication
      parameters:
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          example: 10cc0270-7bed-11e9-a188-1763956dd7f6
          maxLength: 40
        description: Merchant identifier for the request. The value must be unique.
        examples:
          3DS Frictionless Preparation:
            value: 252f0171-9512-4f54-94e5-5c046dc55eab
          3DS Challenge Preparation:
            value: f9c75448-0764-4eee-b67f-d6e9d2fb167f
          3DS CB Challenge Preparation:
            value: 029b59c4-c266-477c-b8d2-882c22b664b7
      - name: merchant-id
        in: header
        required: true
        schema:
          type: string
          example: '991234567890'
          minLength: 8
          maxLength: 12
        description: Identifier for the merchant account
        examples:
          3DS Frictionless Preparation:
            value: 000017904371
          3DS Challenge Preparation:
            value: 000017904372
          3DS CB Challenge Preparation:
            value: 000017904373
      - name: platform-id
        in: header
        schema:
          type: string
        description: Identifies the platform used to facilitate the transaction request
      requestBody:
        description: Authentication Request
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/authenticationRequest'
            examples:
              3DS Frictionless Preparation:
                value:
                  authenticationPaymentMethodType:
                    card:
                      expiry:
                        month: 5
                        year: 2031
                      accountNumber: '5112345112345114'
                  amount: 25000
                  currency: EUR
                  authenticationAccount:
                    email: example@example.com
                    firstName: FirstName
                    lastName: LastName
                    middleName: MiddleName
                    phone:
                      countryCode: 1
                      phoneNumber: '8131112222'
                    billingAddress:
                      line1: 123 Main Street
                      line2: Apartment 3b
                      city: Tampa
                      state: FL
                      postalCode: '33602'
                      countryCode: USA
                      addressTypeCode: Doing Business As Address
                  shippingAddress:
                    line1: 123 Main Street
                    line2: Apartment 3b
                    city: Tampa
                    state: FL
                    postalCode: '33602'
                    countryCode: USA
                    addressTypeCode: Doing Business As Address
                  threeDSMethodMerchantNotificationUrl: https://returnurl.com
                  authenticationType: DEFAULT
              3DS Challenge Preparation:
                value:
                  authenticationPaymentMethodType:
                    card:
                      expiry:
                        month: 5
                        year: 2031
                      accountNumber: '4916994064252017'
                  amount: 25000
                  currency: EUR
                  authenticationAccount:
                    email: example@example.com
                    firstName: FirstName
                    lastName: LastName
                    middleName: MiddleName
                    phone:
                      countryCode: 1
                      phoneNumber: '8131112222'
                    billingAddress:
                      line1: 123 Main Street
                      line2: Apartment 3b
                      city: Tampa
                      state: FL
                      postalCode: '33602'
                      countryCode: USA
                      addressTypeCode: Doing Business As Address
                  shippingAddress:
                    line1: 123 Main Street
                    line2: Apartment 3b
                    city: Tampa
                    state: FL
                    postalCode: '33602'
                    countryCode: USA
                    addressTypeCode: Doing Business As Address
                  threeDSMethodMerchantNotificationUrl: https://returnurl.com
                  authenticationType: DEFAULT
              3DS CB Challenge Preparation:
                value:
                  authenticationPaymentMethodType:
                    card:
                      expiry:
                        month: 5
                        year: 2031
                      accountNumber: '4561953200000001'
                  amount: 25000
                  currency: EUR
                  authenticationAccount:
                    email: example@example.com
                    firstName: first_name
                    lastName: last_name
                    middleName: middle_name
                    phone:
                      countryCode: 1
                      phoneNumber: '8131112222'
                    billingAddress:
                      line1: 123 Main Street
                      line2: Apartment 3b
                      city: Tampa
                      state: FL
                      postalCode: '33602'
                      countryCode: USA
                      addressTypeCode: Doing Business As Address
                  shippingAddress:
                    line1: 123 Main Street
                    line2: Apartment 3b
                    city: Tampa
                    state: FL
                    postalCode: '33602'
                    countryCode: USA
                    addressTypeCode: Doing Business As Address
                  threeDSMethodMerchantNotificationUrl: https://returnurl.com
                  authenticationType: DEFAULT
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authenticationResponse'
        '400':
          description: Badly formatted request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '412':
          description: Precondition failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '500':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '504':
          description: Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
  /authentications/{authentication-id}:
    post:
      summary: Perform a 3DS authentication
      operationId: V2SuthenticationByIdPost
      tags:
      - Authentication
      description: Perform a 3DS authentication after completing preparation
      parameters:
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          example: 10cc0270-7bed-11e9-a188-1763956dd7f6
          maxLength: 40
        description: Merchant identifier for the request. The value must be unique.
        examples:
          3DS Frictionless Completion:
            value: 252f0171-9512-4f54-94e5-5c046dc55eab
          3DS Challenge Completion:
            value: f9c75448-0764-4eee-b67f-d6e9d2fb167f
          3DS CB Challenge Completion:
            value: f47ac10b-58cc-4372-a567-0e02b2c3d479
      - name: merchant-id
        in: header
        required: true
        schema:
          type: string
          example: '991234567890'
          minLength: 8
          maxLength: 12
        description: Identifier for the merchant account
        examples:
          3DS Frictionless Completion:
            value: 000017904371
          3DS Challenge Completion:
            value: 000017904372
          3DS CB Challenge Completion:
            value: 000017904373
      - name: authentication-id
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the card owner authentication provided by global authentication solution designed to make eCommerce transactions more secure and reduce fraud.
        examples:
          3DS Frictionless Completion:
            value: 78d6c37b-42a4-4fd8-bcfb-fa2e830b629e
          3DS Challenge Completion:
            value: 2de369a8-6288-4e6a-9414-9973a5be2032
          3DS CB Challenge Completion:
            value: f5b3d6ad-550c-48ca-b2bb-798e798cc0c9
      - name: platform-id
        in: header
        schema:
          type: string
        description: Identifies the platform used to facilitate the transaction request
      requestBody:
        description: Perform a 3DS authentication
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/authenticationByIdRequest'
            examples:
              3DS Frictionless Completion:
                value:
                  channelType: BROWSER
                  accountType: CREDIT
                  threeDSRequestorAuthenticationInfo:
                    threeDSAuthenticationTimestamp: '2023-08-21T15:12:12Z'
                    threeDSChallengeType: NO_CHALLENGE
                    authenticationPurpose: PAYMENT_TRANSACTION
                  threeDSPurchaseInfo:
                    purchaseDate: '2023-08-21T15:12:12Z'
                    threeDomainSecureTransactionType: GOODS_SERVICES
                  browserInfo:
                    browserAcceptHeader: application/json
                    deviceIPAddress: 192.168.1.11
                    browserLanguage: EN
                    browserColorDepth: '8'
                    browserScreenHeight: '480'
                    browserScreenWidth: '640'
                    deviceLocalTimeZone: '1'
                    browserUserAgent: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0
                    javaEnabled: true
                    javaScriptEnabled: true
                  threeDSChallengeMerchantNotificationUrl: https://returnurl.com
                  authenticationAccount:
                    email: example@example.com
                    firstName: FirstName
                    lastName: LastName
                    middleName: MiddleName
                    phone:
                      countryCode: 1
                      phoneNumber: '8131112222'
                    billingAddress:
                      line1: 123 Main Street
                      line2: Apartment 3b
                      city: Tampa
                      state: FL
                      postalCode: '33602'
                      countryCode: USA
                      addressTypeCode: Doing Business As Address
                  shippingAddress:
                    line1: 123 Main Street
                    line2: Apartment 3b
                    city: Tampa
                    state: FL
                    postalCode: '33602'
                    countryCode: USA
                    addressTypeCode: Doing Business As Address
                  authenticationSupportUrl: https://merchantsupporturl.com
                  messageType: PAYMENT_AUTHENTICATION
              3DS Challenge Completion:
                value:
                  channelType: BROWSER
                  accountType: CREDIT
                  threeDSRequestorAuthenticationInfo:
                    threeDSAuthenticationTimestamp: '2023-08-21T15:12:12Z'
                    threeDSChallengeType: CHALLENGE_REQUESTED
                    authenticationPurpose: PAYMENT_TRANSACTION
                  threeDSPurchaseInfo:
                    purchaseDate: '2023-08-21T15:12:12Z'
                    threeDomainSecureTransactionType: GOODS_SERVICES
                  browserInfo:
                    browserAcceptHeader: application/json
                    deviceIPAddress: 192.168.1.11
                    browserLanguage: EN
                    browserColorDepth: '8'
                    browserScreenHeight: '480'
                    browserScreenWidth: '640'
                    deviceLocalTimeZone: '1'
                    browserUserAgent: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0
                    javaEnabled: true
                    javaScriptEnabled: true
                  threeDSChallengeMerchantNotificationUrl: https://returnurl.com
                  authenticationAccount:
                    email: example@example.com
                    firstName: FirstName
                    lastName: LastName
                    middleName: MiddleName
                    phone:
                      countryCode: 1
                      phoneNumber: '8131112222'
                    billingAddress:
                      line1: 123 Main Street
                      line2: Apartment 3b
                      city: Tampa
                      state: FL
                      postalCode: '33602'
                      countryCode: USA
                      addressTypeCode: Doing Business As Address
                  shippingAddress:
                    line1: 123 Main Street
                    line2: Apartment 3b
                    city: Tampa
                    state: FL
                    postalCode: '33602'
                    countryCode: USA
                    addressTypeCode: Doing Business As Address
                  authenticationSupportUrl: https://merchantsupporturl.com
                  messageType: PAYMENT_AUTHENTICATION
              3DS CB Challenge Completion:
                value:
                  channelType: BROWSER
                  accountType: CREDIT
                  threeDSRequestorAuthenticationInfo:
                    threeDSAuthenticationTimestamp: '2022-10-31T17:07:14.91Z'
                    threeDSChallengeType: CHALLENGE_REQUESTED
                    authenticationPurpose: PAYMENT_TRANSACTION
                    authenticationUseCase: SINGLE_PAYMENT
                  threeDSPurchaseInfo:
                    purchaseDate: '2022-10-31T17:07:14.91Z'
                    threeDomainSecureTransactionType: GOODS_SERVICES
                    purchasedItemCount: 0
                  threeDSPurchaseRisk:
                    shipmentType: CARDHOLDER_ADDRESS
                    deliveryTimeframe: SAME_DAY
                    productAvailabilityCode: AVAILABLE
                    requestorEstimatedTransactionFraudRiskScore: '0001'
                  browserInfo:
                    browserAcceptHeader: application/json
                    deviceIPAddress: 192.168.1.11
                    browserLanguage: en
                    browserColorDepth: '8'
                    browserScreenHeight: '480'
                    browserScreenWidth: '640'
                    deviceLocalTimeZone: '1'
                    browserUserAgent: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0
                    javaEnabled: true
                    javaScriptEnabled: true
                  threeDSChallengeMerchantNotificationUrl: https://returnurl.com
                  authenticationAccount:
                    email: example@example.com
                    firstName: FirstName
                    lastName: LastName
                    middleName: MiddleName
                    phone:
                      countryCode: 1
                      phoneNumber: '8131112222'
                    billingAddress:
                      line1: 123 Main Street
                      line2: Apartment 3b
                      city: Tampa
                      state: FL
                      postalCode: '33602'
                      countryCode: USA
                      addressTypeCode: Doing Business As Address
                  shippingAddress:
                    line1: 123 Main Street
                    line2: Apartment 3b
                    city: Tampa
                    state: FL
                    postalCode: '33602'
                    countryCode: USA
                    addressTypeCode: Doing Business As Address
                  authenticationSupportUrl: https://merchantsupporturl.com
                  messageType: PAYMENT_AUTHENTICATION
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authenticationByIdResponse'
        '400':
          description: Badly formatted request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '412':
          description: Precondition failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '500':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '504':
          description: Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
    get:
      summary: Retrieve an authentication request
      operationId: V2SuthenticationByIdGet
      tags:
      - Authentication
      description: Retrieve an authentication request
      parameters:
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          example: 10cc0270-7bed-11e9-a188-1763956dd7f6
          maxLength: 40
        description: Merchant identifier for the request. The value must be unique.
        examples:
          3DS Frictionless Completion:
            value: 252f0171-9512-4f54-94e5-5c046dc55eab
          3DS Challenge Completion:
            value: 4b7632d6-4898-4c0a-b9f6-0d50c57aa124
          3DS CB Challenge Completion:
            value: a3d8e1b2-7f4c-4e9a-b6d1-8c5f2a9e0d73
          404 - Not Found:
            value: 7b14d406-7a99-48b5-a5d9-44a32f34b5de
      - name: merchant-id
        in: header
        required: true
        schema:
          type: string
          example: '991234567890'
          minLength: 8
          maxLength: 12
        description: Identifier for the merchant account
        examples:
          3DS Frictionless Completion:
            value: 000017904371
          3DS Challenge Completion:
            value: 000017904372
          3DS CB Challenge Completion:
            value: 000017904373
          404 - Not Found:
            value: 000017904100
      - name: authentication-id
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the card owner authentication provided by global authentication solution designed to make eCommerce transactions more secure and reduce fraud.
        examples:
          3DS Frictionless Completion:
            value: 78d6c37b-42a4-4fd8-bcfb-fa2e830b629e
          3DS Challenge Completion:
            value: 2de369a8-6288-4e6a-9414-9973a5be2032
          3DS CB Challenge Completion:
            value: f5b3d6ad-550c-48ca-b2bb-798e798cc0c9
          404 - Not Found:
            value: not-found
      - name: platform-id
        in: header
        schema:
          type: string
        description: Identifies the platform used to facilitate the transaction request
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authenticationByIdResponse'
        '400':
          description: Badly formatted request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '412':
          description: Precondition failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '500':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '504':
          description: Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
components:
  schemas:
    middleName:
      description: Given name between first name and last name/surname.
      type: string
      pattern: '[\p{L}\p{P}0-9''. ]*'
      minLength: 1
      maxLength: 70
      writeOnly: true
    authenticationMethod:
      description: Information about how the 3DS Requestor previously  authenticated the cardholder.
      type: string
      enum:
      - FRICTIONLESS
      - CHALLENGED
      - AVS_VERIFIED
      - OTHER
    phone:
      description: Phone number in ITU-T E.164 format. Country code and phone number (subscriber number) are mandatory values
      type: object
      writeOnly: true
      required:
      - phoneNumber
      properties:
        countryCode:
          description: Telephone country code
          type: integer
          minimum: 1
          maximum: 999
          example: 1
        phoneNumber:
          description: Phone number
          type: string
          maxLength: 12
          writeOnly: true
    purchasedItemCount:
      description: The number of items in the sale for the payment processing request.
      type: integer
      format: int32
      minimum: 0
      maximum: 99
    threeDomainSecureExemption:
      description: Three Domain Secure Closure
      type: object
      properties:
        authenticationExemptionReason:
          description: EEA/UK Supported SCA exemptions
          type: string
          enum:
          - LOW_VALUE_PAYMENT
          - TRANSACTION_RISK_ANALYSIS
          - NOT_EXEMPTED
          - NOT_ENTITLED
          - MERCHANT_INITIATED_TRANSACTION
          - RECURRING_PAYMENT
          - ONE_LEG_OUT
        authenticationStatusReasonText:
          $ref: '#/components/schemas/authenticationStatusReasonText'
        updateTimestamp:
          $ref: '#/components/schemas/updateTimestamp'
    threeDSRequestorPriorAuthenticationInfo:
      description: Contains information about how the 3DS Requestor authenticated the cardholder as part of a previous 3DS transaction.
      type: object
      properties:
        priorAcsTransactionId:
          description: ACS Transaction ID for a prior authenticated transaction
          type: string
        authenticationMethod:
          $ref: '#/components/schemas/authenticationMethod'
        authenticationTimestamp:
          description: Designates the hour, minute and second of the prior authentication.
          type: string
          format: date-time
    threeDSMessageExtension:
      description: Contains Data necessary to support requirements not otherwise defined in the 3D Secure message are carried in a Message Extension. This field is limited to 81.920 characters and it is used in the Authentication Request.
      type: object
      properties:
        messageExtensionId:
          description: A unique identifier for the additional message necessary to support requirements not otherwise defined in the 3D Secure message.
          type: string
          maxLength: 64
        messageExtensionName:
          description: The label for additional message necessary to support requirements not otherwise defined in the 3D Secure message.
          type: string
          maxLength: 64
        messageExtensionCriticality:
          description: Indicate if the additional message is critical for the cardholder authentication process by the vendor. The additional message necessary to support requirements not otherwise defined in the 3D Secure message.
          type: boolean
        messageExtensionData:
          description: The additional textual data carried in the extension to support requirements not otherwise defined in the 3D Secure message.
          type: string
          maxLength: 8059
    paymentToken:
      description: Token Information for the payment transaction
      type: object
      properties:
        tokenProvider:
          $ref: '#/components/schemas/tokenProvider'
        tokenNumber:
          $ref: '#/components/schemas/tokenNumber'
        responseStatus:
          $ref: '#/components/schemas/responseStatus'
        tokenServiceResponseMessage:
          $ref: '#/components/schemas/tokenServiceResponseMessage'
        tokenServiceResponseCode:
          $ref: '#/components/schemas/tokenServiceResponseCode'
    issuerAssignedAuthenticationFraudScore:
      description: Assigned by the card issuer this specifies the likelihood that an authorization will be fraudulent. The scale ranges from 0 to 99. The higher the score, the more likely the authorization will be fraudulent.
      type: string
    paymentMethodId:
      description: Identifies a unique occurrence of the type of payment accepted by a level of the hierarchy of the merchant acquiring account.
      type: string
    tokenNumber:
      description: The token number is a secure surrogate value generated for an account number in a payment transaction. The token is substituted for the card number or primary account number (PAN), Demand Deposit Account (DDA) Number or other payment account and is used to process and identify transactions originating from that account.
      type: string
      readOnly: true
    responseStatus:
      description: Indicates whether API request resulted in success, error, or denial.
      type: string
      enum:
      - SUCCESS
      - DENIED
      - ERROR
    tokenServiceResponseMessage:
      description: Long explanation of response Message received from token service
      type: string
      readOnly: true
    authenticationResponse:
      description: Authentication Response Information
      type: object
      properties:
        requestId:
          $ref: '#/components/schemas/requestId'
        authenticationId:
          $ref: '#/components/schemas/authenticationId'
        authenticationPaymentMethodType:
          $ref: '#/components/schemas/authenticationPaymentMethodType'
        responseCode:
          $ref: '#/components/schemas/responseCode'
        responseStatus:
          $ref: '#/components/schemas/responseStatus'
        responseMessage:
          $ref: '#/components/schemas/responseMessage'
        authenticationResult:
          $ref: '#/components/schemas/authenticationResult'
        threeDSMethodMerchantNotificationUrl:
          description: A reference to a web resource on the internet specifying its location on a computer network and a mechanism for retrieving. In this context, this is the notification URL from Three Domain Secure to merchant after initial authentication request is complete.
          type: string
        authenticationType:
          $ref: '#/components/schemas/authenticationType'
        threeDSSchemeId:
          $ref: '#/components/schemas/threeDSSchemeId'
        information:
          $ref: '#/components/schemas/information'
        softMerchant:
          $ref: '#/components/schemas/softMerchant'
        merchantCategoryCode:
          $ref: '#/components/schemas/merchantCategoryCode'
    authenticationValueCalculationMethod:
      description: Identifies the calculation method used by the issuer to generate the electronic commerce cryptogram for cardholder authentication.
      type: string
      enum:
      - '0'
      - '1'
      - '2'
      - '3'
      - A
    message:
      description: Long informative message about error
      type: string
    entity:
      description: The moniker given to the module or program where the error generated.
      type: string
    threeDSChallengeMerchantNotificationUrl:
      description: A reference to a web resource on the internet specifying its location on a computer network and a mechanism for retrieving. In this context, this is the notification URL from Three Domain Secure to merchant after challenge is complete.
      type: string
    lastName:
      description: Last name or surname
      type: string
      pattern: '[\p{L}\p{P}0-9''. ]*'
      minLength: 1
      maxLength: 70
      writeOnly: true
    accountHolderReferenceId:
      description: Merchant defined identifier for a consumer
      type: string
      minLength: 0
      maxLength: 25
      example: AB12345678
      writeOnly: true
    cvv:
      description: Card verification value (CVV/CV2)
      type: string
      pattern: ^[A-Za-z0-9]{3,6}$
      minLength: 3
      maxLength: 6
      writeOnly: true
    threeDomainSecureCompletion:
      description: Three Domain Secure Closure
      type: object
      properties:
        authenticationStatusReasonText:
          $ref: '#/components/schemas/authenticationStatusReasonText'
        threeDSTransactionStatus:
          $ref: '#/components/schemas/threeDSTransactionStatus'
        threeDSTransactionStatusReasonText:
          description: The textual description of detailed rationale for authentication success or failure of the Three Domain Secure (3-D Secure or 3DS) Transaction Status.
          type: string
        updateTimestamp:
          $ref: '#/components/schemas/updateTimestamp'
        threeDSDirectoryServerTransactionId:
          $ref: '#/components/schemas/threeDSDirectoryServerTransactionId'
        threeDSVersion:
          description: Codifies the version of the Three Domain Secure (3-D Secure or 3DS) software that is used by the merchant. 3DS is a protocol designed to be an additional multi-factor security layer and is performed for online debit and credit card authorization requests. The acquirer domain initiates the transaction for 3DS authentication. The interoperability domain sends a message to the corresponding issuing bank based on the Bank Identification Number (BIN) range. The issuing bank domain authenticates the card user.
          type: string
        authenticationValue:
          $ref: '#/c

# --- truncated at 32 KB (75 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jp-morgan-chase/refs/heads/main/openapi/jp-morgan-chase-authentication-api-openapi.yml