Verifone Ecom Payments API

openapi: 3.2.0
info:
  title: 3D Secure 3DS Authentication Ecom Payments API
  version: 3.43.0
  description: Operations for listing and retrieving 3DS authentication records. Use these endpoints to query historical authentication results filtered by amount, currency, card, status, and more.
servers:
- url: https://emea.gsc.verifone.cloud/oidc/3ds-service
  description: EMEA Production
- url: https://us.gsc.verifone.cloud/oidc/3ds-service
  description: Americas Production
- url: https://nz.gsc.verifone.cloud/oidc/3ds-service
  description: New Zealand Production
- url: https://cst.test-gsc.vfims.com/oidc/3ds-service
  description: Global Sandbox
- url: https://uscst-gb.gsc.vficloud.net/oidc/3ds-service
  description: Americas Sandbox
security:
- BearerAuth: []
- BasicAuth: []
tags:
- name: Ecom Payments
paths:
  /api/v2/transactions/card:
    post:
      operationId: saleTransaction
      summary: Initiate a payment
      description: "Initiate a card payment or card verification request when amount is set to 0 (zero).\n\n <b>Transactions business models</b>\n\n| Business model | Transaction type | Shopper Interaction | Stored Credential Contract | Stored Credential Processing Model |\n| -------------- | ---------------- | ------------------- | ------------------ | -------------------------- |\n| Online purchase with shopper present | One-off online purchase without storing card payment details for future use.| `ECOMMERCE` | | |\n| Online purchase with shopper present | Online purchase where shopper agrees to store card details for future use. This can be a zero-value transaction account verification.| `ECOMMERCE` |  | `CREDENTIAL_ON_FILE` |\n| Online purchase with shopper present | Online purchase where shopper uses previously stored card payment details.| `ECOMMERCE` | `ONE_CLICK` | `CREDENTIAL_ON_FILE` |\n| Subscriptions | Initial transaction to sign up for a subscription.| `ECOMMERCE` |  | `RECURRING` |\n| Subscriptions | Subsequent subscription charge. | `ECOMMERCE` | `MERCHANT_INITIATED` | `RECURRING` |\n| Non-fixed in time contracts (such as auto account top-ups) | Initial transaction to sign up for the terms and conditions of later subsequent charges. | `ECOMMERCE` |  | `UNSCHEDULED_CREDENTIAL_ON_FILE` |\n| Non-fixed in time contracts (such as auto account top-ups) | Subsequent charges as described in the initial terms and conditions during the sign-up transaction. | `ECOMMERCE` | `MERCHANT_INITIATED` | `UNSCHEDULED_CREDENTIAL_ON_FILE` |"
      parameters:
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        schema:
          type: string
          description: A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/EncryptedCardPaymentRequest'
              - $ref: '#/components/schemas/TokenPaymentRequest'
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponseCard'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
      tags:
      - Ecom Payments
  /api/v2/transactions/wallet:
    post:
      operationId: walletTransaction
      summary: Initiate a wallet payment using Google Pay or Apple Pay
      description: "Initiate a card payment or card verification request when amount is set to 0 (zero).\n\n <b>Transactions business models</b>\n\n| Business model | Transaction type | Shopper Interaction | Stored Credential Contract | Token Preference or Reference | Stored Credential Request Type | Stored Credential Processing Model |\n| ------------------- | ---------------- | ------------------- | ------------------ | ------------------ | ---------------- | -------------------------- |\n| Online purchase with shopper present | One-off online purchase without storing card payment details for future use.| `ECOMMERCE` | | | | |\n| Online purchase with shopper present | Online purchase where shopper agrees to store card details for future use. This can be a zero-value transaction account verification.| `ECOMMERCE` |  | `REUSE` | `SIGNUP` | `NONE` |\n| Subscriptions | Initial transaction to sign up for a subscription.| `ECOMMERCE` |  | `REUSE` or `reuse_token` | `SIGNUP` | `RECURRING` |\n| Non-fixed in time contracts (such as auto account top-ups) | Initial transaction to sign up for the terms and conditions of later subsequent charges. | `ECOMMERCE` |  | `REUSE` | `SIGNUP` | `NONE` |\n<p><i>Note</i>: To initiate a transaction with reference to previously stored credentials ( `CHARGE` ) use ``/v2/transactions/card`` endpoint instead.</p>"
      parameters:
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        schema:
          type: string
          description: A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateWalletDto'
      responses:
        '201':
          description: Wallet Result
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/VerificationAdvice'
                - $ref: '#/components/schemas/EcomResponseCard'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
      tags:
      - Ecom Payments
  /api/v2/apple-pay/validation:
    post:
      operationId: validationUrl
      summary: Start payment session for Apple Pay wallet transactions
      description: Create a merchant payment session
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplePayMerchantValidationDto'
      responses:
        '201':
          description: The Apple Pay Validation Response.
          content:
            application/json:
              schema:
                type: object
                description: object (Apple Pay opaque session object)
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
      tags:
      - Ecom Payments
  /api/v2/transactions/vipps:
    post:
      tags:
      - Ecom Payments
      summary: Initiate a Vipps payment
      description: Initiate a Vipps payment.
      operationId: vippsTransaction
      parameters:
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        schema:
          type: string
          description: A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/vippsPaymentInitiationRequest'
      responses:
        '201':
          description: The Vipps Payment Initiation Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/vippsPaymentInitiationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
  /api/v2/transactions/mobilepay:
    post:
      tags:
      - Ecom Payments
      summary: Initiate a MobilePay payment
      description: Initiate a MobilePay payment.
      operationId: mobilePayTransaction
      parameters:
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        schema:
          type: string
          description: A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/mobilePayPaymentInitiationRequest'
      responses:
        '201':
          description: The MobilePay Payment Initiation Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mobilePayPaymentInitiationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
  /api/v2/transactions/klarna:
    post:
      tags:
      - Ecom Payments
      summary: Initiate a Klarna payment.
      description: Initiate a Klarna payment.
      operationId: klarnaInitTransaction
      parameters:
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        schema:
          type: string
          description: A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/klarnaPaymentInitiationRequest'
      responses:
        '201':
          description: Klarna Initiate Payment Result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/klarnaPaymentInitiationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
  /api/v2/transactions/swish:
    post:
      tags:
      - Ecom Payments
      summary: Initiate a Swish payment
      description: Initiate a Swish payment.
      operationId: swishTransaction
      parameters:
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        schema:
          type: string
          description: A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/swishPaymentInitiationRequest'
      responses:
        '201':
          description: The Swish Payment Initiation Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/swishPaymentInitiationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
  /api/v2/transactions/op-online-payment:
    post:
      tags:
      - Ecom Payments
      summary: Initiate a OP Online payment
      description: Initiate a OP Online payment.
      operationId: opOnlinePaymentTransaction
      parameters:
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        schema:
          type: string
          description: A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/opOnlinePaymentInitiationRequest'
      responses:
        '201':
          description: The OP Online Payment Initiation Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/opOnlinePaymentInitiationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
  /api/v2/get-op-banks:
    get:
      tags:
      - Ecom Payments
      summary: Get a list of Banks supported by OP Online Payment
      description: Get a list of Banks supported by OP Online Payment.
      operationId: getOpBanks
      responses:
        '201':
          description: The OP Online Payment list of Banks Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/opOnlinePaymentGetBanksResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
  /api/v2/transactions/affirm:
    post:
      tags:
      - Ecom Payments
      summary: Initiate a Affirm payment.
      description: With Affirm, you will never owe more than you agree to up front. Instead, you’ll always get a flexible, transparent, and convenient way to pay over time.
      operationId: affirmInitTransaction
      parameters:
      - name: x-vfi-api-idempotencykey
        required: true
        in: header
        schema:
          type: string
          description: A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/affirmPaymentInitiationRequest'
      responses:
        '201':
          description: The Affirm Initiation Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/affirmPaymentInitiationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestV2Docs'
        '401':
          description: Unauthorised Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedV2Docs'
        '403':
          description: Forbidden Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenV2Docs'
        '404':
          description: Not Found Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundV2Docs'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalErrorV2Docs'
