Verifone Payment Modifications API

openapi: 3.2.0
info:
  title: 3D Secure 3DS Authentication Payment Modifications 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: Payment Modifications
paths:
  /api/v2/transactions/{id}/void:
    post:
      operationId: voidAuthorization
      summary: Void authorization
      description: Void/Cancel an authorization hold on a payment. Check the documentation in order to verify what payment method allows for this payment modification.
      parameters:
      - name: id
        required: true
        in: path
        description: Original transaction id to cancel / void.
        schema:
          type: string
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/{id}/klarna_complete:
    post:
      tags:
      - Payment Modifications
      summary: Complete a Klarna payment
      description: A customer has completed a purchase and want to create the associated order in the system.
      operationId: klarnaPaymentTransaction
      parameters:
      - name: id
        in: path
        description: Original transaction id to complete transaction.
        required: true
        style: simple
        explode: false
        schema:
          title: Transaction ID
          type: string
          description: The ID of the transaction.
          format: uuid-flexible
      - name: x-vfi-api-idempotencyKey
        in: header
        required: false
        style: simple
        explode: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/klarnaPaymentCompletionRequest'
      responses:
        '200':
          description: The Klarna Complete Payment Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/klarnaPaymentCompletionResponse'
        '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/{id}/adjust:
    post:
      operationId: Adjust Payment
      summary: Adjust the preauth transaction amount
      description: Allows for the modification of the amount of a previously initiated preauthorization before it is captured.
      parameters:
      - name: id
        required: true
        in: path
        description: Original transaction id to adjust.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdjustDto'
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/{id}/capture:
    post:
      operationId: captureAuthorization
      summary: Capture authorization
      description: Capture an authorization hold on a payment. Check the documentation in order to verify what payment method allows for this payment modification.
      parameters:
      - name: id
        required: true
        in: path
        description: Original transaction id to capture.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CaptureCardTransactionDto'
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/{id}/refund:
    post:
      operationId: refundPayment
      summary: Refund payment
      description: Refund a payment that has previously been captured.
      parameters:
      - name: id
        required: true
        in: path
        description: Original transaction id to refund.
        schema:
          type: string
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        schema:
          type: string
          description: '`Note:` This value is required to process a refund for an Affirm payment.'
          format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefundCardTransactionDto'
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/refund:
    post:
      tags:
      - Payment Modifications
      description: Refund a cardholder with an amount not related to a previous transaction.
      summary: Unmatched refund
      operationId: unmatchedRefund
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/unmatchedRefundEncryptedCardRequest'
              - $ref: '#/components/schemas/unmatchedRefundTokenRequest'
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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'
  /api/v2/transactions/{id}/void_capture:
    post:
      operationId: voidCapture
      summary: Void capture
      description: Cancel a payment that has previously been captured. Void capture can only be done on the full amount of the transaction. Check the documentation to verify what [payment method](https://docs.verifone.com/online-payments/payment-actions) allows for this payment modification.
      parameters:
      - name: id
        required: true
        in: path
        description: Original transaction id to cancel / void the capture.
        schema:
          type: string
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/reverse:
    post:
      operationId: reverseTransaction
      summary: Reverse Transaction
      description: Allows for technical reversal
      parameters:
      - name: x-vfi-api-idempotencykey
        required: true
        in: header
        description: string(uuid)
        schema:
          type: string
      responses:
        '201':
          description: Technical Reversal Result
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/EcomReverseTransactionResponse'
                - $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/{id}/release:
    post:
      operationId: ReleasePreAuthorization
      summary: Release PreAuthorization
      description: Release the rest of preauthorisation which was not captured. This is a one time operation where all remaining funds are released. No further captures are allowed after that. Rest of amount to be released is automatically calculated internally.
      parameters:
      - name: id
        required: true
        in: path
        description: Original preauthorized transaction id to release
        schema:
          type: string
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        description: "string(uuid)\n\nExample: 63bbc548-d2de-4546-b106-880a5018461c\n  A value you specify that uniquely identifies this transaction. If you're unsure whether a particular transaction\n  succeeded, you can reattempt it with the same idempotency key without worrying about duplicating the\n  transaction."
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReleasePreauthDto'
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/{id}/extend:
    post:
      operationId: extendAuthorization
      summary: Extend preauthorization
      description: 'Extend the authorization period and confirm the availability of the funds of a previously initiated preauthorization.

        If supported by the card brand (like Visa) this operation will be handled as a Reauthorization request.'
      parameters:
      - name: id
        required: true
        in: path
        description: Original preauthorized transaction id to release
        schema:
          type: string
      - name: x-vfi-api-idempotencykey
        required: false
        in: header
        description: "string(uuid)\n\nExample: 63bbc548-d2de-4546-b106-880a5018461c\n  A value you specify that uniquely identifies this transaction. If you're unsure whether a particular transaction\n  succeeded, you can reattempt it with the same idempotency key without worrying about duplicating the\n  transaction."
        schema:
          type: string
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/{id}/issuer_instalment_selection:
    post:
      operationId: issuerInstalmentSelection
      summary: Issuer Instalment Selection
      description: Confirm selection of instalment option where multiple issuer instalment options proposed.
      parameters:
      - name: id
        required: true
        in: path
        description: Original transaction id to apply instalment selection to.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/issuerInstalmentSelectionRequest'
      responses:
        '201':
          description: Ecommerce Payment Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EcomResponse'
        '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:
      - Payment Modifications
  /api/v2/transactions/affirm_complete:
    post:
      tags:
      - Payment Modifications
      summary: Complete a Affirm payment
      description: A customer has completed a purchase and want to create the associated order in the system.
      operationId: affirmCompleteTransaction
      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/affirmPaymentCompletionRequest'
      responses:
        '201':
          description: The Affirm Initiation Response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/affirmPaymentCompletionResponse'
        '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:
    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`.

        '
    klarnaPaymentCompletionResponse_authorized_payment_method:
      type: object
      properties:
        days:
          type: integer
          description: Indicates whether the transaction would be automatically captured upon authorisation.
        no_of_installments:
          type: integer
          description: No of instalments
        payment_type:
          type: string
          description: Define the type of payment
          enum:
          - INVOICE
          - FIXED_AMOUNT
          - PIX
          - BASE_ACCOUNT
          - DEFERRED_INTEREST
          - DIRECT_DEBIT
          - DIRECT_BANK_TRANSFER
          - B2B_INVOICE
          - CARD
          - SLICE_IT_BY_CARD
          - PAY_LATER_BY_CARD
    unmatchedRefundTokenRequest:
      title: Using Reuse Token
      type: object
      allOf:
      - $ref: '#/components/schemas/unmatchedRefundBaseRequest'
      - properties:
          reuse_token:
            title: Verifone or Third-Party Reuse Token
            description: 'The Verifone or Third-Party issued reuse token used to represent the previously stored cardholder data.

              Required here if not referenced by providing the stored credential signup reference `stored_credential.reference` in a subsequent charge request.

              '
            type: string
            maxLength: 255
            minLength: 14
          reuse_token_type:
            title: Reuse Token Type
            description: 'The type of Reuse Token. This indicates if the reuse token is an internal Verifone type or an external Third-Party type.

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

              '
            type: string
            enum:
            - CHASE
            - INTERNAL
            - TAVE
            default: INTERNAL
          reuse_token_details:
            $ref: '#/components/schemas/TokenDetailsRequestBody'
          encrypted_svc_access_code:
            type: string
            title: Client encrypted SVC Access Code
            description: 'The SVC Access Code encrypted using the Verifone provided public key. This can be obtained using either Verifone.JS solution or Verifone Checkout in capture mode.


              The data to encrypt is a JSON with tag svcAccessCode.


              Additionally a tag called captureTime must be presenting indicating the time the cvv was captured in UTC in format RFC 3339, section 5.6. eg. 2019-08-24T14:15:22Z.'
          public_key_alias:
            type: string
            title: Public Key Alias
            description: The alias for the public key used to encrypt the card/identity card/cvv/svc access code.
          prefer_fund_transfer:
            type: boolean
            description: 'This flag is to be set to true when the merchant would like to use

              fund transfer options like OCT and the Payment provider contract

              is enabled for both fund transfers and unmatched refund.'
            default: false
          receipt_type:
            type: string
            description: Defines the type of receipt to be generated
            enum:
            - FULL_RECEIPT
            - INVOICE
            - INVOICE_RECEIPT
            - SIMPLE_RECEIPT
            - NONE
        required:
        - reuse_token
    RefusalReason:
      title: Refusal Reason
      type: string
      description: The reason a transaction has been refused within the payment ecosystem by the client/Verifone/acquirer. This needs to be set by the component that is refusing this transaction request.
      enum:
      - ACQUIRER_COMMS_FAILURE
      - ACQUIRER_REFUSED
      - CARD_BRAND_NOT_ACCEPTED
      - CARD_EXPIRED
      - CARD_NOT_ACCEPTED
      - CARD_NOT_VALID
      - CARD_PRODUCT_NOT_ACCEPTED
      - EXTERNAL_FLOW_FAILED
      - ORIGINAL_TRANSACTION_NOT_FOUND
      - INVALID_BIN
      - PARTIAL_AUTH_NOT_ALLOWED
      - RECEIPT_FAILURE
      - REFUND_NOT_ACCEPTED
      - THREEDSECURE_FAILED_ACS
      - THREEDSECURE_FAILED_AUTH
      - THREEDSECURE_FAILED_COMMS
      - UNAPPROVED_OPERATOR
      - UNKNOWN_REASON
    CaptureCardTransactionDto:
      type: object
      properties:
        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.
        purchase_order_number:
          title: Purchase Order Number
          description: 'The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

            '
          type: string
          maxLength: 17
        tax_indicator:
          title: Tax Indicator
          description: 'This field indicates the taxable status of the transaction (if any of the purchased items are taxable). This field is part of so-called Level 2 data. If the value `TAX_PROVIDED` is sent, `tax_amount` should also be provided

            '
          type: string
          enum:
          - TAX_PROVIDED
          - TAX_NOT_PROVIDED
          - NON_TAXABLE
          default: TAX_NOT_PROVIDED
        multiple_captures:
          allOf:
          - $ref: '#/components/schemas/MultipleCapturesDto'
            title: captureAuthorizationRequest_multiple_captures
            description: This field is mandatory in order to do multiple captures
        issuer_instalment:
          $ref: '#/components/schemas/instalment'
        line_items:
          type: array
          description: The array of items being refunded.
          items:
            $ref: '#/components/schemas/UnmatchedLineItem'
        detailed_amount:
          $ref: '#/components/schemas/DetailedAmount'
        receipt_type:
          type: string
          description: Defines the type of receipt to be generated
          enum:
          - FULL_RECEIPT
          - INVOICE
          - INVOICE_RECEIPT
          - SIMPLE_RECEIPT
          - NONE
      required:
      - amount
    CardBrand:
      type: string
      title: The Card Type
      description: "Represents a Card type or brand. It should correspond to a consistent name, the list of standard names is as follows:\n\nValue |  Description\n------|-------------\nAMEX|American Express\nCB|Carte Bancaires\nDINERS|Diners Club International\nDISCOVER|Diners Club Discover\nJCB|Japan Credit Bureau\nMAESTRO|Multi-national Debit (MasterCard)\nMASTERCARD|MasterCard\nVISA|Visa\nUPI|Union Pay International\nGIFT_CARD|Gift Card (Generic)\nPLCC|Private Label Credit Card\n**Other local schemes as applicable**. Enter a pre-defined name

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