Silverflow POS Charge Actions API

openapi: 3.2.0
info:
  title: Silverflow POS Charge Actions API
  version: 1.417.0
  contact:
    name: API Support
    email: support@silverflow.com
  license:
    name: Commercial
  description: 'Operations tagged POS Charge Actions across 2 of this provider''s published API definitions: silverflow-openapi.yml, silverflow-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://eu-west-1.api.silverflow.com/v1
  description: Production URL for Europe - Equivalent to https://api.silverflow.co/v1
- url: https://us-east-2.api.silverflow.com/v1
  description: Production URL for North America
- url: https://eu-west-1.api-sbx.silverflow.com/v1
  description: Sandbox URL - Equivalent to https://api-sbx.silverflow.co/v1
security:
- ApiKey: []
- BearerToken: []
tags:
- name: POS Charge Actions
  description: Perform different actions on a previously created charge.
paths:
  /pos/charges/{chargeKey}/cancel:
    servers:
    - url: https://devices.eu-west-1.api.silverflow.com/v1
      description: Production environment
    post:
      operationId: cancelPosCharge
      summary: Cancel Charge [EXPERIMENTAL]
      security:
      - MutualTLS: []
      description: '> **Notice:** This endpoint has different server URLs and authorization method than the rest of the API.

        Cancel a previously created POS charge by reversing its authorization.


        The cancel operation:


        1. Attempts to cancel the clearing of the referenced charge

        2. If clearing cannot be canceled (already submitted), returns HTTP 409

        3. If clearing is canceled successfully, performs a reversal of the authorization


        This operation is only possible for charges with `clearingMode` set to `auto`.

        '
      parameters:
      - $ref: '#/components/parameters/IdempotencyKey'
      - $ref: '#/components/parameters/chargeKey'
      tags:
      - POS Charge Actions
      requestBody:
        description: Optional cancellation metadata
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CancelRequest'
            examples:
              cancel:
                $ref: '#/components/examples/components-examples-Request'
      responses:
        '201':
          description: The reversal action representing the cancellation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/schemas-ReversalAction'
              examples:
                cancel:
                  $ref: '#/components/examples/cancel_Response'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/openapi_components-schemas-InvalidInputErrorDetails'
                - $ref: '#/components/schemas/schemas-InvalidRequestErrorDetails'
              examples:
                InvalidInputErrorExample:
                  $ref: '#/components/examples/components-examples-InvalidInputErrorExample'
                InvalidRequestErrorExample:
                  $ref: '#/components/examples/InvalidRequestErrorExample'
        '401':
          $ref: '#/components/responses/openapi_components-responses-UnauthorizedError'
        '403':
          $ref: '#/components/responses/components-responses-ForbiddenError'
        '404':
          description: Charge not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferencedEntityNotFoundErrorDetails'
              examples:
                EntityNotFoundExample:
                  $ref: '#/components/examples/components-examples-ReferencedEntityNotFoundErrorExample'
        '409':
          description: 'Conflict - charge already canceled, clearing already submitted, or other conflict

            '
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/ClearingAlreadySubmittedErrorDetails'
                - $ref: '#/components/schemas/schemas-UnexpectedClearingStatusErrorDetails'
                - $ref: '#/components/schemas/NonMatchingIdempotentRequestErrorDetails'
                - $ref: '#/components/schemas/IdempotentRequestIsStillBeingProcessedErrorDetails'
              examples:
                ClearingAlreadySubmittedExample:
                  $ref: '#/components/examples/ClearingAlreadySubmittedExample'
                UnexpectedClearingStatusExample:
                  $ref: '#/components/examples/UnexpectedClearingStatusExample'
                NonMatchingIdempotentRequestExample:
                  $ref: '#/components/examples/NonMatchingIdempotentRequestErrorExample'
                IdempotentRequestIsStillBeingProcessedExample:
                  $ref: '#/components/examples/IdempotentRequestIsStillBeingProcessedExample'
        '429':
          $ref: '#/components/responses/components-responses-TooManyRequestsError'
        '500':
          $ref: '#/components/responses/responses-InternalServerError'
  /pos/charges/{chargeKey}/refund:
    servers:
    - url: https://devices.eu-west-1.api.silverflow.com/v1
      description: Production environment
    post:
      operationId: refundPosCharge
      summary: Refund Charge [EXPERIMENTAL]
      security:
      - MutualTLS: []
      tags:
      - POS Charge Actions
      description: '> **Notice:** This endpoint has different server URLs and authorization method than the rest of the API.


        Refunds a POS charge.

        '
      parameters:
      - $ref: '#/components/parameters/IdempotencyKey'
      - $ref: '#/components/parameters/chargeKey'
      requestBody:
        description: Optional refund metadata
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefundRequest'
            examples:
              refund:
                $ref: '#/components/examples/refund_Request'
      responses:
        '201':
          description: Refund action created (either reversal or refund)
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/schemas-ReversalAction'
                - $ref: '#/components/schemas/schemas-RefundAction'
              examples:
                refund:
                  $ref: '#/components/examples/refund_Response'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/openapi_components-schemas-InvalidInputErrorDetails'
                - $ref: '#/components/schemas/schemas-InvalidRequestErrorDetails'
              examples:
                InvalidInputErrorExample:
                  $ref: '#/components/examples/components-examples-InvalidInputErrorExample'
                InvalidRequestErrorExample:
                  $ref: '#/components/examples/InvalidRequestErrorExample'
        '401':
          $ref: '#/components/responses/openapi_components-responses-UnauthorizedError'
        '403':
          $ref: '#/components/responses/components-responses-ForbiddenError'
        '404':
          description: Charge not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferencedEntityNotFoundErrorDetails'
              examples:
                EntityNotFoundExample:
                  $ref: '#/components/examples/components-examples-ReferencedEntityNotFoundErrorExample'
        '409':
          description: 'Conflict - charge already refunded, already canceled, or other conflict

            '
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/AlreadyRefundedErrorDetails'
                - $ref: '#/components/schemas/AlreadyCanceledErrorDetails'
                - $ref: '#/components/schemas/NonMatchingIdempotentRequestErrorDetails'
                - $ref: '#/components/schemas/IdempotentRequestIsStillBeingProcessedErrorDetails'
              examples:
                NonMatchingIdempotentRequestExample:
                  $ref: '#/components/examples/NonMatchingIdempotentRequestErrorExample'
                IdempotentRequestIsStillBeingProcessedExample:
                  $ref: '#/components/examples/IdempotentRequestIsStillBeingProcessedExample'
        '429':
          $ref: '#/components/responses/components-responses-TooManyRequestsError'
        '500':
          $ref: '#/components/responses/responses-InternalServerError'