components:
  schemas:
    affirmPaymentInitiationRequest:
      title: Affirm Initiate Payment Request
      required:
      - payment_provider_contract
      - amount
      - redirect_url
      - cancel_url
      - currency_code
      type: object
      properties:
        payment_provider_contract:
          type: string
          description: The identifier of payment provider contract you want to process the transaction request with.
          format: uuid-flexible
          title: paymentProviderContractId
        amount:
          type: integer
          description: Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.
        tax_amount:
          description: Tax Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details.
          type: integer
        redirect_url:
          type: string
          description: Checkout Redirect URL which will be used by Affirm on Payment Completion.
          maxLength: 2048
        cancel_url:
          type: string
          description: Checkout Cancel URL which will be used by Affirm on Payment Completion.
          maxLength: 2048
        capture_now:
          type: boolean
          description: Whether auto-capture or not. Setting the to 'false' will only authorize the transaction.
          default: true
        customer:
          title: Customer ID
          type: string
          description: The ID of a customer.
          format: uuid-flexible
        customer_ip:
          description: The IP Address of the customer where the transaction was initiated.
          maxLength: 15
          oneOf:
          - type: string
            format: ipv4
          - type: string
            format: ipv6
        customer_details:
          $ref: '#/components/schemas/CustomerDetailsDto'
        merchant_reference:
          type: string
          description: A reference specified by the merchant to identify the transaction.
          maxLength: 50
        line_items:
          type: array
          description: The array of items being purchased.
          items:
            $ref: '#/components/schemas/affirmLineItem'
        user_agent:
          type: string
          description: The full user agent string of the device the customer used to submit the transaction.
          maxLength: 256
        currency_code:
          $ref: '#/components/schemas/CurrencyCodeEnum'
        locale:
          $ref: '#/components/schemas/Locale'
        mode:
          type: string
          description: "Set to modal to enable the modal checkout flow (default uses redirect checkout flow). Possible values: authorization.\n * `MODAL:` Users go through the Affirm flow in a modal window while remaining on merchant site. Modal checkout with the help of affirm.js will enable client-side callbacks so that merchant can do post checkout confirmation procedures on merchant site.\n * `REDIRECT:` Users are redirected to Affirm site, where they authenticate and go through the checkout flow. Once they complete checkout, they're returned to the merchant site."
          enum:
          - MODAL
          - REDIRECT
          default: REDIRECT
    StoredCredential:
      type: object
      properties:
        reference:
          type: string
          description: Reference of a successfully processed initial COF transaction. Only used by subsequent COF transactions.
        stored_credential_type:
          type: string
        scheme_reference:
          type: string
          description: Scheme Reference Data received from issuer/acquirer.
        processing_model:
          type: string
          enum:
          - UNSCHEDULED_CREDENTIAL_ON_FILE
          - CREDENTIAL_ON_FILE
          - RECURRING
          - REAUTHORIZATION
          - NONE
          description: Processing model to use for COF transaction. Refer to the card integration guide for more information on the usage.
        details:
          deprecated: true
          type: string
          enum:
          - UNSCHEDULED_CREDENTIAL_ON_FILE
          - CREDENTIAL_ON_FILE
          - RECURRING
          description: Processing model to use for COF transaction. Refer to the card integration guide for more information on the usage.
    PaymentProductType:
      title: Payment Product Type
      type: string
      description: The payment product type corresponding to this transaction. Fees applied to the transaction, is based on the payment product
      enum:
      - Affirm
      - Amex
      - Crypto
      - Diners Club International
      - Discover
      - JCB
      - Klarna
      - Maestro
      - Mastercard
      - OP Online Payment
      - Swish
      - Unknown
      - Visa
      default: Unknown
    TokenDetailsRequestBody:
      title: Reuse Token Details
      type: object
      properties:
        expiry_month:
          maximum: 12
          type: integer
          description: A 2 digit value as shown on card. ISO8583 - DE 14.\n\nThis is included as an optional value to be used for some Third-Party reuse token types.
        expiry_year:
          maximum: 9999
          type: integer
          description: A 4 digit value as shown on card.\n\nThis is included as an optional value to be used for some Third-Party reuse token types.
      additionalProperties: false
      description: 'The details related to the token. For Third-Party Reuse tokens, these elements might be required as additional information together with the Reuse token itself.<br>

        **Note**: `reuse_token_details` is **mandatory** when `reuse_token_type` is set to `TAVE` or `CHASE`.

        '
    klarnaPaymentInitiationRequest:
      title: Klarna Initiate Payment Request
      required:
      - amount
      - currency_code
      - customer
      - entity_id
      - line_items
      - locale
      - purchase_country
      - redirect_url
      type: object
      properties:
        entity_id:
          type: string
          description: The identifier of merchant entity you want to process the transaction request with. Entity Id can be located on the organization level as Organization ID (Administration > Organizations > [Organization] > Organisation ID value)
          format: uuid-flexible
        amount:
          type: integer
          description: Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.
        tax_amount:
          type: integer
          description: Tax Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details.
        redirect_url:
          maxLength: 2048
          type: string
          description: Checkout Redirect URL which will be used by Klarna on Payment Completion.
        capture_now:
          type: boolean
          description: Whether auto-capture or not. Setting the value to 'false' will only authorize the transaction.
          default: true
        customer:
          type: string
          description: The ID of a customer.
          format: uuid-flexible
          title: Customer ID
        customer_ip:
          description: The IP Address of the customer where the transaction was initiated.
          maxLength: 15
          oneOf:
          - type: string
            format: ipv4
          - type: string
            format: ipv6
        dynamic_descriptor:
          maxLength: 25
          type: string
          description: A short [descriptor](https://en.wikipedia.org/wiki/Billing_descriptor) to be shown on bank statement of the customer. Please refer to the integration guide for the format requirements.
        merchant_reference:
          type: string
          description: A reference specified by the merchant to identify the transaction.
          maxLength: 50
        shipping_information:
          allOf:
          - $ref: '#/components/schemas/ShippingInformationDto'
        line_items:
          type: array
          description: The array of items being purchased.
          items:
            $ref: '#/components/schemas/LineItem'
        user_agent:
          type: string
          description: The full user agent string of the device the customer used to submit the transaction.
          maxLength: 256
        sales_description:
          type: string
          description: A reference used by the merchant to typically capture a description of the service provided. It could then be used by the merchant to help locate transactions. One could envision a situation where a merchant is trying to locate a transaction/ receipt but in speaking with the customer, the only (or at least a predominant) detail is what service was rendered
          maxLength: 200
        currency_code:
          type: string
          description: 'Three-letter ISO 4217 alphabetical currency code. e.g. EUR. Values correspond

            to [ISO 4217](https://wikipedia.org/wiki/ISO_4217).


            Please note that Klarna only supports EURO (EUR), Norwegian krone (NOK) , Swedish krona (SEK) and Danish krone (DKK).'
          enum:
          - EUR
          - NOK
          - SEK
          - DKK
        locale:
          $ref: '#/components/schemas/Locale'
    Language:
      title: Language
      maxLength: 11
      minLength: 2
      type: string
      description: The BCP-47 language tag. Composed of:<ul><li>The ISO-639 alpha-1 or ISO-639 alpha-2 language code</li><li>(Optional) The ISO-15924 script tag</li><li>The ISO-3166 alpha-2 country code</li></ul>
    CustomerDetailsDto:
      type: object
      title: Customer
      description: Customer information containing billing and shipping details.
      additionalProperties: false
      properties:
        title:
          type: string
          description: The prefix to the party name. This is sometimes referred to as a title, salutation or appellation.
          maxLength: 120
        first_name:
          type: string
          description: The first name of the Customer. This may be a proper name or some form of entity name or nickname.
          maxLength: 100
        middle_name:
          type: string
          description: The middle name of the Customer. This may be a proper name or some form of entity name or nickname.
          maxLength: 100
        last_name:
          type: string
          description: The last name or family name of the Customer.
          maxLength: 100
        company_name:
          type: string
          description: Where the Customer is an organisation or company this name should be used rather than the firstName lastName
          maxLength: 100
        p

# --- truncated at 32 KB (187 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/verifone/refs/heads/main/openapi/verifone-ecom-payments-api-openapi.yml