Verifone Checkout API

Create, retrieve, update, and manage checkout sessions. A checkout session generates a hosted payment page URL that the customer visits to complete payment.

OpenAPI Specification

verifone-checkout-api-openapi.yml Raw ↑
openapi: 3.0.1
info:
  title: 3D Secure 3DS Authentication Checkout 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: Checkout
  description: Create, retrieve, update, and manage checkout sessions. A checkout session generates a hosted payment page URL that the customer visits to complete payment.
paths:
  /v2/checkout:
    post:
      tags:
      - Checkout
      summary: Create a checkout
      operationId: postV2Checkout
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/CreateCheckoutRequest'
              - $ref: '#/components/schemas/CardCaptureRequest'
      responses:
        '200':
          description: Successful
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/CreateCheckoutResponse'
                - type: object
                  properties:
                    details:
                      type: object
                      description: The details object displays any errors or warnings that occur during the request.
                      properties:
                        errors:
                          type: array
                          items:
                            type: object
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '504':
          description: Gateway Time-out
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    VippsPaymentConfigRequest:
      required:
      - payment_contract_id
      type: object
      properties:
        payment_contract_id:
          type: string
          description: This parameter can be found in the portal on the Payment Provider Contract attached to your organization or given to you by a Verifone employee. It is used to retrieve MID and other merchant configurations necessary for a card payment.
        dynamic_descriptor:
          maxLength: 25
          type: string
          description: Value is displayed as short text on the bank statement of the cardholder
        capture_now:
          type: boolean
          description: 'True - transaction will be sent as authCapture and automatically captured. <br /> False - transaction will be sent as auth and only authorized. NOT CAPTURED. <br /> If you don''t have any value in the capture_now parameter, at the moment of the call the value will be set as TRUE. '
          default: true
        is_app:
          type: boolean
          description: Flag to identify the transaction originated from APP or Browser
          default: false
        app_phone_number:
          maxLength: 18
          pattern: ^[0-9-\s\-+().-]+$
          type: string
          description: Indicates the phone number registered with Vipps Mobile APP.
        card:
          $ref: '#/components/schemas/VippsCardConfigRequest'
      description: Vipps payment configuration
    LineItem:
      required:
      - name
      - total_amount
      type: object
      properties:
        image_url:
          maxLength: 2000
          type: string
          description: Image URL for the line item
        item_url:
          maxLength: 2000
          type: string
          description: Item URL for the line item
        name:
          maxLength: 255
          type: string
          description: Descriptive name of the order line item
        quantity:
          type: integer
          default: 1
          description: Quantity of the order line item
        unit_price:
          type: number
          description: Unit Price
        unit_price_tax:
          type: number
          description: Unit Price Tax
        tax_rate:
          type: number
          description: Additional details specific to this type of event
        total_tax_amount:
          type: number
          description: Total tax amount
        total_amount:
          type: number
          description: Total Amount
        sku:
          maxLength: 127
          type: string
          description: The stock keeping unit (SKU) for the item.
        description:
          maxLength: 127
          type: string
          description: The detailed item description.
        category:
          type: string
          description: 'The item category type. <br />  The possible values are: <br />  * DIGITAL_GOODS - Goods that are stored, delivered, and used in their electronic format. <br />  * PHYSICAL_GOODS - A tangible item that can be shipped with proof of delivery.'
          enum:
          - DIGITAL_GOODS
          - PHYSICAL_GOODS
    GooglePayCardConfigRequest:
      required:
      - payment_contract_id
      - sca_compliance_level
      - threed_secure
      type: object
      properties:
        sca_compliance_level:
          type: string
          description: "Strong Customer Authentication (SCA) compliance level, possible values </br>\n     * NONE: No SCA required. </br>\n     * WALLET: based on the assurance details, if those are false, Google Pay will indicate the PSP to trigger 3DS which in this case will be required. \n      Details [here](https://developers.google.com/pay/api/web/reference/response-objects#assurance-details-specifications)</br>\n     * FORCE_3DS: SCA will be triggered. Regarding the liability shift, please check\n      [this page](https://developers.googleblog.com/en/google-pay-enabling-liability-shift-for-eligible-visa-device-token-transactions-globally/)"
          enum:
          - NONE
          - WALLET
          - FORCE_3DS
        threed_secure:
          $ref: '#/components/schemas/ThreeDSData'
        authorization_type:
          type: string
          description: 'Default: "FINAL_AUTH" <br /> Other Possible Values: "PRE_AUTH" <br /> Text: PRE_AUTH is used when a merchant wants to ensure shopper''s funds availability at a later time. <br /> Attention: If you are using PRE_AUTH function make sure capture_now is set as FALSE. Otherwise the PRE_AUTH will not work. <br />'
          default: FINAL_AUTH
        shopper_interaction:
          $ref: '#/components/schemas/shopper_interaction'
        payment_contract_id:
          type: string
          description: This parameter can be found in the portal on the Payment Provider Contract attached to your organization or given to you by a Verifone employee. It is used to retrieve MID and other merchant configurations necessary for a card payment.
        token_preference:
          $ref: '#/x-alt-definitions/token_preference'
    CardMode3DS:
      allOf:
      - $ref: '#/components/schemas/basic_card'
      - type: object
        required:
        - threed_secure
        properties:
          threed_secure:
            $ref: '#/components/schemas/threed_secure'
          shopper_interaction:
            $ref: '#/components/schemas/shopper_interaction'
    I18nConfiguration:
      type: object
      properties:
        default_language:
          type: string
          description: Default language is used for displaying the page. Any customer language choice would override this option
          default: en
        fallback_language:
          type: string
          description: Fallback language is used when DEFAULT_LANGUAGE is invalid. Any customer language choice would override this option
          default: en
        show_language_options:
          type: boolean
          description: Indicates whether a language selection option should be shown to the customer on the Checkout page or not
          default: true
      description: Language preferences for the checkout page. Read <a target="_blank" href="/online-payments/checkout/localization">Localisation</a> for details.
    KlarnaPaymentConfig:
      type: object
      properties:
        capture_now:
          type: boolean
          description: 'True - transaction will be sent as authCapture and automatically captured. <br /> False - transaction will be sent as auth and only authorized. NOT CAPTURED. <br /> If you don''t have any value in the capture_now parameter, at the moment of the call the value will be set as TRUE. '
          default: true
      description: Klarna payment configuration
    shopper_interaction:
      type: string
      description: Used to indicate the channel used by to send they checkout link <br /> * ECOMMERCE <br /> * MAIL - value is used only in Virtual terminal transactions and cannot be used in createCheckout API call <br /> * TELEPHONE - value is used only in Virtual terminal transactions and cannot be used in createCheckout API call <br />
      default: ECOMMERCE
      enum:
      - ECOMMERCE
      - MAIL
      - TELEPHONE
    ApplePayCardConfig:
      required:
      - payment_contract_id
      - sca_compliance_level
      - threed_secure
      type: object
      properties:
        sca_compliance_level:
          type: string
          default: NONE
          description: "Strong Customer Authentication (SCA) compliance level, possible values </br>\n     * NONE: No SCA required. </br>\n     *<b>Deprecated</b> WALLET: Apple Pay will indicate the PSP to trigger 3DS which in this case will be required.\n      Details [here](https://developers.google.com/pay/api/web/reference/response-objects#assurance-details-specifications)</br>\n     *<b>Deprecated</b> FORCE_3DS: SCA will be triggered. Regarding the liability shift, please check\n      [this page](https://developers.googleblog.com/en/google-pay-enabling-liability-shift-for-eligible-visa-device-token-transactions-globally/)</br></br>\n      *<b>Note: </b> Apple Pay is SCA compliant by design and 3DS check is not a mandatory function for processing transactions with this wallet. As a result, the previously supported WALLET and FORCE_3DS parameters are no longer relevant for Apple Pay transactions and have been deprecated.\n      Supports only NONE. Any other values (WALLET or FORCE_3DS) are sanitized and ignored."
          enum:
          - NONE
          - WALLET
          - FORCE_3DS
        threed_secure:
          deprecated: true
          description: Used for <a target="_blank" href="https://docs.verifone.com/online-payments/checkout/accepting-payments/3d-secure-payments">3D-Secure payments</a>
          type: object
        authorization_type:
          type: string
          description: 'Default: "FINAL_AUTH" <br /> Other Possible Values: "PRE_AUTH" <br /> Text: PRE_AUTH is used when a merchant wants to ensure shopper''s funds availability at a later time. <br /> Attention: If you are using PRE_AUTH function make sure capture_now is set as FALSE. Otherwise the PRE_AUTH will not work. <br />'
          default: FINAL_AUTH
        shopper_interaction:
          $ref: '#/components/schemas/shopper_interaction'
        payment_contract_id:
          type: string
          description: This parameter can be found in the portal on the Payment Provider Contract attached to your organization or given to you by a Verifone employee. It is used to retrieve MID and other merchant configurations necessary for a card payment.
        token_preference:
          $ref: '#/x-alt-definitions/token_preference'
    stored_credential:
      required:
      - processing_model_details
      - stored_credential_type
      type: object
      description: Used for transactions with <a target="_blank" href="https://docs.verifone.com/online-payments/stored-credentials">Stored Credentials</a>
      properties:
        stored_credential_type:
          type: string
          description: must be one of  SIGNUP CHARGE
          enum:
          - SIGNUP
          - CHARGE
        first_payment:
          type: boolean
          description: 'Set to true if this signup request also is the first payment.

            Most relevant for signup using a minor amount, to indicate if that minor amount is just a signup account verification amount or an actual first payment amount as well.

            Default on this endpoint is that zero amount is not a payment, but any amount provided is a payment.

            Use this indicator to explicitly tell the intention.

            '
        consent_text:
          maxLength: 2048
          pattern: '[\p{L}\p{N}.,_\-+\s\\{\\}]'
          type: string
          description: Optional merchant provided text to display to the shopper as a checkbox, requiring their consent for the given sign up, detailing the terms at which the shopper agrees to be charged in the future. If not provided, there will be no consent checkbox.
        consent_text_dynamic_values:
          $ref: '#/components/schemas/consentTextDynamicValues'
        processing_model_details:
          $ref: '#/components/schemas/processing_model_details'
        reference:
          type: string
        scheme_reference:
          type: string
    SMSNotification:
      type: object
      properties:
        phone_number:
          maxLength: 15
          pattern: ^[0-9-\s\-+().-]+$
          type: string
          description: Phone number to which notification will be sent. This field can only be used for Pay By Link feature.
    CreateCheckoutRequest:
      title: StandardRequest
      required:
      - amount
      - configurations
      - currency_code
      - entity_id
      type: object
      properties:
        entity_id:
          type: string
          description: Entity Id can be located on the organization level as Organization ID (Administration > Organizations > [Organization] > Organisation ID value)
        currency_code:
          type: string
          description: Currency code
          enum:
          - AED
          - AFN
          - ALL
          - AMD
          - ANG
          - AOA
          - ARS
          - AUD
          - AWG
          - AZN
          - BAM
          - BBD
          - BDT
          - BGN
          - BHD
          - BIF
          - BMD
          - BND
          - BOB
          - BOV
          - BRL
          - BSD
          - BTN
          - BWP
          - BYR
          - BZD
          - CAD
          - CDF
          - CHE
          - CHF
          - CHW
          - CLF
          - CLP
          - CNY
          - COP
          - COU
          - CRC
          - CUC
          - CVE
          - CZK
          - DJF
          - DKK
          - DOP
          - DZD
          - EGP
          - ERN
          - ETB
          - EUR
          - FJD
          - FKP
          - GBP
          - GEL
          - GHS
          - GIP
          - GMD
          - GNF
          - GTQ
          - GYD
          - HKD
          - HNL
          - HRK
          - HTG
          - HUF
          - IDR
          - ILS
          - INR
          - IQD
          - IRR
          - ISK
          - JMD
          - JOD
          - JPY
          - KES
          - KGS
          - KHR
          - KMF
          - KPW
          - KRW
          - KWD
          - KYD
          - KZT
          - LAK
          - LBP
          - LKR
          - LRD
          - LSL
          - LTL
          - LVL
          - LYD
          - MAD
          - MDL
          - MGA
          - MKD
          - MMK
          - MNT
          - MOP
          - MRO
          - MUR
          - MVR
          - MWK
          - MXN
          - MXV
          - MYR
          - MZN
          - NAD
          - NGN
          - NIO
          - NOK
          - NPR
          - NZD
          - OMR
          - PAB
          - PEN
          - PGK
          - PHP
          - PKR
          - PLN
          - PYG
          - QAR
          - RON
          - RSD
          - RUB
          - RWF
          - SAR
          - SBD
          - SCR
          - SDG
          - SEK
          - SGD
          - SHP
          - SLL
          - SOS
          - SRD
          - SSP
          - STD
          - SVC
          - SYP
          - SZL
          - THB
          - TJS
          - TMT
          - TND
          - TOP
          - TRY
          - TTD
          - TWD
          - TZS
          - UAH
          - UGX
          - USD
          - USN
          - USS
          - UYI
          - UYU
          - UZS
          - VEF
          - VND
          - VUV
          - WST
          - XAF
          - XAG
          - XAU
          - XBA
          - XBB
          - XBC
          - XBD
          - XCD
          - XDR
          - XOF
          - XPD
          - XPF
          - XPT
          - XTS
          - XXX
          - YER
          - ZAR
          - ZMK
          - ZMW
          - BTC
        amount:
          maximum: 9007199254740991
          minimum: 0
          type: integer
          description: Transaction amount - Transaction with zero amount value will be considered as account verification  and by default implicitly capture will be set to false for AV transaction
        customer:
          type: string
          description: <p>ID of a Customer created via the <a target='_blank' href="https://docs.verifone.com/api-reference/open-api-references/customer">Customer API</a>. A customer object can be created and attached to a Checkout. The customer object can store relevant customer details. Some of these details might be required, depending on the payment method and/or authentication mechanisms (e.g., 3DS) used in the Checkout</p>
        configurations:
          $ref: '#/components/schemas/PaymentConfigurations'
        expiry_time:
          type: string
          description: Expiry time of the Checkout page. Defaults to 15 min from creation time. If a user tries to visit or use an expired Checkout, an error will be shown. Maximum value is 30 days.
          format: date
        merchant_reference:
          maxLength: 50
          pattern: ^[^=+\-@].*
          type: string
          description: Reference provided by Merchant to identify the Checkout and the transaction initiated from it
        return_url:
          type: string
          description: URL belonging to the Merchant website, where the Customer would be redirected after the Checkout has been completed. If this parameter is used, the customer will be redirected after spending 10 seconds on the payment confirmation page provided by Verifone in case of HPP and PAYMENT LINK transactions. For IFRAME transaction the redirect is performed right after the checkout page without passing through the payment confirmation page.   <br /> <b>Note 1:</b> The return_url accepts only securely connected URLs i.e., via https protocol. <br /> <b>Note 2:</b> The time after which redirection happens can be customized using redirect_method.
        shop_url:
          type: string
          description: URL belonging to the Merchant website, where the Customer would be redirected in case of cancelled Checkout. <br /> <b>Note:</b> Only applicable to HPP or PAYMENT_LINK interaction type.
        i18n:
          $ref: '#/components/schemas/I18nConfiguration'
        interaction_type:
          type: string
          description: 'Type of checkout. Allows for distinguishing payments accepted via different channels. <br /> Possible Values: <br />  * HPP - For payments done as Hosted Payments Page integration.<br />  * IFRAME - For payments done as an Iframe integration.<br /> * PAYMENT_LINK - For payments done through the Payment link feature in the merchant portal.'
          default: HPP
          enum:
          - HPP
          - IFRAME
          - PAYMENT_LINK
        notification_methods:
          $ref: '#/components/schemas/notification_methods'
        display_line_items:
          type: boolean
          description: Indicates whether line items should be displayed on the page. Defaults to true
          default: true
        line_items:
          description: "List of shopping cart items to be displayed on the page.\n \nIMPORTANT: Please read the <a target=\"_blank\" href=\"https://docs.verifone.com/online-payments/checkout/line-items\">Line items</a> documentation for required parameters depending on your payment methods."
          title: Ecommerce basket line items
          type: array
          items:
            $ref: '#/components/schemas/LineItem'
        theme_id:
          type: string
          description: Parameter that was created within the create theme API call that applies the customizations upon the checkout interface. Read <a target="_blank" href="https://docs.verifone.com/online-payments/checkout/theming">Theming</a> for details.
        receipt_type:
          type: string
          description: 'Can be used to send different invoices to the customer. <br /> Possible Values: <br />  * INVOICE <br />  * FULL_RECEIPT <br />  * SIMPLE_RECEIPT <br />  * INVOICE_RECEIPT <br />'
          enum:
          - INVOICE
          - FULL_RECEIPT
          - SIMPLE_RECEIPT
          - INVOICE_RECEIPT
        sales_description:
          maxLength: 200
          type: string
          description: General description of the document
        sales_channel:
          type: string
          description: 'Channel used to process transactions. <br /> Possible Values: <br />  * ECOMMERCE <br/>  * MOTO <br /> For sales_channel MOTO, no card.shopper_interaction is needed to be sent for this option.'
          enum:
          - ECOMMERCE
          - MOTO
        customer_details:
          $ref: '#/components/schemas/customer_details'
        purchase_order_number:
          type: string
          description: Reference number that facilitates card acceptor/corporation communication and record keeping.
        tax_indicator:
          type: string
          description: Flag that indicates whether an order is taxable.
          enum:
          - TAX_NOT_PROVIDED
          - TAX_PROVIDED
          - NON_TAXABLE
        tax_amount:
          type: number
          description: Total tax amount for all the items offers.
        promo_code:
          type: string
          description: A code defined by the merchant that affects the calculation of the total amount.
        invoice_number:
          maxLength: 127
          type: string
          description: The invoice number to track this payment. <br /> <b>Note:</b> Valid for card payments only.
        transaction_type:
          type: string
          description: this field is only applicable for virtual terminal. Supported value for this field is UNMATCHED_REFUND.
        allow_customer_inputs:
          type: boolean
          default: false
          description: Allows customer to enter or update their billing/shipping information on the hosted payments page.Only applicable for HPP and PAYMENT_LINK interaction types.
        checkout_template_id:
          type: string
          description: "Checkout template UUID  \n**WARNING**: Only active template allowed.\n"
        redirect_method:
          type: string
          enum:
          - DEFAULT
          - HEADER_REDIRECT
          description: "Configures the redirect behaviour for return_url on successful payment when interaction type is either HPP or PAYMENT_LINK </br>\n     * DEFAULT: The customer will be redirected after spending 10 seconds on the payment confirmation page provided by Verifone. </br>\n     * HEADER_REDIRECT: The payment confirmation page is skipped and the customer is redirected immediately. <br /> \n    <b>Note:</b> This parameter does not have any effect when interaction type is IFRAME. "
        handle_order_confirmation:
          type: boolean
          description: 'This change will remove the payment confirmation page from the user interface. Payment actions will now be managed through postMessage events.<br /> Checkout Events: <br /> * CHECKOUT_RENDERED: Indicates successful iFrame loading. <br /> * CHECKOUT_RENDERED_FAILED: Signals iFrame loading failure. <br /> * CARD_DETAILS_ENTERED: Triggered after the cardholder inputs card details. <br /> * CHECKOUT_FAILED: Occurs when the checkout process encounters an error. <br /> Payment Action listerer events: <br /> * CONTINUE: Initiates the payment process. <br /> **Note:** This parameter has no effect when the interaction type is HPP or PAYMENT_LINK.'
          default: false
        show_confirmation_page:
          type: boolean
          description: 'This change will remove the payment confirmation page from the user interface. Payment actions will now be managed through postMessage events.<br /> Checkout Events: <br /> * CARD_CAPTURE_SUCCESS: Indicates successful card capture. <br /> * CHECKOUT_COMPLETED: Signals successful completion of the checkout process. <br /> * CHECKOUT_FAILED: Occurs when the checkout process encounters an error. <br /> **Note:** This parameter has no effect when the interaction type is HPP or PAYMENT_LINK.'
          default: true
        promo_financing_details:
          $ref: '#/components/schemas/promo_financing_details'
    ErrorResponse:
      type: object
      properties:
        code:
          type: number
          description: A 3-digit code which uniquely identify an error.
        details:
          $ref: '#/components/schemas/details'
        message:
          maxLength: 2048
          type: string
          description: A description of the error.
        timestamp:
          type: string
          description: Error timestamp
          format: date-time
    VippsCardConfigRequest:
      required:
      - sca_compliance_level
      - threed_secure
      type: object
      properties:
        sca_compliance_level:
          type: string
          description: "Strong Customer Authentication (SCA) compliance level, possible values </br>\n     * NONE: No SCA required. </br>\n     * WALLET: Depend on the wallet SCA mechanism. For Google Pay this means that MasterCard will shift liability, Visa will not. </br>\n     * FORCE_3DS: Do an additional 3DS step regardless of whether the wallet indicates the token is SCA-compliant."
          enum:
          - NONE
          - WALLET
          - FORCE_3DS
        threed_secure:
          $ref: '#/components/schemas/ThreeDSData'
        authorization_type:
          type: string
          description: Card Authorization Type (PRE_AUTH, FINAL_AUTH).  When capture now is set to true pre-authorization transactions cannot be done.
          default: FINAL_AUTH
    swish_req:
      type: object
      properties:
        app_phone_number:
          maxLength: 18
          pattern: ^[0-9-\s\-+().-]+$
          type: string
          description: Indicates the phone number registered with Swish Mobile APP.
        shopper_interaction:
          type: string
          description: 'Used to indicate the channel used by to send they checkout link <br /> * ECOMMERCE <br /> * MCOMMERCE '
          default: ECOMMERCE
          enum:
          - ECOMMERCE
          - MCOMMERCE
      description: Swish payment configuration
    payment_contract_id:
      oneOf:
      - type: string
        description: This parameter can be found in the portal on the Payment Provider Contract attached to your organization or given to you by a Verifone employee. It is used to retrieve MID and other merchant configurations necessary for a card payment.
      - type: object
        $ref: '#/x-alt-definitions/paymentContractIdDef'
    processing_model_details:
      required:
      - processing_model
      type: object
      properties:
        processing_model:
          type: string
          description: <br />  * RECURRING - allows only for RECURRING subsequent charges to be done. <br />  * NONE - does not specify what is the type of subsequent charges. Only allows CREDENTIAL_ON_FILE and UNSCHEDULED_CREDENTIAL_ON_FILE charges. <br />  * If it is RECURRING for SIGNUP should be RECURRING FOR CHARGE TOO. <br />  * If it is NONE for SIGNUP should be CREDENTIAL_ON_FILE or UNSCHEDULED_CREDENTIAL_ON_FILE FOR CHARGE.
          enum:
          - RECURRING
          - NONE
        total_payment_number:
          maximum: 9007199254740991
          minimum: 0
          type: integer
          description: Total number of payments for the stored credential series. Usage applies to specific acquirers. Used only for processing_model=RECURRING
        total_payment_amount:
          maximum: 9007199254740991
          minimum: 0
          type: integer
          description: Total amount for all the payments in the stored credential series. Usage applies to specific acquirers. Used only for processing_model=RECURRING
        first_payment_amount:
          maximum: 9007199254740991
          minimum: 0
          type: integer
          description: Amount of first payment for the stored credential series. Usage applies to specific acquirers. Used only for processing_model=RECURRING
        payment_frequency:
          $ref: '#/components/schemas/payment_frequency'
        merchant_signup_code:
          type: string
          description: Merchant signup code for the stored credential series. Usage applies to specific acquirers. Used only for processing_model=NONE
    apple_pay:
      type: object
      description: Apple Pay payment configuration
      properties:
        dynamic_descriptor:
          maxLength: 25
          type: string
          description: Value is displayed as short text on the bank statement of the cardholder
        capture_now:
          type: boolean
          description: True - transaction will be sent as authCapture and automatically captured. <br /> False - transaction will be sent as auth and only authorized. NOT CAPTURED. <br /> If you don't have any value in the capture_now parameter, at the moment of the call the value will be set as TRUE.
          default: true
        account_validation:
          type: boolean
          description: 'Indicates whether the card transaction should be processed as Account Validation request instead. If set to true, the amount provided for the Checkout would be ignored and the transaction be processed with amount: 0'
          default: false
        card:
          $ref: '#/components/schemas/ApplePayCardConfig'
    PaymentConfigurations:
      type: object
      properties:
        card:
          $ref: '#/components/schemas/CardConfiguration'
        gpp2:
          $ref: '#/components/schemas/GPP2PaymentConfig'
        gift_card:
          $ref: '#/components/schemas/gift_card'
        paypal:
          $ref: '#/components/schemas/PaypalPaymentConfig'
        google_pay:
          $ref: '#/components/schemas/GooglePayPaymentConfig'
        apple_pay:
          $ref: '#/components/schemas/apple_pay'
        klarna:
          $ref: '#/components/schemas/KlarnaPaymentConfig'
        vipps:
          $ref: '#/components/schemas/VippsPaymentConfigRequest'
        swish:
          $ref: '#/components/schemas/swish_req'
        mobile_pay:
          $ref: '#/components/schemas/mobile_pay_req'
        bank:
          $ref: '#/components/schemas/bank'
        plcc:
          $ref: '#/components/schemas/plcc'
      description: Payment method configurations
    gift_card:
      type: object
      description: Gift Card payment configuration
      properties:
        capture_now:
          type: boolean
          description: True - transaction will be sent as authCapture and automatically captured. <br /> False - transaction will be sent as auth and only authorized. NOT CAPTURED. <b

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