components:
  responses:
    components-responses-ForbiddenError:
      description: The authenticated client is forbidden to make the request for the resource identified.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ForbiddenErrorDetails'
          examples:
            ForbiddenErrorExample:
              $ref: '#/components/examples/examples-ForbiddenErrorExample'
    openapi_components-responses-UnauthorizedError:
      description: Authentication information is missing or invalid
      headers:
        WWW_Authenticate:
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UnauthorizedErrorDetails'
          examples:
            AuthenticationRequired:
              $ref: '#/components/examples/examples-AuthenticationRequiredExample'
    responses-InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InternalServerErrorDetails'
          examples:
            InternalServerErrorExample:
              $ref: '#/components/examples/components-examples-InternalServerErrorExample'
    components-responses-TooManyRequestsError:
      description: Too Many Requests
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TooManyRequestsErrorDetails'
          examples:
            TooManyRequestsErrorExample:
              $ref: '#/components/examples/TooManyRequestsErrorExample'
  schemas:
    schemas-ReversalAction:
      type: object
      required:
      - key
      - chargeKey
      - type
      - status
      - replacementAmount
      - authorizationResponse
      - created
      - version
      description: 'A reversal action represents a cancellation of a charge''s authorization.

        '
      properties:
        key:
          $ref: '#/components/schemas/schemas-actionKey'
        chargeKey:
          $ref: '#/components/schemas/chargeKey'
        type:
          type: string
          enum:
          - reversal
          description: The type of action (always "reversal" for cancel operations)
        reference:
          $ref: '#/components/schemas/schemas-actionReference'
        status:
          type: object
          required:
          - authorization
          properties:
            authorization:
              type: string
              enum:
              - approved
              - declined
              description: Authorization status of the reversal
        replacementAmount:
          $ref: '#/components/schemas/schemas-ResponseAmount'
        authorizationResponse:
          $ref: '#/components/schemas/AuthorizationResponseForReversalActions'
        created:
          $ref: '#/components/schemas/openapi_components-schemas-created'
        lastModified:
          $ref: '#/components/schemas/components-schemas-lastModified'
        version:
          $ref: '#/components/schemas/schemas-version'
    components-schemas-lastModified:
      type: string
      description: The date and time this object was last modified
      format: iso-8601-date-time
      readOnly: true
    authorizationIsoFieldsMastercardWithDiscriminator:
      allOf:
      - type: object
        required:
        - network
        properties:
          network:
            type: string
            enum:
            - mastercard
      - $ref: '#/components/schemas/commonIsoFields'
    schemas-refundedChargeKey:
      description: The charge key of the refunded charge.
      type: string
      pattern: ^chg-[a-zA-Z0-9]+$
      minLength: 5
      maxLength: 120
      example: chg-1e1dAHhgstYTUhlphPzZ
    InternalServerErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/internal-server-error
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Internal Server Error
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 500
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    schemas-authorizationIsoFieldsBancontactWithDiscriminator:
      allOf:
      - type: object
        required:
        - network
        description: Object containing the raw values from the ISO8583 response message received from the network.
        properties:
          network:
            type: string
            enum:
            - bancontact
      - $ref: '#/components/schemas/commonIsoFields'
    RefundRequest:
      type: object
      properties:
        attemptCancel:
          type: boolean
          default: false
          description: 'If true and the charge has not been cleared yet, the service attempts to cancel the transaction first.

            On success, returns a "ReversalAction". On failure, falls back to the refund process.

            '
        reference:
          $ref: '#/components/schemas/schemas-actionReference'
        dynamicDescriptor:
          $ref: '#/components/schemas/schemas-DynamicDescriptor'
        clearAfter:
          $ref: '#/components/schemas/schemas-clearAfter'
    NonMatchingIdempotentRequestErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/idempotency/request-mismatch
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Idempotent Request Mismatch
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 409
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    ClearingAlreadySubmittedErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/charge/clearing-already-submitted
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Clearing Already Submitted
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 409
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    AuthorizationResponseForReversalActions:
      description: 'Network-specific details from the authorization response.

        This is a discriminated union based on the network property.

        '
      oneOf:
      - $ref: '#/components/schemas/authorizationIsoFieldsAmericanExpressWithDiscriminator'
      - $ref: '#/components/schemas/schemas-authorizationIsoFieldsBancontactWithDiscriminator'
      - $ref: '#/components/schemas/authorizationIsoFieldsDiscoverWithDiscriminator'
      - $ref: '#/components/schemas/authorizationIsoFieldsMastercardWithDiscriminator'
      - $ref: '#/components/schemas/authorizationIsoFieldsVisaWithDiscriminator'
      - $ref: '#/components/schemas/authorizationIsoFieldsUnknown'
    errorTitle:
      type: string
      description: 'A short, human-readable summary of the problem type. It does not change from occurrence to occurrence of the error.

        '
    openapi_components-schemas-InvalidInputErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      - validationErrors
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/invalid-input
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Invalid Input
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 400
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
        validationErrors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
          description: A list of validation errors.
    authorizationIsoFieldsDiscoverWithDiscriminator:
      allOf:
      - type: object
        required:
        - network
        properties:
          network:
            type: string
            enum:
            - discover
      - $ref: '#/components/schemas/commonIsoFields'
    schemas-ResponseAmountBreakdown:
      allOf:
      - $ref: '#/components/schemas/schemas-BaseAmountBreakdown'
      - type: object
        properties:
          cashback:
            allOf:
            - description: 'The cashback amount included in the total transaction `value` in minor units.

                For example `$12.34` should be encoded as `1234`.

                '
            - $ref: '#/components/schemas/openapi_components-schemas-amountValue'
          gratuity:
            allOf:
            - description: 'The gratuity amount included in the total transaction `value` in minor units.

                For example `$12.34` should be encoded as `1234`.

                '
            - $ref: '#/components/schemas/openapi_components-schemas-amountValue'
    schemas-actionReference:
      type: string
      description: 'Action reference assigned by the agent. Must not start with "act-".

        This allows merchants to track actions with their own reference system.

        '
      minLength: 1
      maxLength: 100
      example: cancel-001
    errorInstance:
      type: string
      description: 'A reference that identifies the specific occurrence of the error. The instance is unique for every error.

        '
    isoFieldResponseCodeDescription:
      type: string
      description: The description of the `responseCode`
      example: Approved
    errorStatus:
      type: integer
      format: int32
      description: 'The HTTP status code generated by the origin server for this occurrence

        of the problem.

        '
    schemas-RefundAction:
      type: object
      required:
      - key
      - chargeKey
      - type
      - status
      - amount
      - authorizationResponse
      - created
      - version
      description: 'A refund action represents a refund of a charge.

        '
      properties:
        key:
          $ref: '#/components/schemas/schemas-actionKey'
        chargeKey:
          $ref: '#/components/schemas/chargeKey'
        type:
          type: string
          enum:
          - refund
          description: The type of action (always "refund" for refund operations)
        reference:
          $ref: '#/components/schemas/schemas-actionReference'
        status:
          type: object
          required:
          - authorization
          properties:
            authorization:
              type: string
              enum:
              - approved
              - declined
              description: Authorization status of the refund
        amount:
          $ref: '#/components/schemas/schemas-ResponseAmount'
        clearAfter:
          $ref: '#/components/schemas/schemas-clearAfter'
        refundChargeKey:
          $ref: '#/components/schemas/schemas-refundedChargeKey'
        authorizationResponse:
          $ref: '#/components/schemas/AuthorizationResponseForRefundActions'
        created:
          $ref: '#/components/schemas/openapi_components-schemas-created'
        lastModified:
          $ref: '#/components/schemas/components-schemas-lastModified'
        version:
          $ref: '#/components/schemas/schemas-version'
    schemas-BaseAmountBreakdown:
      type: object
      required:
      - baseAmount
      description: 'A breakdown of the transaction `value`.


        All provided amounts must exactly add up to `value`.

        Providing a breakdown is only required if any other amounts besides the `baseAmount` are included.

        '
      properties:
        baseAmount:
          allOf:
          - description: 'The base transaction value in minor units. For example `$12.34` should be encoded as `1234`.

              '
          - $ref: '#/components/schemas/openapi_components-schemas-amountValue'
    AuthorizationResponseForRefundActions:
      description: 'Network-specific details from the authorization response for refund actions.

        This is a discriminated union based on the network property.

        '
      oneOf:
      - $ref: '#/components/schemas/authorizationIsoFieldsAmericanExpressWithDiscriminator'
      - $ref: '#/components/schemas/schemas-authorizationIsoFieldsBancontactWithDiscriminator'
      - $ref: '#/components/schemas/authorizationIsoFieldsDiscoverWithDiscriminator'
      - $ref: '#/components/schemas/authorizationIsoFieldsMastercardWithDiscriminator'
      - $ref: '#/components/schemas/authorizationIsoFieldsVisaWithDiscriminator'
      - $ref: '#/components/schemas/authorizationIsoFieldsUnknown'
    schemas-ResponseAmount:
      type: object
      required:
      - value
      - currency
      additionalProperties: false
      description: 'The amount encoded as an object with a `value` in minor units and a `currency` code.


        An optional `breakdown` can be provided to indicate specific sub-amounts.

        '
      properties:
        value:
          allOf:
          - description: 'The full transaction amount in minor units. For example `$12.34` should be encoded as `1234`.


              If a `breakdown` is provided, it must exactly add up to this `value`.

              '
          - $ref: '#/components/schemas/openapi_components-schemas-amountValue'
        currency:
          $ref: '#/components/schemas/openapi_components-schemas-currencyCode-2'
        breakdown:
          $ref: '#/components/schemas/schemas-ResponseAmountBreakdown'
    schemas-actionKey:
      type: string
      description: Uniquely identifies an action
      pattern: ^(act-|rvsl-|incr-|rfnd-|clr-|void-|dis-)[A-Za-z0-9]{16,22}$
      example: rvsl-5BH5chO93SXky5gw
    authorizationIsoFieldsUnknown:
      type: object
      required:
      - network
      - responseCode
      - responseCodeDescription
      properties:
        network:
          type: string
          enum:
          - unknown
        responseCode:
          type: string
          enum:
          - unknown
        responseCodeDescription:
          type: string
          enum:
          - unknown
    IdempotentRequestIsStillBeingProcessedErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/idempotency/request-is-still-being-processed
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Request Is Still Being Processed
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 409
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    authorizationIsoFieldsAmericanExpressWithDiscriminator:
      allOf:
      - type: object
        required:
        - network
        properties:
          network:
            type: string
            enum:
            - american-express
      - $ref: '#/components/schemas/commonIsoFields'
    openapi_components-schemas-currencyCode-2:
      type: string
      enum:
      - AED
      - AFN
      - ALL
      - AMD
      - AOA
      - ARS
      - AUD
      - AWG
      - AZN
      - BAM
      - BBD
      - BDT
      - BGN
      - BHD
      - BIF
      - BMD
      - BND
      - BOB
      - BRL
      - BSD
      - BTN
      - BWP
      - BYN
      - BZD
      - CAD
      - CDF
      - CHF
      - CLP
      - CNY
      - COP
      - CRC
      - CUC
      - CUP
      - CVE
      - CZK
      - DJF
      - DKK
      - DOP
      - DZD
      - EGP
      - ERN
      - ETB
      - EUR
      - FJD
      - FKP
      - GBP
      - GEL
      - GHS
      - GIP
      - GMD
      - GNF
      - GTQ
      - GYD
      - HKD
      - HNL
      - 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
      - LYD
      - MAD
      - MDL
      - MGA
      - MKD
      - MMK
      - MNT
      - MOP
      - MRU
      - MUR
      - MVR
      - MWK
      - MXN
      - 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
      - SOS
      - SRD
      - SSP
      - STN
      - SYP
      - SZL
      - THB
      - TJS
      - TMT
      - TND
      - TOP
      - TRY
      - TTD
      - TWD
      - TZS
      - UAH
      - UGX
      - USD
      - UYU
      - UZS
      - VES
      - VND
      - VUV
      - WST
      - XAF
      - XCD
      - XCG
      - XOF
      - XPF
      - YER
      - ZAR
      - ZMW
      - ZWL
      description: An alphabetic ISO-4217 currency code.
      externalDocs:
        description: Find more info here
        url: https://www.iso.org/iso-4217-currency-codes.html
      example: EUR
    authorizationIsoFieldsVisaWithDiscriminator:
      allOf:
      - type: object
        required:
        - network
        properties:
          network:
            type: string
            enum:
            - visa
      - $ref: '#/components/schemas/commonIsoFields'
    AlreadyRefundedErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/charge/already-refunded
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Charge Already Refunded
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 409
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    TooManyRequestsErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/too-many-requests
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Too Many Requests
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 429
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    errorDetail:
      type: string
      description: 'A human readable explanation specific to this occurrence of the problem.

        '
    schemas-InvalidRequestErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/charge/invalid-request
        title:
          $ref: '#/components/schemas/errorTitle'
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 400
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    schemas-UnexpectedClearingStatusErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/charge/unexpected-clearing-status
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Unexpected Clearing Status
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 409
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    openapi_components-schemas-created:
      type: string
      description: The date and time this object was created
      format: iso-8601-date-time
      readOnly: true
    isoFieldResponseCode:
      type: string
      description: Contents of field 39
      example: '00'
    UnauthorizedErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/authentication-required
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Authentication Required
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 401
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    ValidationError:
      type: object
      required:
      - path
      - message
      properties:
        path:
          type: string
          description: A relative path to the error location within the request body.
        errorCode:
          type: string
          description: A code that identifies the error.
        message:
          type: string
          description: A brief description of the validation error.
    ReferencedEntityNotFoundErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/referenced-entity-not-found
        title:
          allOf:
          - $ref: '#/components/schemas/errorTitle'
          - enum:
            - Referenced Entity Not Found
        status:
          allOf:
          - $ref: '#/components/schemas/errorStatus'
          - enum:
            - 409
        detail:
          $ref: '#/components/schemas/errorDetail'
        instance:
          $ref: '#/components/schemas/errorInstance'
    AlreadyCanceledErrorDetails:
      type: object
      required:
      - type
      - title
      - status
      - detail
      - instance
      properties:
        type:
          allOf:
          - $ref: '#/components/schemas/errorType'
          - enum:
            - /silverflow/problems/charge/already-canceled
        title:
          allOf:
   

# --- truncated at 32 KB (46 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/silverflow/refs/heads/main/openapi/silverflow-pos-charge-actions-api-openapi.yml