checkout-api.yaml

openapi: 3.1.0
info:
    title: Two Order API
    version: '1.0'
    description: |-
        This API is for creating orders connected to an online purchase through your solution.
        The API also functions as a central building block when using other Two APIs, e.g. Marketplace API, and Trade Account Onboarding API.

        Specifically, the API enables you to:

        - Check whether a buyer is accepted for credit before placing the order (Order intent)
        - Create orders
        - Fulfil orders (Send invoice from Two)
        - Edit orders
        - Cancel orders
        - Refund orders (Send credit note)
        - Download invoice

        Below you will find a description of a typical flow of how the different endpoints are called. However, you might want to deviate from this order depending on your setup.
        For inspiration you can find a sample implementation of Two at https://demo.two.inc

        ### Step 0: Use the Two Company Search API to find the company
        By using the Two Company Search API, you ensure that the user places an order on behalf of the correct organization. It enables an improved user experience and lowers the friction.

        **Using Canonical IDs (Recommended):** The Company Search API returns a `canonical_id` for each company. You can use this canonical_id when creating orders and order intents instead of providing full company details. This ensures data accuracy and simplifies integration.

        Example:
        ```json
        {
          "buyer": {
            "company": {
              "company_canonical_id": "abc123def456"
            },
            "representative": { ... }
          }
        }
        ```

        ### Step 1: Check whether a buyer will be accepted for credit during checkout (Order intent)
        Use `POST /v1/order_intent` to credit check your buyers during the checkout. Only enable Two as the payment option if the credit check is approved.
        Collect the `tracking_id` from the response of the order intent in order to connect the order_intent with the actual order being placed by the buyer.

        ### Step 2: Create order
        Create an order by building a request body containing all required elements and call the `POST /v1/order` endpoint.
        1. Read the state and status of the order response.
        2. Check if the status is `APPROVED`.
        3. Check if the state is `UNVERIFIED`, and redirect the user to the `payment_url`.

        After completing the verfication, the user is redirected back to your order confirmation page.

        ### Step 3: Confirm order
        On the order confirmation page use the `POST /v1/order/<order_id>/confirm` endpoint to confirm that the user has arrived at the order confirmation page.

        ### Step 4: Handling orders

        #### Cancel order
        Use `POST /v1/order/<order_id>/cancel` to cancel a specific order.

        #### Edit order
        Use `PUT /v1/order/<order_id>` with a specified request body to edit an order.

        #### Fulfil order
        Use `POST /v1/order/<order_id>/fulfilled` with a specified request body to fulfil all line items of an order.

        Note: Include a request body in order to do a partial fulfillment.


        #### Refund order
        Use `POST /v1/order/<order_id>/refund` to refund a specific order.

        Note: Include a request body in order to do a partial refund.


        ## Environments

        ### Testing

        [https://api.sandbox.two.inc](https://api.sandbox.two.inc/v1/health)

        Note: Read about our [sandbox environment specific behaviour](/docs/guides/sandbox-behaviour-page/).

        ### Production

        [https://api.two.inc](https://api.two.inc/v1/health)
tags:
-   name: Order intent
-   name: Order
-   name: Invoice
-   name: API Key
-   name: Settlement report
paths:
    /v1/order_intent:
        post:
            summary: Create order intent
            operationId: create_order_intent_handler.post
            description: The endpoint enables the merchant to check in advance whether
                invoice payment is applicable as a payment method for the `Buyer`.
                Two will perform a risk assessment and credit check using the data
                provided in the `OrderIntent` before a boolean is returned as a result.
                If `line_items` are provided Two will be able to do a more accurate
                assessment and the approval rate will in general increase.
            tags:
            - Order intent
            parameters: []
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '201':
                    description: Create order intent
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderIntentResponseSchema'
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/CreateOrderIntentRequestSchema'
    /v1/order_intent/{order_intent_id}:
        get:
            summary: Get order intent
            operationId: get_order_intent_handler.get
            description: The endpoint fetches a specific order intent.
            tags:
            - Order intent
            parameters:
            -   name: order_intent_id
                in: path
                required: true
                schema:
                    type: string
                description: ''
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Get order intent
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderIntentResponseSchema'
            security:
            -   X-Api-Key: []
    /v1/order:
        post:
            summary: Create order
            operationId: create_order_handler.post
            description: 'Endpoint to create a new order in Two''s system. Once all
                the required order data has been added to the request body and the
                order has been created successfully, Two performs a credit check of
                the customer and updates the `status`. In addition to general information
                about the order and its content, the response body contains the status
                of the credit check and `payment_url` which is used for customer identification.
                After the verification step is completed successfully, the order will
                change `state`. The order is now approved and verified, i.e. the order
                is placed. Later, the order has to be handled by the merchant, either
                through Two''s API endpoints or the merchant portal. Note: When creating
                an order it is important to note that the `invoice_type`, `country_prefix`,
                and `organization_number` has to match what the merchant has signed
                up for with Two. For trade account orders (providing `merchant_user_id`):   -
                The `buyer` object and `billing_address` can be omitted; they''ll
                be populated from the trade account   - If both are provided, the
                `buyer` data will be persisted instead'
            tags:
            - Order
            parameters: []
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '201':
                    description: Order created
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderResponseSchema'
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/CreateOrderRequestSchema'
    /v1/pricing/order/fee:
        post:
            summary: Quote fees for an order before creating or editing it.
            operationId: calculate_pricing_order_fee_v1_handler.post
            description: This endpoint returns the estimated fee for the provided
                amount and order terms, and a `buyer_fee_share` value that can be
                added as a buyer-facing line item when the merchant wants to recover
                Two fees from the buyer.
            tags:
            - Order
            parameters: []
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Order fee quote response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/PricingOrderFeeResponseSchema'
                '400':
                    description: Invalid request payload
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/OrderFeeRequestSchema'
    /v1/order/{order_id}:
        get:
            summary: Get order details
            operationId: get_order_handler.get
            description: Endpoint to retrieve details related to a previously created
                order. The endpoint is typically used to check that the order has
                been verified successfully, in addition to other relevant `state`
                and `status` changes.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order to be retrieved
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderResponseSchema'
            security:
            -   X-Api-Key: []
        put:
            summary: Edit order
            operationId: edit_order_handler.put
            description: Endpoint to edit a previously created order which has not
                been fulfilled. The request body may contain changes related items,
                quantity, prices, etc.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order to be edited
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderResponseSchema'
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/EditOrderRequestSchema'
    /v1/order/{order_id}/payment_link:
        get:
            summary: Generate a payment initiation link for a specific order.
            operationId: get_order_payment_link_handler.get
            description: 'This endpoint creates a secure payment link that allows
                buyers to initiate payment for an invoice. The link is only generated
                if: - The order is in a supported country - The merchant and buyer
                are in the same country - The invoice currency matches the merchant''s
                home currency Returns:     Contains the payment link URL or null if
                not available'
            tags:
            - Invoice
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: ''
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Payment link generated successfully
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/PaymentLinkResponseSchema'
                '400':
                    description: Bad request - invalid order or payment link generation
                        failed
                '401':
                    description: Unauthorized - API key required
                '404':
                    description: Order not found or access denied
            security:
            -   X-Api-Key: []
    /v1/order/merchant-order-id/{merchant_order_id}:
        get:
            summary: Get orders by merchant order ID
            operationId: get_orders_by_merchant_order_id_handler.get
            description: Endpoint to retrieve all orders matching a given `merchant_order_id`.
                This is useful when the merchant's own order identifier was set during
                order creation and the merchant needs to look up order details, check
                verification status, or track `state` and `status` changes.
            tags:
            - Order
            parameters:
            -   name: merchant_order_id
                in: path
                required: true
                schema:
                    type: string
                description: The merchant order ID set during order create call
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderResponseList'
                '404':
                    description: No orders found for this merchant_order_id
            security:
            -   X-Api-Key: []
    /v1/order/{order_id}/confirm:
        post:
            summary: Confirm order
            operationId: mark_confirmed_order_handler.post
            description: The confirm endpoint moves an order to the "CONFIRMED" state,
                though this is optional as both verified and confirmed orders guarantee
                credit for 21 days and can proceed to fulfilment. It simply signals
                that a buyer has returned to the merchant's site after having completed
                their order verification.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order to be confirmed
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderResponseSchema'
            security:
            -   X-Api-Key: []
    /v1/order/{order_id}/renew:
        post:
            summary: Renew order
            operationId: renew_order_handler.post
            description: Re-run credit check to renew our credit guarantee. If an
                external funding provider owns the order, we cancel that external
                order, re-create it, and update `order.external_order_id` on our internal
                order. **Note that Norwegian Orders funded by Kredinor that have already
                been partially fulfilled cannot be renewed via our credit renewal
                end point.**
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order to be renewed
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Order renewed successfully
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderResponseSchema'
                '400':
                    description: Order is not renewable or credit check failed on
                        renewal
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '404':
                    description: Order not found or access denied
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
            security:
            -   X-Api-Key: []
    /v1/order/{order_id}/cancel:
        post:
            summary: Cancel order
            operationId: cancel_order_handler.post
            description: Endpoint to change the state of an order to cancelled, and
                void the invoice. An order cannot change state to cancelled after
                being fulfilled. After fulfilment the merchant will have to refund
                the order instead.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order to be cancelled
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Cancellation succeeded
                '202':
                    description: Already cancelled
            security:
            -   X-Api-Key: []
    /v1/order/{order_id}/fulfillments:
        get:
            summary: Get fulfilled orders
            operationId: get_fulfilled_order_handler.get
            description: This endpoint is used to fetch the associated fulfilled orders
                and refunds for a given order ID. If the requested order is linked
                to a partially fulfilled order, the endpoint returns all associated
                fulfilled orders.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the root order
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/FulfilledOrdersResponseSchema'
            security:
            -   X-Api-Key: []
        post:
            summary: Fulfil order
            operationId: fulfill_order_handler.post
            description: Endpoint to fully or partially fulfill an order based on
                the line item selection and gross, net amount values. If fully fulfilled,
                the endpoint changes the state of an order to `FULFILLED`. If partial
                fulfilment, the endpoint changes the status of an order to `PARTIAL`
                and creates a child order with 'FULFILLED' state. Note that fulfilment
                is an async process may take a few minutes to realise.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order to be partially fulfilled
            -   name: Idempotency-Key
                in: header
                schema:
                    anyOf:
                    -   maxLength: 100
                        type: string
                    -   type: 'null'
                    default: null
                    title: Idempotency-Key
                required: false
                description: ''
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/FulfillOrderResponseSchema'
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/FulfillOrderSchema'
                required: false
    /v1/order/{order_id}/fulfillments/complete_partial:
        post:
            summary: Complete partial order
            operationId: complete_partial_order_handler.post
            description: Cancels any unfulfilled parts of a partially fulfilled order,
                completing it. Use this endpoint when the merchant has fulfilled some
                line items via partial fulfilment and wants to cancel the remaining
                unfulfilled portion rather than fulfilling it.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The root ID of the partial order to be completed/cancelled
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Partial order completed successfully
            security:
            -   X-Api-Key: []
    /v1/order/{order_id}/invoice_details:
        get:
            summary: Fetch invoice details
            operationId: get_invoice_details_handler.get
            description: Return an object representing the current status of an invoice,
                including payment status.
            tags:
            - Invoice
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order being queried
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/InvoiceDetailsWithStatusSchema'
                '404':
                    description: Order not found
                '409':
                    description: Order not invoiced
            security:
            -   X-Api-Key: []
    /v2/orders:
        get:
            summary: Get list of orders
            operationId: retrieve_order_list_handler.get
            description: Additionally following query params can be specified to manage
                pagination settings     `limit` - set limit items per page (default=100)     `page`
                - page number (calculated from limit and total results) to display     `offset`
                - items offset - alternative to `page` (pages not calculated if this
                param provided) Returns 401 error code if not authenticated. Returns
                404 error code if merchant is not specified.
            tags:
            - Order
            parameters:
            -   name: start_date
                in: query
                schema:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: First date that should be included in the list of
                        orders.
                    title: Start Date
                required: false
                description: First date that should be included in the list of orders.
            -   name: end_date
                in: query
                schema:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Last date that should be included in the list of
                        orders.
                    title: End Date
                required: false
                description: Last date that should be included in the list of orders.
            -   name: limit
                in: query
                schema:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: Limit the number of results per page to this number.
                    title: Limit
                required: false
                description: Limit the number of results per page to this number.
            -   name: page
                in: query
                schema:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: Page number to display results for.
                    title: Page
                required: false
                description: Page number to display results for.
            -   name: offset
                in: query
                schema:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: Number of offset results by (page parameter is disregarded
                        if provided).
                    title: Offset
                required: false
                description: Number of offset results by (page parameter is disregarded
                    if provided).
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/OrderListRequestSchema'
            security:
            -   X-Api-Key: []
    /v1/order/{order_id}/verification_data:
        get:
            summary: Get order verification data
            operationId: get_order_verification_data.get
            description: Endpoint to retrieve verification data related to an order.
                This endpoint is typically used by merchants to get data related to
                the verification links sent for an order.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order to be retrieved
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/VerificationDataResponseSchema'
            security:
            -   X-Api-Key: []
    /v1/order/{order_id}/notify:
        post:
            summary: Send order verification notification to buyer
            operationId: notify_order_handler.post
            description: 'Within the notification, the buyer will receive a link that
                they need to visit to complete their order verification. Note: For
                trade account orders (with merchant_user_id), notifications are always
                sent to the phone number registered with the trade account, not the
                phone number in order.buyer.representative.'
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: ''
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Trigger order verification notification to buyer
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/NotifyRequestSchema'
    /v1/order/{order_id}/refund:
        post:
            summary: Refund order
            operationId: refund_order_handler.post
            description: Endpoint to refund an order. The customer will receive a
                credit note with a description of the items that are credited. An
                order can also be partially refunded by specifying the exact items
                and amount that are refunded in the JSON request body.
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order to be refunded
            -   name: Idempotency-Key
                in: header
                schema:
                    anyOf:
                    -   maxLength: 100
                        type: string
                    -   type: 'null'
                    default: null
                    title: Idempotency-Key
                required: false
                description: ''
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '201':
                    description: Refund order
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/RefundSummaryResponseSchema'
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/RefundRequestSchema'
    /v1/invoice/{order_id}/pdf:
        get:
            summary: Download PDF invoice via Order ID
            operationId: invoice_pdf_handler.get
            description: Endpoint to fetch the invoice for a fulfilled order using
                the global order ID. The order ID is returned as part of the create
                order response and is under the key of `id` at the highest level of
                the JSON response.
            tags:
            - Invoice
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The order id of a fulfilled order
            -   name: v
                in: query
                schema:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional parameter `v=original` to download the original
                        invoice and not the credit note (if any)
                    examples:
                    - original
                    title: V
                required: false
                description: Optional parameter `v=original` to download the original
                    invoice and not the credit note (if any)
            -   name: lang
                in: query
                schema:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Specify language to generate PDF [`en_US`, `nb_NO`,
                        `sv_SE`]
                    examples:
                    - en_US
                    title: Lang
                required: false
                description: Specify language to generate PDF [`en_US`, `nb_NO`, `sv_SE`]
            -   name: generate
                in: query
                schema:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: 'false'
                    description: Optional parameter generate (defaults to false) to
                        help with testing or the need to re-create if the template
                        changes etc
                    title: Generate
                required: false
                description: Optional parameter generate (defaults to false) to help
                    with testing or the need to re-create if the template changes
                    etc
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
    /v1/invoice/{invoice_id}/document:
        get:
            summary: Download PDF Invoice via Invoice ID
            operationId: invoice_document_handler.get
            description: Endpoint to fetch the invoice for a fulfilled order by using
                the global invoice ID. The invoice ID is provided in the response
                as part of the `invoice_details` object with field `id`.
            tags:
            - Invoice
            parameters:
            -   name: invoice_id
                in: path
                required: true
                schema:
                    type: string
                description: The id of an invoice connected to a fulfilled order
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
    /v1/invoice/pdfs:
        get:
            summary: Download PDF Invoices in a zip file
            operationId: zipped_invoice_pdfs_handler.get
            description: Only fulfilled orders can have invoices.
            tags:
            - Invoice
            parameters:
            -   name: v
                in: query
                schema:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional parameter `v=original` to download the original
                        invoice and not the credit note (if any)
                    examples:
                    - original
                    title: V
                required: false
                description: Optional parameter `v=original` to download the original
                    invoice and not the credit note (if any)
            -   name: lang
                in: query
                schema:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Specify language to generate PDF [`en_US`, `nb_NO`,
                        `sv_SE`]
                    examples:
                    - en_US
                    title: Lang
                required: false
                description: Specify language to generate PDF [`en_US`, `nb_NO`, `sv_SE`]
            -   name: generate
                in: query
                schema:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: 'false'
                    description: Optional parameter generate (defaults to false) to
                        help with testing or the need to re-create if the template
                        changes etc
                    title: Generate
                required: false
                description: Optional parameter generate (defaults to false) to help
                    with testing or the need to re-create if the template changes
                    etc
            -   name: order_id
                in: query
                schema:
                    description: Order IDs of the invoices, provided multiple times
                        as a query parameter
                    format: uuid
                    title: Order Id
                    type: string
                required: true
                description: Order IDs of the invoices, provided multiple times as
                    a query parameter
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
            security:
            -   X-Api-Key: []
    /v1/invoice/{invoice_id}:
        patch:
            summary: Change an invoice post fulfillment
            operationId: edit_invoice.patch
            description: This will credit note the current invoice and create a new
                invoice, with new invoice number, with the requested fields updated.
                Note, this will not work for reconciled invoices.
            tags:
            - Invoice
            parameters:
            -   name: invoice_id
                in: path
                required: true
                schema:
                    type: string
                description: ''
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/EditInvoiceRequestSchema'
    /v1/invoice/{invoice_id}/emails:
        put:
            summary: edit_invoice_emails <PUT>
            operationId: edit_invoice_emails.put
            description: ''
            tags:
            - Invoice
            parameters:
            -   name: invoice_id
                in: path
                required: true
                schema:
                    type: string
                description: ''
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: OK
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/EditInvoiceEmailsRequest'
    /invoicing/v0/invoice:
        post:
            summary: Create an invoice for one or more orders atomically.
            operationId: invoice_creation_handler.post
            description: 'This API provides invoicing operations including **grouped
                fulfillment** (also known as "Samlefaktura") for consolidating multiple
                verified orders into a single invoice - perfect for scenarios where
                your customer places multiple orders that should be billed together.
                Use Cases - **Same-day deliveries**: Customer places multiple orders
                throughout the day, invoice once at end of day - **Weekly/monthly
                billing**: Consolidate a week''s worth of orders into one invoice
                - **Project-based**: Multiple orders for the same project combined
                into one bill How It Works - **Single order**: Simply fulfills the
                order to create an invoice - **Multiple orders**: Merges all line
                items and totals into one consolidated order, fulfills it, and marks
                the original orders as CANCELLED (they remain viewable and linked
                via successor_order_id) The operation is **atomic** - either all orders
                are successfully processed and the invoice is created, or the entire
                operation fails and no changes are made. Requirements All orders must:
                - Be in **VERIFIED** or **CONFIRMED** state - Have the **same buyer
                organization** (organization number), **same currency** and **same
                merchant** - Not have been partially fulfilled or be partial orders
                themselves Important notes - Consolidated order uses the first order''s
                billing details as template - Original merchant order IDs are preserved
                in the consolidated order''s notes - Line items from different orders
                are combined in sequence (not grouped by order)'
            tags:
            - Invoice
            parameters: []
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '201':
                    description: Invoice created successfully
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/InvoiceCreationResponseSchema'
                '400':
                    description: Bad Request
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/InvoiceCreationRequestSchema'
    /v1/merchant/{merchant_id}/api_key:
        post:
            summary: Create API key
            operationId: create_merchant_api_key_handler.post
            description: Create a new API key. An existing API key is required to
                authenticate the request. If you do not have an API key yet, this
                can be obtained from the merchant portal integration panel. Note that
                production API key is only available after a manual review once onboarding
                and integration is complete. The existing key will remain valid until
                it is revoked.
            tags:
            - API Key
            parameters:
            -   name: merchant_id
                in: path
                required: true
                schema:
                    type: string
                description: Merchant ID
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '201':
                    description: API key schema
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/CreateMerchantAPIKeyResponseSchema'
                '403':
                    description: Access denied
                '404':
                    description: Merchant not found
            security:
            -   X-Api-Key: []
        get:
            summary: Retrieve API keys
            operationId: retrieve_merchant_api_keys_handler.get
            description: Retrieve a list of metadata associated with active API keys.
            tags:
            - API Key
            parameters:
            -   name: merchant_id
                in: path
                required: true
                schema:
                    type: string
                description: Merchant ID
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: List of API key metadata
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/MerchantAPIKeyResponseSchemaList'
                '404':
                    description: Merchant not found
            security:
            -   X-Api-Key: []
    /v1/merchant/{merchant_id}/api_key/{api_key_id}:
        get:
            summary: Retrieve API key
            operationId: retrieve_merchant_api_key_handler.get
            description: Retrieve metadata related to an active API key.
            tags:
            - API Key
            parameters:
            -   name: merchant_id
                in: path
                required: true
                schema:
                    type: string
                description: Merchant ID
            -   name: api_key_id
                in: path
                required: true
                schema:
                    type: string
                description: API Key ID
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: API key metadata
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/MerchantAPIKeyResponseSchema'
                '404':
                    description: Merchant or API key not found
            security:
            -   X-Api-Key: []
        delete:
            summary: Revoke API key
            operationId: revoke_merchant_api_key_handler.delete
            description: Revoke an existing API key. Once revoked, the key will stop
                working for subsequent requests.
            tags:
            - API Key
            parameters:
            -   name: merchant_id
                in: path
                required: true
                schema:
                    type: string
                description: Merchant ID
            -   name: api_key_id
                in: path
                required: true
                schema:
                    type: string
                description: API Key ID
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: API key deleted successfully
                '403':
                    description: Access denied
                '404':
                    description: Merchant not found
            security:
            -   X-Api-Key: []
    /v2/merchant/settlement:
        get:
            summary: Get settlements
            operationId: get_merchant_settlements_v2_handler.get
            description: Endpoint to retrieve a cursor-paginated list of settlements
                for the authenticated merchant. Each settlement contains payout details
                including the settlement date, recipient account information, payout
                amount and currency, and payment reference. Use the `page_cursor`
                from the response metadata to paginate through results.
            tags:
            - Settlement report
            parameters: []
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Cursor-paginated list of settlements
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/PaginatedSettlementListCursorSchema'
                '400':
                    description: Bad request
            security:
            -   X-Api-Key: []
    /v2/merchant/settlement/{settlement_id}/statement:
        get:
            summary: Get settlement statement
            operationId: get_merchant_settlement_statement_handler.get
            description: Endpoint to download a settlement statement file for a specific
                settlement. The response is a binary file (`.xlsx` or `.csv`) containing
                the detailed breakdown of orders, refunds, and fees included in the
                settlement.
            tags:
            - Settlement report
            parameters:
            -   name: settlement_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the settlement to download the statement for
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Settlement statement file (.xlsx or .csv)
                '400':
                    description: Bad request or unsupported file type
            security:
            -   X-Api-Key: []
    /v2/merchant/statement:
        get:
            summary: Get settlement report
            operationId: get_merchant_statement_handler.get
            description: Endpoint to download a settlement report for a specified
                date range as `.xlsx` or `.csv`. The report contains all settlements
                within the given period, broken down by order with details including
                fees, net amounts, and payment references.
            tags:
            - Settlement report
            parameters:
            -   name: start_date
                in: query
                schema:
                    description: The first date that should be included in the statement.
                    examples:
                    - '2023-01-01'
                    title: Start Date
                    type: string
                required: true
                description: The first date that should be included in the statement.
            -   name: end_date
                in: query
                schema:
                    description: The last date that should be included in the statement.
                    examples:
                    - '2023-01-31'
                    title: End Date
                    type: string
                required: true
                description: The last date that should be included in the statement.
            -   name: filetype
                in: query
                schema:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: xlsx
                    description: The filetype of the statement file. Two currently
                        supports csv and xlsx as value for the filetype parameter.
                        Default is xlsx.
                    title: Filetype
                required: false
                description: The filetype of the statement file. Two currently supports
                    csv and xlsx as value for the filetype parameter. Default is xlsx.
            -   name: country_code
                in: query
                schema:
                    default: 'NO'
                    description: The country code of the payout account you want to
                        extract a settlement file for. Country code in ISO 3166 alpha-2
                        format
                    examples:
                    - GB
                    title: Country Code
                    type: string
                required: false
                description: The country code of the payout account you want to extract
                    a settlement file for. Country code in ISO 3166 alpha-2 format
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '200':
                    description: Settlement report file (.xlsx or .csv)
                '400':
                    description: Bad request, invalid dates, or unsupported file type/country
                        code
            security:
            -   X-Api-Key: []
    /v1/order/{order_id}/transactions:
        put:
            summary: Update reconciliation events
            operationId: update_reconciliation_events_handler.put
            description: 'Endpoint for merchants to provide reconciliation events
                (e.g., payins, credit notes and credit losses). As this is a PUT request,
                all events for the given `order_id` should be included in the request.
                Existing reconciliation events associated with this `order_id` will
                be removed and replaced. **Note: this is a RaaS-specific endpoint
                which is not relevant to most merchants.**'
            tags:
            - Order
            parameters:
            -   name: order_id
                in: path
                required: true
                schema:
                    type: string
                description: The ID of the order for which the events are to be reconciled.
            responses:
                default:
                    description: Error response
                    content:
                        application/json:
                            schema:
                                $ref: '#/components/schemas/ErrorResponse'
                '204':
                    description: Success, no content
                '400':
                    description: Missing information
                '403':
                    description: Access denied
                '404':
                    description: Invalid request, order not found
            security:
            -   X-Api-Key: []
            requestBody:
                content:
                    application/json:
                        schema:
                            $ref: '#/components/schemas/ReconOutcomeEventsRequestSchema'
components:
    schemas:
        ErrorResponse:
            properties:
                error_code:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: An error code related to the error.
                    title: Error Code
                error_details:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: A detailed description of the error when available.
                    title: Error Details
                error_message:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: A short description of the error.
                    title: Error Message
                error_json:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/ErrorJSON'
                        type: array
                    -   type: 'null'
                    default: null
                    description: A list of errors when available.
                    title: Error Json
                error_trace_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: A unique trace ID for the request that generated
                        the error. Please quote this trace ID in any support requests.
                    title: Error Trace Id
            title: ErrorResponse
            type: object
        ErrorJSON:
            properties:
                loc:
                    anyOf:
                    -   items:
                            anyOf:
                            -   type: string
                            -   type: integer
                        type: array
                    -   type: 'null'
                    default: null
                    description: Error location.
                    title: Loc
                msg:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Error message.
                    title: Msg
                type:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Error type.
                    title: Type
                ctx:
                    anyOf:
                    -   type: string
                    -   additionalProperties: true
                        type: object
                    -   type: 'null'
                    default: null
                    description: Error context information.
                    title: Ctx
            title: ErrorJSON
            type: object
        CreateOrderIntentRequestSchema:
            example:
                buyer:
                    company:
                        company_name: TWO B2B LTD
                        country_prefix: GB
                        organization_number: '13078389'
                    representative:
                        email: john.doe@twob2bltd.com
                        first_name: John
                        last_name: Doe
                        phone_number: '+447516498321'
                currency: GBP
                gross_amount: '120'
                line_items:
                -   description: Blue whale poster
                    details:
                        barcodes:
                        -   type: SKU
                            value: 5954d9e0-ebfb-4498-86a9-3141e8942dc8
                        -   type: UPC
                            value: cece4007-028c-469c-b0d2-2c038b583b69
                        brand: Whale Posters INC
                        categories:
                        - Art
                        - Home
                        part_number: n/a
                    discount_amount: '0'
                    gross_amount: '120'
                    image_url: https://www.exampleobjects.com/product-image-800x600
                    name: Whale poster
                    net_amount: '100'
                    product_page_url: https://www.example.com/products/7e34f2a8d
                    quantity: 1.0
                    quantity_unit: pcs
                    tax_amount: '20'
                    tax_class_name: VAT 20%
                    tax_rate: '0.2'
                    type: PHYSICAL
                    unit_price: '100'
                merchant_id: 32d8eb3f-8ac3-4aca-82b9-dbbd6f416cfb
                order_origination: ONLINE
            properties:
                gross_amount:
                    description: net_amount + tax_amount
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Gross Amount
                    type: string
                net_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Net amount is optional but helpful for accurate assessment
                        of order intents. If not provided, assessment will be conducted
                        based on gross amount only.
                    title: Net Amount
                tax_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: net_amount * tax_rate
                    title: Tax Amount
                invoice_type:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceTypeEnum'
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: 'FUNDED_INVOICE: Two will handle the invoice and
                        transfer the funds to the merchant as per the factoring agreement.
                        The invoice_details field will be populated by Two. DIRECT_INVOICE:
                        Two generates and sends the invoice to the customer based
                        on the bank account provided by the merchant, but the merchant
                        takes the full credit and fraud risk on direct invoices and
                        they will not receive a payout.'
                currency:
                    description: Currency code in ISO 4217 format. E.g. 'NOK'
                    title: Currency
                    type: string
                line_items:
                    description: List of the line items that constitute the order.
                    items:
                        $ref: '#/components/schemas/LineItemRequestSchema'
                    title: Line Items
                    type: array
                buyer:
                    anyOf:
                    -   $ref: '#/components/schemas/LaxRepBuyerSchema'
                    -   $ref: '#/components/schemas/SuperLaxRepBuyerSchema'
                    -   $ref: '#/components/schemas/BuyerSchemaForOrderIntentCreation'
                    description: Fields representing the buyer. Some elements are
                        optional. Providing optional information enables a more accurate
                        evaluation of the buyer.
                    title: Buyer
                merchant_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: A globally unique merchant ID set by Two.
                    title: Merchant Id
                merchant_short_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: Deprecated in favor of merchant_id.
                    title: Merchant Short Name
                shipping_address:
                    anyOf:
                    -   $ref: '#/components/schemas/CreateAddressRequestSchema'
                    -   type: 'null'
                    default: null
                    description: Order shipping address. Optional. Providing this
                        information enables a more accurate evaluation of the buyer.
                order_origination:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderOriginationEnum'
                    -   type: 'null'
                    default: null
                    description: IN_STORE orders are not enabled by default. Please
                        reach out to us if you would like to discuss IN_STORE orders.
                terms:
                    anyOf:
                    -   description: For backwards compatibility, `type` can be omitted
                            for instalment terms, if the fields period and number_of_instalments
                            are populated. It is recommended that that clients always
                            provide a type value.
                        discriminator:
                            mapping:
                                INSTALMENTS: '#/components/schemas/OrderInstalmentTerms'
                                NET_TERMS: '#/components/schemas/OrderNetTerms'
                            propertyName: type
                        oneOf:
                        -   $ref: '#/components/schemas/OrderInstalmentTerms'
                        -   $ref: '#/components/schemas/OrderNetTerms'
                    -   type: 'null'
                    default: null
                    description: The terms of this order
                    title: Terms
                credit_line_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: ID of the credit line used to fund the order, created
                        through the Two Credit Line API.
                    title: Credit Line Id
            required:
            - gross_amount
            - currency
            - line_items
            - buyer
            title: CreateOrderIntentRequestSchema
            type: object
        BarCodeSchema:
            properties:
                value:
                    description: The identifier as a string
                    title: Value
                    type: string
                type:
                    description: Type of the identifier. Can be either "SKU" or a
                        Global Trade Item Number (GTIN) type like "UPC", "EAN", "GS1".
                    title: Type
                    type: string
            required:
            - value
            - type
            title: BarCodeSchema
            type: object
        BuyerSchemaForOrderIntentCreation:
            description: |-
                A schema for specifying the buyer in an order intent. The user is encouraged to specify the buyer's company
                using CompanyCanonicalIdSchema for unambiguous identification.
            properties:
                representative:
                    anyOf:
                    -   $ref: '#/components/schemas/LaxRepresentativeSchema'
                    -   additionalProperties: true
                        type: object
                    -   type: 'null'
                    default: null
                    description: Fields to capture who the order is for
                    title: Representative
                company:
                    description: Fields to capture the details of the company for
                        which the order is intended. Users are encouraged to assign
                        a CompanyFromCanonicalIdRequestSchema instance to this field
                        using a canonical id retrieved from our company search API.
                    oneOf:
                    -   $ref: '#/components/schemas/CompanyCanonicalIdSchema'
                    -   $ref: '#/components/schemas/CompanySchema'
                    -   type: 'null'
                    title: Company
            required:
            - company
            title: BuyerSchemaForOrderIntentCreation
            type: object
        CompanyCanonicalIdSchema:
            additionalProperties: false
            description: |-
                A schema that represents a company only by its canonical ID.
                Intended for use in requests to our API to create order intents and orders.
                Use the Two Company Search API to retrieve the canonical_id for a company.

                IMPORTANT: This schema forbids extra fields to prevent silent data loss.
                If additional company fields are provided, use CompanySchema instead.
            properties:
                company_canonical_id:
                    description: Unique canonical ID representing this company. Retrieve
                        this from the Two Company Search API.
                    examples:
                    - abc123def456
                    - ST987xyz
                    pattern: ^[a-zA-Z0-9]+$
                    title: Company Canonical Id
                    type: string
            required:
            - company_canonical_id
            title: CompanyCanonicalIdSchema
            type: object
        CompanySchema:
            description: |-
                Standard company schema with required fields for full company identification.
                Extends NonStrictCompanySchema and makes key fields required.
            properties:
                id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: Internal company Id
                    title: Id
                country_prefix:
                    $ref: '#/components/schemas/CountryCodeEnum'
                    description: Country code in ISO 3166-1 alpha-2 format
                    examples:
                    - GB
                organization_number:
                    description: National id of the buyer company
                    title: Organization Number
                    type: string
                company_name:
                    default: null
                    description: Legal name of the buyer company
                    maxLength: 255
                    minLength: 1
                    title: Company Name
                    type: string
                company_type:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Type of company placing the order
                    title: Company Type
                company_canonical_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Unique canonical ID representing this company
                    title: Company Canonical Id
                website:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Company's website
                    examples:
                    - https://www.example.com/
                    title: Website
            required:
            - country_prefix
            - organization_number
            title: CompanySchema
            type: object
        CountryCodeEnum:
            enum:
            - AD
            - AE
            - AL
            - AM
            - AO
            - AR
            - AT
            - AU
            - AZ
            - BA
            - BB
            - BD
            - BE
            - BF
            - BG
            - BH
            - BI
            - BJ
            - BN
            - BO
            - BR
            - BS
            - BW
            - CA
            - CG
            - CH
            - CL
            - CM
            - CO
            - CR
            - CY
            - CZ
            - DE
            - DJ
            - DK
            - DO
            - DZ
            - EC
            - EE
            - EG
            - ES
            - ET
            - FI
            - FJ
            - FR
            - GA
            - GB
            - GE
            - GH
            - GN
            - GQ
            - GR
            - GT
            - GY
            - HN
            - HR
            - HT
            - HU
            - ID
            - IE
            - IL
            - IN
            - IQ
            - IS
            - IT
            - JM
            - JO
            - JP
            - KE
            - KG
            - KH
            - KR
            - KW
            - KZ
            - LA
            - LB
            - LI
            - LK
            - LT
            - LU
            - LV
            - LR
            - MA
            - MC
            - MD
            - ME
            - MG
            - MK
            - MN
            - MR
            - MT
            - MU
            - MV
            - MW
            - MX
            - MY
            - MZ
            - NA
            - NE
            - NG
            - NL
            - 'NO'
            - NP
            - NZ
            - OM
            - PA
            - PE
            - PG
            - PH
            - PK
            - PL
            - PT
            - PY
            - QA
            - RO
            - RS
            - RW
            - SA
            - SE
            - SG
            - SI
            - SK
            - SL
            - SN
            - SR
            - SV
            - SZ
            - TD
            - TG
            - TH
            - TJ
            - TM
            - TN
            - TR
            - TT
            - TZ
            - UA
            - UG
            - US
            - UY
            - UZ
            - VN
            - ZA
            - ZM
            title: CountryCodeEnum
            type: string
        CreateAddressRequestSchema:
            properties:
                organization_name:
                    title: Organization Name
                    type: string
                street_address:
                    maxLength: 255
                    title: Street Address
                    type: string
                country:
                    $ref: '#/components/schemas/CountryCodeEnum'
                postal_code:
                    title: Postal Code
                    type: string
                city:
                    title: City
                    type: string
                region:
                    default: ''
                    title: Region
                    type: string
            required:
            - organization_name
            - street_address
            - country
            - postal_code
            - city
            title: CreateAddressRequestSchema
            type: object
        DueDateCalculationScheme:
            description: |-
                Scheme for calculating invoice due dates for orders.
                When set, modifies the due_in_days calculation based on the scheme type.
            enum:
            - END_OF_MONTH
            - END_OF_WEEK
            title: DueDateCalculationScheme
            type: string
        InvoiceTypeEnum:
            description: Enumeration for invoice type.
            enum:
            - FUNDED_INVOICE
            - DIRECT_INVOICE
            - CARD
            title: InvoiceTypeEnum
            type: string
        LaxRepBuyerSchema:
            description: |-
                A buyer schema variant used for creating order intents. It allows for an optional
                and less-strict `representative` (`LaxRepresentativeSchema`).
                The company can be identified by full details (`CompanySchema`) or by `company_canonical_id`
                (`CompanyFromCanonicalIdSchema`).
            properties:
                representative:
                    anyOf:
                    -   $ref: '#/components/schemas/LaxRepresentativeSchema'
                    -   type: 'null'
                    default: null
                    description: Fields to capture who the order is for
                company:
                    $ref: '#/components/schemas/CompanySchema'
                    description: Fields to capture the details of the company for
                        which the order is intended
            required:
            - company
            title: LaxRepBuyerSchema
            type: object
        LaxRepresentativeSchema:
            description: |-
                Relaxes validation on the representative's phone number by accepting a plain string
                instead of enforcing the strict `PhoneNumberType` validation.
            properties:
                first_name:
                    description: Representative first name
                    examples:
                    - John
                    title: First Name
                    type: string
                last_name:
                    description: Representative last name
                    examples:
                    - Doe
                    title: Last Name
                    type: string
                phone_number:
                    description: Representative phone number
                    examples:
                    - 07807039055
                    - '+447807039055'
                    title: Phone Number
                    type: string
                email:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Representative email address
                    examples:
                    - johndoe0112358@gmail.com
                    title: Email
            required:
            - first_name
            - last_name
            - phone_number
            title: LaxRepresentativeSchema
            type: object
        LineItemRequestSchema:
            properties:
                name:
                    description: Short name of the product
                    title: Name
                    type: string
                description:
                    description: Longer product description
                    title: Description
                    type: string
                line_item_reference:
                    anyOf:
                    -   minLength: 1
                        pattern: ^[0-9A-Za-z_-]*$
                        type: string
                    -   type: 'null'
                    default: null
                    description: Your line item reference
                    title: Line Item Reference
                discount_amount:
                    default: '0.00'
                    description: Discount applied to line item (defaults to 0.0),
                        excluded tax
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Discount Amount
                    type: string
                gross_amount:
                    description: net_amount + tax_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Gross Amount
                    type: string
                net_amount:
                    description: (quantity * unit_price) - discount_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Net Amount
                    type: string
                quantity:
                    description: Number of units for the specific line item (up to
                        8 decimal places)
                    examples:
                    - '1'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,8})?
                    title: Quantity
                    type: string
                unit_price:
                    description: The price of one unit excluding tax and discount
                        (up to 6 decimal places)
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Unit Price
                    type: string
                tax_amount:
                    description: net_amount * tax_rate
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                tax_rate:
                    description: Tax rate on the line item level
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Tax Rate
                    type: string
                tax_class_name:
                    description: A description of the tax class (e.g. 'VAT 20%')
                    examples:
                    - VAT 0%
                    title: Tax Class Name
                    type: string
                quantity_unit:
                    description: Unit like kg, l, pcs, etc.
                    examples:
                    - pcs
                    title: Quantity Unit
                    type: string
                image_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to the image of the product.
                    title: Image Url
                product_page_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to the store product page.
                    title: Product Page Url
                type:
                    $ref: '#/components/schemas/LineItemTypeEnum'
                    description: Product type.
                    examples:
                    - PHYSICAL
                details:
                    anyOf:
                    -   $ref: '#/components/schemas/ProductDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Meta-information and identifiers for the line item.
                prototype_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: Prototype id
                    title: Prototype Id
                vendor_name:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    description: Vendor for line item
                    title: Vendor Name
                merchant_child_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: In the case that the order created with Two is used
                        to cover multiple orders on the merchant's side, this field
                        could be referencing the merchant order that each line item
                        originates from. This is analogous to how the merchant_order_id
                        on the order itself can be used to map a Two order one-to-one
                        with a merchant order. Depending on your configuration with
                        Two, line items may be grouped by this value in the resulting
                        invoice and the value may be rendered as a reference for each
                        group of line items. In marketplace situations (multiple sub-vendors),
                        this is typically combined with the vendor_name field on the
                        line item, to indicate a vendor per child order.
                    title: Merchant Child Order Id
            required:
            - name
            - description
            - gross_amount
            - net_amount
            - quantity
            - unit_price
            - tax_amount
            - tax_rate
            - tax_class_name
            - quantity_unit
            - type
            title: LineItemRequestSchema
            type: object
        LineItemTypeEnum:
            enum:
            - DIGITAL
            - PHYSICAL
            - SHIPPING_FEE
            - GIFTCARD
            - SERVICE
            - BUYER_FEE
            - OTHER
            title: LineItemTypeEnum
            type: string
        OrderInstalmentTerms:
            description: By setting these fields, a merchant can create an instalment
                order with the specified terms.
            properties:
                type:
                    const: INSTALMENTS
                    default: INSTALMENTS
                    title: Type
                    type: string
                period:
                    $ref: '#/components/schemas/TermsPeriod'
                    description: The period of the instalment order.
                    examples:
                    - MONTHLY
                number_of_instalments:
                    description: The number of instalments the order will be split
                        into.
                    examples:
                    - 3
                    exclusiveMinimum: 1
                    title: Number Of Instalments
                    type: integer
            required:
            - period
            - number_of_instalments
            title: OrderInstalmentTerms
            type: object
        OrderNetTerms:
            description: By setting these fields, a merchant can create an net terms
                order with specified terms.
            properties:
                type:
                    const: NET_TERMS
                    default: NET_TERMS
                    title: Type
                    type: string
                duration_days:
                    examples:
                    - 60
                    exclusiveMinimum: 0
                    title: Duration Days
                    type: integer
                duration_days_calculated_from:
                    anyOf:
                    -   $ref: '#/components/schemas/DueDateCalculationScheme'
                    -   type: 'null'
                    default: null
                    description: |-
                        Optional scheme for calculating the invoice due date. When set, modifies how due_in_days is calculated from the fulfillment date:
                        - END_OF_MONTH: (days to end of month) + duration_days
                        - END_OF_WEEK: (days to end of week, Sunday) + duration_days
                        Note: Cannot be used with billing_account_id. Only specific duration_days values are allowed per scheme (typically 30, 45, 60).
                    examples:
                    - END_OF_MONTH
            required:
            - duration_days
            title: OrderNetTerms
            type: object
        OrderOriginationEnum:
            enum:
            - ONLINE
            - IN_STORE
            title: OrderOriginationEnum
            type: string
        ProductDetailsSchema:
            properties:
                brand:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The brand name of the item. E.g. "Heinz".
                    title: Brand
                categories:
                    description: Array of one or more product categories. E.g. ["Studio
                        monitors", "Music equipment"]
                    items:
                        type: string
                    title: Categories
                    type: array
                barcodes:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/BarCodeSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: Array with Barcode objects for storing SKU, EAN,
                        etc.
                    title: Barcodes
                part_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The manufacturer's part number
                    title: Part Number
            required:
            - categories
            title: ProductDetailsSchema
            type: object
        SuperLaxRepBuyerSchema:
            description: |-
                Intended for use in create order intent request where the buyer might
                send order intent with invalid representative data but it is okay for us to
                ignore that entry and process the intent anyway.
            properties:
                representative:
                    anyOf:
                    -   additionalProperties: true
                        type: object
                    -   type: 'null'
                    default: null
                    description: Fields to capture who the order is for
                    title: Representative
                company:
                    $ref: '#/components/schemas/CompanySchema'
                    description: Fields to capture the details of the company for
                        which the order is intended
            required:
            - company
            title: SuperLaxRepBuyerSchema
            type: object
        TermsPeriod:
            enum:
            - MONTHLY
            title: TermsPeriod
            type: string
        OrderIntentResponseSchema:
            examples:
            -   approved: true
                buyer:
                    company:
                        company_name: TWO B2B LTD
                        company_type: ''
                        country_prefix: GB
                        organization_number: '13078389'
                        website: null
                    representative:
                        email: john.doe@twob2bltd.com
                        first_name: John
                        last_name: Doe
                        phone_number: '+447516498321'
                currency: GBP
                decline_reason: null
                gross_amount: '120.00'
                id: 5af5a991-8822-4b61-b892-2ffdd2931fba
                invoice_type: FUNDED_INVOICE
                line_items:
                -   description: Blue whale poster
                    details:
                        barcodes:
                        -   type: SKU
                            value: 5954d9e0-ebfb-4498-86a9-3141e8942dc8
                        -   type: UPC
                            value: cece4007-028c-469c-b0d2-2c038b583b69
                        brand: Whale Posters INC
                        categories:
                        - Home
                        - Art
                        part_number: n/a
                    discount_amount: '0.00'
                    gross_amount: '120.00'
                    id: c5f65af4-3fdc-4c46-aa4e-8378b4ba0558
                    image_url: https://www.exampleobjects.com/product-image-800x600
                    line_item_reference: null
                    name: Whale poster
                    net_amount: '100.00'
                    product_page_url: https://www.example.com/products/7e34f2a8d
                    prototype_id: null
                    quantity: 1.0
                    quantity_unit: pcs
                    tax_amount: '20.00'
                    tax_class_name: VAT 20%
                    tax_rate: '0.200000'
                    type: PHYSICAL
                    unit_price: '100.00'
                merchant_id: 32d8eb3f-8ac3-4aca-82b9-dbbd6f416cfb
                merchant_short_name: tillittestuk
                order_origination: ONLINE
                tracking_id: 3987eb99-f726-436a-aed1-1c77a1ceb667
            properties:
                id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: A globally unique ID set by Two.
                    title: Id
                gross_amount:
                    description: net_amount + tax_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Gross Amount
                    type: string
                net_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: gross_amount - tax_amount
                    examples:
                    - 100.00 - 20% = 80.00
                    title: Net Amount
                tax_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: net_amount * tax_rate
                    examples:
                    - '20.00'
                    title: Tax Amount
                invoice_type:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceTypeEnum'
                    -   type: 'null'
                    default: null
                    description: 'FUNDED_INVOICE: Two will handle the invoice and
                        transfer the funds to the merchant as per the factoring agreement.
                        The invoice_details field will be populated by Two. DIRECT_INVOICE:
                        Two generates and sends the invoice to the customer based
                        on the bank account provided by the merchant, but the merchant
                        takes the full credit and fraud risk on direct invoices and
                        they will not receive a payout.'
                    examples:
                    - FUNDED_INVOICE
                currency:
                    description: Currency code in ISO 4217 format. E.g. 'NOK'
                    examples:
                    - GBP
                    title: Currency
                    type: string
                line_items:
                    description: List of the line items that constitute the order
                    items:
                        $ref: '#/components/schemas/LineItemResponseSchema'
                    title: Line Items
                    type: array
                buyer:
                    $ref: '#/components/schemas/BuyerSchema'
                    description: Fields representing the buyer
                approved:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: Credit decision for the order intent
                    title: Approved
                decline_reason:
                    anyOf:
                    -   $ref: '#/components/schemas/DeclineReasonEnum'
                    -   type: 'null'
                    default: null
                    description: Reason for order being declined
                recourse_decision_reason:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reason for recourse decision
                    title: Recourse Decision Reason
                merchant_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: A globally unique merchant ID set by Two.
                    title: Merchant Id
                merchant_short_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Merchant's short name
                    title: Merchant Short Name
                shipping_address:
                    anyOf:
                    -   $ref: '#/components/schemas/AddressResponseSchema'
                    -   type: 'null'
                    default: null
                    description: Order shipping address
                tracking_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional order intent tracking id
                    title: Tracking Id
                order_origination:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderOriginationEnum'
                    -   type: 'null'
                    default: null
                    description: IN_STORE orders are not enabled by default. Please
                        reach out to us if you would like to discuss IN_STORE orders.
                    examples:
                    - ONLINE
                approved_on_recourse:
                    description: If the intent is approved, indicates whether it is
                        approved on recourse
                    title: Approved On Recourse
                    type: boolean
                approved_with_conditions:
                    description: Order approved pending conditions that the user must
                        satisfy during the verification journey
                    examples:
                    -   description: During verification the buyer will be asked to
                            share business bank account data using open banking
                        value: OPEN_BANKING_DATA
                    -   description: During verification the buyer will be asked to
                            consent to credit check, consent will trigger a credit
                            check
                        value: CREDIT_CHECK_CONSENT
                    items:
                        $ref: '#/components/schemas/ApprovalConditionEnum'
                    title: Approved With Conditions
                    type: array
                terms:
                    anyOf:
                    -   description: For backwards compatibility, `type` can be omitted
                            for instalment terms, if the fields period and number_of_instalments
                            are populated. It is recommended that that clients always
                            provide a type value.
                        discriminator:
                            mapping:
                                INSTALMENTS: '#/components/schemas/OrderInstalmentTerms'
                                NET_TERMS: '#/components/schemas/OrderNetTerms'
                            propertyName: type
                        oneOf:
                        -   $ref: '#/components/schemas/OrderInstalmentTerms'
                        -   $ref: '#/components/schemas/OrderNetTerms'
                    -   type: 'null'
                    default: null
                    description: The terms of this order
                    title: Terms
            required:
            - gross_amount
            - currency
            - line_items
            - buyer
            - approved_on_recourse
            - approved_with_conditions
            title: OrderIntentResponseSchema
            type: object
        AddressResponseSchema:
            properties:
                id:
                    title: Id
                    type: string
                organization_name:
                    title: Organization Name
                    type: string
                street_address:
                    title: Street Address
                    type: string
                postal_code:
                    title: Postal Code
                    type: string
                city:
                    title: City
                    type: string
                region:
                    title: Region
                    type: string
                country:
                    $ref: '#/components/schemas/CountryCodeEnum'
                preferred:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    title: Preferred
            required:
            - id
            - organization_name
            - street_address
            - postal_code
            - city
            - region
            - country
            title: AddressResponseSchema
            type: object
        ApprovalConditionEnum:
            enum:
            - OPEN_BANKING_DATA
            - CREDIT_CHECK_CONSENT
            title: ApprovalConditionEnum
            type: string
        BuyerSchema:
            properties:
                representative:
                    anyOf:
                    -   $ref: '#/components/schemas/RepresentativeSchema'
                    -   type: 'null'
                    default: null
                    description: Fields to capture who the order is for
                company:
                    $ref: '#/components/schemas/CompanySchema'
                    description: Fields to capture the details of the company for
                        which the order is intended
            required:
            - company
            title: BuyerSchema
            type: object
        DeclineReasonEnum:
            enum:
            - TOO_HIGH_RISK
            - BUYER_LIMIT_EXCEEDED
            - BUYER_NOT_FOUND
            - BUYER_ADDRESS_DEVIATION
            - BUYER_INFO_INCONSISTENT
            - BUYER_AUTHENTICATION_FAILED
            - FRAUD_CHECK_NOT_PASSED
            - CREDIT_CHECK_FAILED
            - EXCEPTION
            - SERVICE_UNAVAILABLE
            - BUYER_IN_ARREARS
            - DECLINED_IN_VERIFICATION
            - UNDEFINED
            - INVALID_LEGAL_REP
            - ORDER_EXCEEDS_MAX_INVOICE_AMOUNT
            - SE_SOLE_TRADER
            - INVALID_ORDER_DATA
            - INVALID_ORDER_DATA_TOTAL_AMOUNT_MISMATCH
            - INVALID_ORDER_LINE_ITEM_DATA_AMOUNT_MISMATCH
            - MERCHANT_LIMIT_EXCEEDED
            - ORDER_BELOW_MIN_INVOICE_AMOUNT
            - ORDER_EXCEEDS_MIN_INVOICE_AMOUNT
            - BUYER_NOT_SUPPORTED
            - BUYER_IS_BLOCKED
            - NO_BUSINESS_ACCOUNT
            - MERCHANT_NOT_ON_RECOURSE
            - COMPANY_CREDIT_REPORT_CONSENT_REQUIRED
            - NO_LEGAL_REPRESENTATIVES
            - CREDIT_REPORT_BLOCKED
            - ORDER_EXCEEDS_REGIONAL_LIMIT
            title: DeclineReasonEnum
            type: string
        LineItemResponseSchema:
            properties:
                id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: A globally unique ID set by Two.
                    title: Id
                name:
                    description: short name of the product
                    title: Name
                    type: string
                description:
                    description: Longer product description
                    title: Description
                    type: string
                line_item_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Your line item reference
                    title: Line Item Reference
                discount_amount:
                    default: '0.00'
                    description: Discount applied to line item (defaults to 0.0),
                        excluded tax
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Discount Amount
                    type: string
                gross_amount:
                    description: net_amount + tax_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Gross Amount
                    type: string
                net_amount:
                    description: (quantity * unit_price) - discount_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Net Amount
                    type: string
                quantity:
                    description: Number of units for the specific line item (up to
                        8 decimal places)
                    examples:
                    - '1'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,8})?
                    title: Quantity
                    type: string
                unit_price:
                    description: The price of one unit excluding tax and discount
                        (up to 6 decimal places)
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Unit Price
                    type: string
                tax_amount:
                    description: net_amount * tax_rate
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                tax_rate:
                    description: Tax rate on the line item level
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Tax Rate
                    type: string
                tax_class_name:
                    description: A description of the tax class (e.g. 'VAT 20%')
                    examples:
                    - VAT 0%
                    title: Tax Class Name
                    type: string
                quantity_unit:
                    description: Unit like kg, l, pcs, etc.
                    examples:
                    - pcs
                    title: Quantity Unit
                    type: string
                image_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to the image of the product.
                    title: Image Url
                product_page_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to the store product page.
                    title: Product Page Url
                type:
                    $ref: '#/components/schemas/LineItemTypeEnum'
                    description: Product type.
                    examples:
                    - PHYSICAL
                details:
                    anyOf:
                    -   $ref: '#/components/schemas/ProductDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Meta-information and identifiers for the line item.
                prototype_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: Prototype id
                    title: Prototype Id
                vendor_name:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    description: Vendor for line item
                    title: Vendor Name
                merchant_child_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: In the case that the order created with Two is used
                        to cover multiple orders on the merchant's side, this field
                        could be referencing the merchant order that each line item
                        originates from. This is analogous to how the merchant_order_id
                        on the order itself can be used to map a Two order one-to-one
                        with a merchant order. Depending on your configuration with
                        Two, line items may be grouped by this value in the resulting
                        invoice and the value may be rendered as a reference for each
                        group of line items. In marketplace situations (multiple sub-vendors),
                        this is typically combined with the vendor_name field on the
                        line item, to indicate a vendor per child order.
                    title: Merchant Child Order Id
            required:
            - name
            - description
            - gross_amount
            - net_amount
            - quantity
            - unit_price
            - tax_amount
            - tax_rate
            - tax_class_name
            - quantity_unit
            - type
            title: LineItemResponseSchema
            type: object
        RepresentativeSchema:
            properties:
                first_name:
                    description: Representative first name
                    examples:
                    - John
                    title: First Name
                    type: string
                last_name:
                    description: Representative last name
                    examples:
                    - Doe
                    title: Last Name
                    type: string
                phone_number:
                    description: Representative phone number. If the calling code
                        is not provided, it automatically uses the calling code of
                        the enum `country_prefix` in CompanySchema. However, you can
                        also specify the calling code explicitly if it's for a different
                        country. For instance, if the given phone number is 07807039055
                        and the buyer's `country_prefix` in CompanySchema is `GB`,
                        the phone number is automatically converted to +447807039055.
                        If the `country_prefix` in CompanySchema is `NO`, you can
                        explicitly define a phone number for another country as +447807039055.
                    examples:
                    - 07807039055
                    - '+447807039055'
                    title: Phone Number
                    type: string
                email:
                    anyOf:
                    -   format: email
                        type: string
                    -   type: 'null'
                    default: null
                    description: Representative email address
                    examples:
                    - johndoe0112358@gmail.com
                    title: Email
            required:
            - first_name
            - last_name
            - phone_number
            title: RepresentativeSchema
            type: object
        CreateOrderRequestSchema:
            example:
                billing_address:
                    city: Menlo Park
                    country: GB
                    organization_name: TWO B2B LTD
                    postal_code: SW17 8BY
                    references:
                        attn: yo
                        co: Company CEO
                        reference: Firs floor office
                    region: GB
                    street_address: 1 Hacker Way
                buyer:
                    company:
                        company_name: TWO B2B LTD
                        country_prefix: GB
                        organization_number: '13078389'
                    representative:
                        email: john.doe@twob2bltd.com
                        first_name: John
                        last_name: Doe
                        phone_number: '+447516498321'
                currency: GBP
                discount_amount: '0'
                discount_rate: '0'
                gross_amount: '120.00'
                line_items:
                -   description: Blue whale poster
                    details:
                        barcodes:
                        -   type: SKU
                            value: YOUR_BARCODE_VALUE
                        -   type: UPC
                            value: YOUR_BARCODE_VALUE
                        brand: Whale Posters INC
                        categories:
                        - YOUR_CATEGORY_A
                        - YOUR_CATEGORY_B
                        part_number: MANUFACTURER_PART_NUMBER
                    discount_amount: '0'
                    gross_amount: '120.00'
                    image_url: https://www.exampleobjects.com/product-image-800x600
                    line_item_reference: YOUR_LINE_ITEM_REFERENCE
                    name: Whale poster
                    net_amount: '100.00'
                    product_page_url: https://www.example.com/products/######
                    quantity: 1.0
                    quantity_unit: pcs
                    tax_amount: '20.00'
                    tax_class_name: VAT 20%
                    tax_rate: '0.20'
                    type: PHYSICAL
                    unit_price: '100'
                merchant_additional_info: Additional line item information
                merchant_order_id: YOUR_MERCHANT_ORDER_ID
                merchant_reference: YOUR_MERCHANT_REFERENCE
                merchant_urls:
                    merchant_cancel_order_url: YOUR_MERCHANT_URL/cancel-order
                    merchant_confirmation_url: YOUR_MERCHANT_URL/confimation
                    merchant_edit_order_url: YOUR_MERCHANT_URL/edit-order
                    merchant_invoice_url: YOUR_MERCHANT_URL/invoice
                    merchant_order_verification_failed_url: YOUR_MERCHANT_URL/order-verification-failed
                    merchant_order_verification_pending_url: YOUR_MERCHANT_URL/pending-order
                    merchant_shipping_document_url: YOUR_MERCHANT_URL/shipping-document
                net_amount: '100.00'
                order_intent_id: ORDER_INTENT_TRACKING_ID
                shipping_address:
                    city: Menlo Park
                    country: GB
                    organization_name: TWO B2B LTD
                    postal_code: SW17 8BY
                    references:
                        attn: The receptionist
                        co: Company CEO
                        reference: First floor office
                    region: GB
                    street_address: 1 Hacker Way
                shipping_details:
                    carrier_name: Example carrier
                    carrier_tracking_url: https://example.com/tracking-url/
                    expected_delivery_date: '2026-01-08'
                    tracking_number: SHIPPING_TRACKING_NUMBER
                tax_amount: '20.00'
            properties:
                gross_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: net_amount + tax_amount
                    examples:
                    - '100'
                    title: Gross Amount
                net_amount:
                    description: Total before tax — sum of all line items excluding
                        tax.
                    examples:
                    - '100'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Net Amount
                    type: string
                currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: Currency code in ISO 4217 format. E.g. 'NOK'
                    examples:
                    - GBP
                discount_amount:
                    default: '0.00'
                    deprecated: true
                    description: Deprecated, discount amount is only applicable at
                        line item level
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Discount Amount
                    type: string
                discount_rate:
                    default: '0.000000'
                    deprecated: true
                    description: Deprecated, discount rate is only applicable at line
                        item level
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Discount Rate
                    type: string
                tax_amount:
                    description: Total tax (e.g. VAT) applied to the order.
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                buyer_department:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Department the purchase is to be registered on
                    title: Buyer Department
                buyer_project:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Project the purchase is to be registered on
                    title: Buyer Project
                buyer_purchase_order_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Purchase order number to attribute to the order
                    title: Buyer Purchase Order Number
                buyer_reference:
                    anyOf:
                    -   maxLength: 140
                        type: string
                    -   type: 'null'
                    default: null
                    description: 'General buyer reference field for information that
                        is not covered by the specific reference fields, e.g. PO-number.
                        Note: Maximum 140 characters'
                    title: Buyer Reference
                buyer_vat_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Vat number associated with the buyer company
                    title: Buyer Vat Number
                line_items:
                    description: List of the line items that constitute the order
                    items:
                        $ref: '#/components/schemas/LineItemRequestSchema'
                    title: Line Items
                    type: array
                merchant_order_id:
                    description: Your order ID to register against the order
                    title: Merchant Order Id
                    type: string
                merchant_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Field set by merchant for adding a reference to be
                        used internally by the merchant. Does not appear on invoice.
                    title: Merchant Reference
                branding_merchant_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: MerchantInvoiceBranding merchant reference.
                    title: Branding Merchant Reference
                merchant_additional_info:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Additional info the merchant can connect to the order
                    title: Merchant Additional Info
                invoice_details:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceDetailsRequestSchema'
                    -   type: 'null'
                    default: null
                    description: Invoice details are provided by the merchant via
                        Merchant Portal when invoice_type is DIRECT_INVOICE, Two Bank
                        or a 3rd-party bank when invoice_type is FUNDED_INVOICE and
                        empty when invoice_type is CARD.
                merchant_short_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: Deprecated. Use merchant_id where possible.
                    title: Merchant Short Name
                shipping_details:
                    anyOf:
                    -   $ref: '#/components/schemas/ShippingDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Shipping details including carrier information and
                        delivery method. For merchants offering multiple fulfillment
                        options, the `delivery_method` field is needed for order validation
                        and processing workflow purposes.
                order_note:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: General note/message from the buyer to the merchant
                    title: Order Note
                billing_address:
                    anyOf:
                    -   $ref: '#/components/schemas/CreateAddressRequestSchema'
                    -   type: 'null'
                    default: null
                    description: Order billing address
                shipping_address:
                    anyOf:
                    -   $ref: '#/components/schemas/CreateAddressRequestSchema'
                    -   type: 'null'
                    default: null
                    description: Order shipping address
                tax_subtotals:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/TaxSubtotalSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of tax subtotals for unique tax brackets
                    title: Tax Subtotals
                terms:
                    anyOf:
                    -   description: For backwards compatibility, `type` can be omitted
                            for instalment terms, if the fields period and number_of_instalments
                            are populated. It is recommended that that clients always
                            provide a type value.
                        discriminator:
                            mapping:
                                INSTALMENTS: '#/components/schemas/OrderInstalmentTerms'
                                NET_TERMS: '#/components/schemas/OrderNetTerms'
                            propertyName: type
                        oneOf:
                        -   $ref: '#/components/schemas/OrderInstalmentTerms'
                        -   $ref: '#/components/schemas/OrderNetTerms'
                    -   type: 'null'
                    default: null
                    description: If set, the order will be placed with the specified
                        terms. This is in beta and only open for limited users. Please
                        contact us if you would like to integrate with this feature.
                        It cannot be used with invoice_details.due_date, invoice_details.due_in_days
                        and invoice_details.invoice_issue_date.
                    title: Terms
                merchant_invoice_branding_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: ID of the merchant's invoice branding configuration
                    title: Merchant Invoice Branding Id
                merchant_invoice_store_branding_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: ID of the merchant's store-specific invoice branding
                        configuration
                    title: Merchant Invoice Store Branding Id
                order_placed_date:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Date order was placed (UTC). If not specified, defaults
                        to current timestamp.
                    examples:
                    - '2026-01-01 14:02:02.002222'
                    title: Order Placed Date
                order_type:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderTypeEnum'
                    -   type: 'null'
                    default: null
                    description: Type of order (Buyer or Merchant initiated)
                    examples:
                    - BUYER_INITIATED
                sale_country_code:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional sale country code (ISO 3166 Alpha-2) to
                        use for this order, if null defaults to buyer country code.
                    examples:
                    - GB
                    title: Sale Country Code
                merchant_payout_account_alias:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional payee account alias account identifier for
                        multiple accounts setup.
                    title: Merchant Payout Account Alias
                recurring:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: If set to true, an invoice will be generated periodically
                        according to the specification provided in recurring_details
                    examples:
                    - false
                    title: Recurring
                merchant_invoice_branding_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reference to merchant's invoice branding configuration
                    title: Merchant Invoice Branding Reference
                merchant_invoice_store_branding_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reference to merchant's store-specific invoice branding
                        configuration
                    title: Merchant Invoice Store Branding Reference
                buyer:
                    anyOf:
                    -   $ref: '#/components/schemas/NonStrictBuyerSchema'
                    -   type: 'null'
                    default: null
                    description: Fields representing the buyer
                electronic_invoice_recipient:
                    anyOf:
                    -   $ref: '#/components/schemas/ElectronicInvoiceRecipient'
                    -   type: 'null'
                    default: null
                    description: electronic_invoice_recipient
                preferred_distribution_method:
                    anyOf:
                    -   $ref: '#/components/schemas/DistributionMethodEnum'
                    -   type: 'null'
                    default: null
                    description: Allows merchant to set the method of distribution
                        for the invoice and credit notes of the order, if not set
                        will default to all methods
                recurring_details:
                    anyOf:
                    -   $ref: '#/components/schemas/RecurringDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Currently not available
                merchant_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: A globally unique merchant ID set by Two.
                    title: Merchant Id
                merchant_urls:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderMerchantUrlsSchema'
                    -   type: 'null'
                    default: null
                    description: List of urls hosted by the merchant.
                order_origination:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderOriginationEnum'
                    -   type: 'null'
                    default: null
                    description: IN_STORE orders are not enabled by default. Please
                        reach out to us if you would like to discuss IN_STORE orders.
                tracking_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Tracking ID from `POST /order_intent`
                    title: Tracking Id
                vendor_name:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    description: This is an optional vendor name that is used to refer
                        to the seller in a marketplace setup.
                    title: Vendor Name
                vendor_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional vendor ID for your reference
                    title: Vendor Id
                merchant_user_id:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    description: Your internal ID of the user (the employee of your
                        business customer) registered for one-click purchase through
                        the Two Trade Account Onboarding API.
                    title: Merchant User Id
                billing_account_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: ID for the billing account linked to this order.
                        Do not pass terms when setting billing_account_id; billing
                        account payment terms take precedence. The billing account
                        buyer company must match the order buyer company. The billing
                        account must belong to the same merchant as the order. Cannot
                        be combined with INSTALMENTS terms or terms.duration_days_calculated_from.
                    title: Billing Account Id
                disallow_portal_mutation:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: If set to true, state-mutating actions (fulfill,
                        cancel, refund) cannot be performed on this order through
                        the merchant portal. Use this for orders managed by external
                        systems (ERPs, PSPs) that track order state via the API, to
                        prevent desynchronization.
                    title: Disallow Portal Mutation
                credit_line_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: ID of the credit line used to fund the order, created
                        through the Two Credit Line API.
                    title: Credit Line Id
            required:
            - billing_address
            - buyer
            - currency
            - gross_amount
            - line_items
            - merchant_order_id
            - net_amount
            - tax_amount
            - tax_subtotals
            title: CreateOrderRequestSchema
            type: object
        BankAccountSchema:
            properties:
                id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    title: Id
                bban:
                    anyOf:
                    -   maxLength: 30
                        minLength: 7
                        pattern: ^[0-9A-Za-z]*$
                        type: string
                    -   type: 'null'
                    default: null
                    title: Bban
                iban:
                    anyOf:
                    -   maxLength: 34
                        minLength: 15
                        pattern: ^[0-9A-Za-z]*$
                        type: string
                    -   type: 'null'
                    default: null
                    title: Iban
                bic:
                    anyOf:
                    -   maxLength: 12
                        minLength: 8
                        pattern: ^[0-9A-Za-z]*$
                        type: string
                    -   type: 'null'
                    default: null
                    title: Bic
                country_code:
                    anyOf:
                    -   $ref: '#/components/schemas/CountryCodeEnum'
                    -   type: 'null'
                    default: null
                branch_sort_code:
                    anyOf:
                    -   maxLength: 9
                        pattern: ^[0-9]*$
                        type: string
                    -   type: 'null'
                    default: null
                    title: Branch Sort Code
                local_account_number:
                    anyOf:
                    -   maxLength: 12
                        minLength: 8
                        pattern: ^[0-9]*$
                        type: string
                    -   type: 'null'
                    default: null
                    title: Local Account Number
                organization_name:
                    anyOf:
                    -   maxLength: 140
                        minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    title: Organization Name
                organization_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Organization Number
                description:
                    anyOf:
                    -   maxLength: 255
                        minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    title: Description
                kid_type:
                    anyOf:
                    -   $ref: '#/components/schemas/KidTypeEnum'
                    -   type: 'null'
                    default: null
            title: BankAccountSchema
            type: object
        CallbackAuthTypeEnum:
            enum:
            - BEARER
            title: CallbackAuthTypeEnum
            type: string
        CurrencyEnum:
            enum:
            - CHF
            - CZK
            - DKK
            - EUR
            - GBP
            - INR
            - MXN
            - NOK
            - PLN
            - RON
            - SEK
            - USD
            title: CurrencyEnum
            type: string
        DeliveryMethodEnum:
            description: Enum for types of shipping methods
            enum:
            - PICKUP_STORE
            - PICKUP_POINT
            - DELIVERED_TO_SHIPPING_ADDRESS
            - DELIVERED_DIGITALLY
            - EXPRESS_PICKUP_POINT
            - EXPRESS_SHIPPING_ADDRESS
            - OTHER
            title: DeliveryMethodEnum
            type: string
        DistributionMethodEnum:
            enum:
            - EMAIL
            - ELECTRONIC_INVOICE
            title: DistributionMethodEnum
            type: string
        ElectronicInvoiceRecipient:
            properties:
                id:
                    title: Id
                    type: string
                type:
                    $ref: '#/components/schemas/ElectronicInvoiceRecipientTypeEnum'
                operator_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Operator Id
            required:
            - id
            - type
            title: ElectronicInvoiceRecipient
            type: object
        ElectronicInvoiceRecipientTypeEnum:
            enum:
            - NO_ORGNUMBER
            - SE_ORGNUMBER
            - GLN
            - DK_ORGNUMBER
            - FI_ORGNUMBER
            - FINVOICE
            title: ElectronicInvoiceRecipientTypeEnum
            type: string
        InvoiceDetailsRequestSchema:
            examples:
            -   due_date: '2026-01-31'
                due_in_days: '30'
                invoice_number: string
                invoicing_group_id: string
                payee:
                    bban: string
                    bic: string
                    branch_sort_code: string
                    country_code: string
                    description: string
                    iban: string
                    local_account_number: string
                    organization_name: string
                    organization_number: string
                payment_reference: string
                payment_reference_message: string
                payment_reference_ocr: string
                payment_reference_type: string
            properties:
                payee:
                    anyOf:
                    -   $ref: '#/components/schemas/BankAccountSchema'
                    -   type: 'null'
                    default: null
                payment_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Payment Reference
                payment_reference_type:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Payment Reference Type
                payment_reference_message:
                    default: ''
                    description: Text that will be attached to the payment in order
                        for the merchant to reconcile the payment.
                    title: Payment Reference Message
                    type: string
                payment_reference_ocr:
                    default: ''
                    description: A string of numbers that will be attached to the
                        payment in order for the merchant to reconcile the payment.
                        E.g. "KID-nummer" in Norway.
                    title: Payment Reference Ocr
                    type: string
                payment_status:
                    anyOf:
                    -   $ref: '#/components/schemas/PaymentStatusEnum'
                    -   type: 'null'
                    default: null
                due_in_days:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: Please add terms to order instead, with type NET_TERMS
                        and duration_days
                    title: Due In Days
                invoice_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Number
                invoice_issue_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Issue Date
                due_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    title: Due Date
                invoice_emails:
                    anyOf:
                    -   items:
                            format: email
                            type: string
                        type: array
                    -   type: 'null'
                    default: null
                    description: We will send invoices to all of the email addresses.
                    title: Invoice Emails
            title: InvoiceDetailsRequestSchema
            type: object
        KidTypeEnum:
            enum:
            - MOD_10
            - MOD_11
            - NONE
            title: KidTypeEnum
            type: string
        NonStrictBuyerSchema:
            description: |-
                # The name is kept as NonStrictBuyerSchema for backward compatibility.
                Used only for the CreateOrderRequestSchema where validation rules might differ,
                for example when a `billing_account_id` or `merchant_customer_id` is passed.
                It allows the company to be identified by full details, canonical ID, or be omitted.
            properties:
                representative:
                    $ref: '#/components/schemas/StrictRepresentativeSchema'
                company:
                    default: null
                    description: Fields to capture the details of the company for
                        which the order is intended. Users are encouraged to assign
                        a CompanyFromCanonicalIdRequestSchema instance to this field
                        using a canonical id retrieved from our company search API.
                        This structure may be omitted entirely when creating an order,
                        if a billing account or trade account are referenced in the
                        order itself.
                    oneOf:
                    -   $ref: '#/components/schemas/CompanyCanonicalIdSchema'
                    -   $ref: '#/components/schemas/CompanySchema'
                    -   type: 'null'
                    title: Company
            required:
            - representative
            - company
            title: NonStrictBuyerSchema
            type: object
        OrderMerchantCallbackAuthSchema:
            properties:
                auth_type:
                    $ref: '#/components/schemas/CallbackAuthTypeEnum'
                value:
                    title: Value
                    type: string
            required:
            - auth_type
            - value
            title: OrderMerchantCallbackAuthSchema
            type: object
        OrderMerchantUrlsSchema:
            properties:
                merchant_confirmation_url:
                    description: URL to which you want to redirect your users upon
                        successful order verification.
                    title: Merchant Confirmation Url
                    type: string
                merchant_cancel_order_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: URL to which you want to redirect your users when
                        they cancel an order.
                    title: Merchant Cancel Order Url
                merchant_edit_order_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Merchant Edit Order Url
                merchant_order_verification_pending_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Merchant Order Verification Pending Url
                merchant_order_verification_failed_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Merchant Order Verification Failed Url
                merchant_invoice_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Merchant Invoice Url
                merchant_shipping_document_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Merchant Shipping Document Url
                merchant_document_urls:
                    anyOf:
                    -   items:
                            type: string
                        type: array
                    -   type: 'null'
                    default: null
                    title: Merchant Document Urls
                merchant_order_verified_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Merchant Order Verified Url
                merchant_order_callback_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Merchant Order Callback Url
                merchant_order_callback_auth:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderMerchantCallbackAuthSchema'
                    -   type: 'null'
                    default: null
            required:
            - merchant_confirmation_url
            title: OrderMerchantUrlsSchema
            type: object
        OrderTypeEnum:
            enum:
            - BUYER_INITIATED
            - MERCHANT_INITIATED
            title: OrderTypeEnum
            type: string
        PaymentStatusEnum:
            enum:
            - NOT_PAID
            - PAID
            - PARTIAL_PAYMENT
            - OVERDUE
            - IN_COLLECTIONS
            - CANCELLED
            - REFUNDED
            - PARTIAL_REFUND
            - RECOURSED
            - PARTIAL_RECOURSE
            title: PaymentStatusEnum
            type: string
        PeriodEnum:
            enum:
            - weekly
            - biweekly
            - monthly
            - bimonthly
            - quarterly
            - yearly
            title: PeriodEnum
            type: string
        RecurringDetailsSchema:
            properties:
                token:
                    title: Token
                    type: string
                description:
                    title: Description
                    type: string
                period:
                    $ref: '#/components/schemas/PeriodEnum'
            required:
            - token
            - description
            - period
            title: RecurringDetailsSchema
            type: object
        ShippingDetailsSchema:
            properties:
                tracking_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Tracking Number
                carrier_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Carrier Name
                carrier_tracking_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Carrier Tracking Url
                expected_delivery_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    title: Expected Delivery Date
                address_co:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Address Co
                address_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Address Reference
                address_attn:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Address Attn
                delivery_method:
                    anyOf:
                    -   $ref: '#/components/schemas/DeliveryMethodEnum'
                    -   type: 'null'
                    default: null
                id_required_on_delivery:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    title: Id Required On Delivery
            title: ShippingDetailsSchema
            type: object
        StrictRepresentativeSchema:
            properties:
                first_name:
                    description: Representative first name
                    examples:
                    - John
                    title: First Name
                    type: string
                last_name:
                    description: Representative last name
                    examples:
                    - Doe
                    title: Last Name
                    type: string
                phone_number:
                    description: Representative phone number. If the calling code
                        is not provided, it automatically uses the calling code of
                        the enum `country_prefix` in CompanySchema. However, you can
                        also specify the calling code explicitly if it's for a different
                        country. For instance, if the given phone number is 07807039055
                        and the buyer's `country_prefix` in CompanySchema is `GB`,
                        the phone number is automatically converted to +447807039055.
                        If the `country_prefix` in CompanySchema is `NO`, you can
                        explicitly define a phone number for another country as +447807039055.
                    examples:
                    - 07807039055
                    - '+447807039055'
                    title: Phone Number
                    type: string
                email:
                    description: Representative email address
                    examples:
                    - johndoe0112358@gmail.com
                    format: email
                    title: Email
                    type: string
            required:
            - first_name
            - last_name
            - phone_number
            - email
            title: StrictRepresentativeSchema
            type: object
        TaxSubtotalSchema:
            properties:
                tax_amount:
                    description: taxable_amount * tax rate
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                taxable_amount:
                    description: sum(net_amount), per tax rate
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Taxable Amount
                    type: string
                tax_rate:
                    description: Must be between 0 and 1 inclusive
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Tax Rate
                    type: string
            required:
            - tax_amount
            - taxable_amount
            - tax_rate
            title: TaxSubtotalSchema
            type: object
        OrderResponseSchema:
            example:
                billing_account_id: null
                billing_address:
                    city: Menlo Park
                    country: GB
                    id: cdb98f98-14c2-47b8-8b7c-87d8313ac6aa
                    organization_name: TWO B2B LTD
                    postal_code: SW17 8BY
                    preferred: null
                    region: GB
                    street_address: 1 Hacker Way
                buyer:
                    company:
                        company_name: TWO B2B LTD
                        company_type: ''
                        country_prefix: GB
                        organization_number: '13078389'
                        website: null
                    representative:
                        email: john.doe@twob2bltd.com
                        first_name: John
                        last_name: Doe
                        phone_number: '+447516498321'
                buyer_department: null
                buyer_project: null
                buyer_purchase_order_number: null
                buyer_reference: null
                credit_note_url: null
                currency: GBP
                date_created: '2026-01-01 14:02:02.002222'
                date_fulfilled: null
                date_updated: '2026-01-01 14:02:02.002222'
                decline_reason: null
                discount_amount: '0.00'
                discount_rate: '0.000000'
                elapsed_time_ms: null
                electronic_invoice_recipient: null
                event_log_url: https://tillit.ai
                external_order_id: null
                external_order_status: null
                fixed_fee: null
                gross_amount: '120.00'
                id: f36cfe22-5a46-4830-a8fa-0f2d7236e269
                invoice_details:
                    due_date: null
                    due_in_days: 14
                    id: a49d8790-306c-4d3e-830f-fbdc99676cf8
                    invoice_issue_date: null
                    invoice_number: null
                    payee: null
                    payment_reference: null
                    payment_reference_message: ''
                    payment_reference_ocr: ''
                    payment_reference_type: null
                    payment_status: null
                invoice_insurance_provider: NO_INSURANCE
                invoice_type: FUNDED_INVOICE
                invoice_url: null
                line_items:
                -   description: Blue whale poster
                    details:
                        barcodes:
                        -   type: SKU
                            value: YOUR_BARCODE_VALUE
                        -   type: UPC
                            value: YOUR_BARCODE_VALUE
                        brand: Whale Posters INC
                        categories:
                        - YOUR_CATEGORY_A
                        - YOUR_CATEGORY_B
                        part_number: MANUFACTURER_PART_NUMBER
                    discount_amount: '0.00'
                    gross_amount: '120.00'
                    id: 21d3fd7f-1e12-466a-bbbb-09ab38bfa869
                    image_url: https://www.exampleobjects.com/product-image-800x600
                    line_item_reference: YOUR_LINE_ITEM_REFERENCE
                    name: Whale poster
                    net_amount: '100.00'
                    product_page_url: https://www.example.com/products/######
                    prototype_id: null
                    quantity: 1.0
                    quantity_unit: pcs
                    tax_amount: '20.00'
                    tax_class_name: VAT 20%
                    tax_rate: '0.200000'
                    type: PHYSICAL
                    unit_price: '100.00'
                merchant_additional_info: Additional line item information
                merchant_id: 1115e2ea-f6d2-4129-930f-3657600555ba
                merchant_order_id: YOUR_MERCHANT_ORDER_ID
                merchant_payout_account_alias: null
                merchant_reference: YOUR_MERCHANT_REFERENCE
                merchant_short_name: tillit
                merchant_urls:
                    merchant_cancel_order_url: YOUR_MERCHANT_URL/cancel-order
                    merchant_confirmation_url: YOUR_MERCHANT_URL/confimation
                    merchant_document_urls: null
                    merchant_edit_order_url: YOUR_MERCHANT_URL/edit-order
                    merchant_invoice_url: YOUR_MERCHANT_URL/invoice
                    merchant_order_callback_auth: null
                    merchant_order_callback_url: null
                    merchant_order_verification_failed_url: YOUR_MERCHANT_URL/order-verification-failed
                    merchant_order_verification_pending_url: YOUR_MERCHANT_URL/pending-order
                    merchant_order_verified_url: null
                    merchant_shipping_document_url: YOUR_MERCHANT_URL/shipping-document
                net_amount: '100.00'
                order_note: null
                order_origination: ONLINE
                order_placed_date: '2026-01-01 14:02:02.002222'
                order_revision: null
                order_type: BUYER_INITIATED
                original_order_id: null
                parent_order_id: null
                payment_url: http://localhost:5000/order/f36cfe22-5a46-4830-a8fa-0f2d7236e269
                percentage_fee: null
                recurring: false
                recurring_details: null
                refunds: null
                root_order_id: null
                sale_country_code: null
                shipping_address:
                    city: Menlo Park
                    country: GB
                    id: cdb98f98-14c2-47b8-8b7c-87d8313ac6aa
                    organization_name: TWO B2B LTD
                    postal_code: SW17 8BY
                    preferred: null
                    region: GB
                    street_address: 1 Hacker Way
                shipping_details:
                    address_attn: null
                    address_co: null
                    address_reference: null
                    carrier_name: Example carrier
                    carrier_tracking_url: https://example.com/tracking-url/
                    delivery_method: null
                    expected_delivery_date: '2026-01-08'
                    id_required_on_delivery: null
                    tracking_number: SHIPPING_TRACKING_NUMBER
                state: UNVERIFIED
                status: APPROVED
                tax_amount: '20.00'
                tax_subtotals: null
                total_fee: null
                tracking_id: null
                vendor_id: null
                vendor_name: null
            properties:
                id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: A globally unique ID set by Two.
                    title: Id
                order_placed_date:
                    description: Date the order was placed (UTC)
                    examples:
                    - '2026-01-01 14:02:02.002222'
                    format: date-time
                    title: Order Placed Date
                    type: string
                gross_amount:
                    description: net_amount + tax_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Gross Amount
                    type: string
                payable_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    description: invoice_amount - prepaid_amount
                    examples:
                    - '100.00'
                    title: Payable Amount
                invoice_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    description: total of invoice
                    examples:
                    - '100.00'
                    title: Invoice Amount
                prepaid_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    description: amount paid upfront
                    examples:
                    - '100.00'
                    title: Prepaid Amount
                net_amount:
                    description: (quantity * unit_price) - discount_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Net Amount
                    type: string
                currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: Currency code in ISO 4217 format. E.g. 'NOK'
                    examples:
                    - GBP
                discount_amount:
                    deprecated: true
                    description: Deprecated, discount amount is only applicable at
                        line item level
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Discount Amount
                    type: string
                discount_rate:
                    deprecated: true
                    description: Deprecated, discount rate is only applicable at line
                        item level
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Discount Rate
                    type: string
                tax_amount:
                    description: net_amount * tax_rate
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                invoice_type:
                    $ref: '#/components/schemas/InvoiceTypeEnum'
                    description: 'FUNDED_INVOICE: Two will handle the invoice and
                        transfer the funds to the merchant as per the factoring agreement.
                        The invoice_details field will be populated by Two. DIRECT_INVOICE:
                        Two generates and sends the invoice to the customer based
                        on the bank account provided by the merchant, but the merchant
                        takes the full credit and fraud risk on direct invoices and
                        they will not receive a payout.'
                    examples:
                    - FUNDED_INVOICE
                order_type:
                    $ref: '#/components/schemas/OrderTypeEnum'
                    description: Type of order (Buyer or Merchant initiated)
                    examples:
                    - BUYER_INITIATED
                sale_country_code:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional sale country code (ISO 3166 Alpha-2) to
                        use for this order, if null defaults to buyer country code.
                    examples:
                    - GB
                    title: Sale Country Code
                merchant_payout_account_alias:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional payee account alias account identifier for
                        multiple accounts setup.
                    title: Merchant Payout Account Alias
                percentage_fee:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Percentage fee
                    examples:
                    - '0.00'
                    title: Percentage Fee
                fixed_fee:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Fixed fee
                    examples:
                    - '0.00'
                    title: Fixed Fee
                total_fee:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Total fee
                    examples:
                    - '0.00'
                    title: Total Fee
                state:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderStateEnum'
                    -   type: 'null'
                    default: null
                    description: Current Order State
                    examples:
                    - UNVERIFIED
                status:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderStatusEnum'
                    -   type: 'null'
                    default: null
                    description: Order approval status
                    examples:
                    - APPROVED
                recurring:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: If set to true, an invoice will be generated periodically
                        according to the specification provided in recurring_details
                    examples:
                    - false
                    title: Recurring
                buyer:
                    $ref: '#/components/schemas/LaxBuyerSchema'
                    description: Fields representing the buyer
                buyer_department:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Department the purchase is to be registered on
                    title: Buyer Department
                buyer_project:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Project the purchase is to be registered on
                    title: Buyer Project
                buyer_purchase_order_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Purchase order number to attribute to the order
                    title: Buyer Purchase Order Number
                buyer_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: 'General buyer reference field for information that
                        is not covered by the specific reference fields, e.g. PO-number.
                        Note: Maximum 140 characters'
                    title: Buyer Reference
                buyer_vat_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Vat number associated with the buyer company
                    title: Buyer Vat Number
                electronic_invoice_recipient:
                    anyOf:
                    -   $ref: '#/components/schemas/ElectronicInvoiceRecipient'
                    -   type: 'null'
                    default: null
                    description: Electronic invoice recipient
                line_items:
                    description: List of the line items that constitute the order
                    items:
                        $ref: '#/components/schemas/LineItemResponseSchema'
                    title: Line Items
                    type: array
                merchant_order_id:
                    description: Your order ID registered in your solution
                    title: Merchant Order Id
                    type: string
                merchant_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Field set by merchant for adding a reference to be
                        used internally by the merchant. Does not appear on invoice.
                    title: Merchant Reference
                merchant_user_id:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    description: Your internal ID of the user (the employee of your
                        business customer) registered for one-click purchase through
                        the Two Trade Account Onboarding API.
                    title: Merchant User Id
                billing_account_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: ID for the billing account linked to this order.
                        Can be set on order creation or order edit while the order
                        is still editable. A null value means no billing account is
                        linked. When set, billing account payment terms control repayment
                        scheduling.
                    title: Billing Account Id
                date_created:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Order creation date (UTC)
                    title: Date Created
                date_updated:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Order update date (UTC)
                    title: Date Updated
                merchant_additional_info:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Additional info the merchant can connect to the order
                    title: Merchant Additional Info
                recurring_details:
                    anyOf:
                    -   $ref: '#/components/schemas/RecurringDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Currently not available
                invoice_details:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Invoice details are provided by the merchant via
                        Merchant Portal when invoice_type is DIRECT_INVOICE, Two Bank
                        or a 3rd-party bank when invoice_type is FUNDED_INVOICE and
                        empty when invoice_type is CARD.
                merchant_id:
                    description: A globally unique merchant ID set by Two.
                    format: uuid
                    title: Merchant Id
                    type: string
                merchant_short_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The short form name of the merchant
                    title: Merchant Short Name
                merchant_logo_path:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The logo URL of the merchant
                    title: Merchant Logo Path
                merchant_urls:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderMerchantUrlsSchema'
                    -   type: 'null'
                    default: null
                    description: List of urls hosted by the merchant.
                payment_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: '''Redirect the user to Two hosted page to verify
                        the payment.'
                    title: Payment Url
                invoice_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to the invoice pdf. E.g.
                    title: Invoice Url
                credit_note_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to the credit note pdf
                    title: Credit Note Url
                event_log_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: This url returns a list of all events that are associated
                        with the order
                    title: Event Log Url
                shipping_details:
                    anyOf:
                    -   $ref: '#/components/schemas/ShippingDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Optional shipping details to track the shipment
                original_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: The original order id has been deprecated in favor
                        of root_order_id, please use root_order_id instead
                    title: Original Order Id
                root_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The root order id
                    title: Root Order Id
                parent_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The parent order id
                    title: Parent Order Id
                external_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Your external order id
                    title: External Order Id
                external_order_status:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Your external order status
                    title: External Order Status
                decline_reason:
                    anyOf:
                    -   $ref: '#/components/schemas/DeclineReasonEnum'
                    -   type: 'null'
                    default: null
                    description: Reason for order being declined
                recourse_decision_reason:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reason for recourse decision
                    title: Recourse Decision Reason
                order_note:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: General note/message from the buyer to the merchant
                    title: Order Note
                order_origination:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderOriginationEnum'
                    -   type: 'null'
                    default: null
                    description: IN_STORE orders are not enabled by default. Please
                        reach out to us if you would like to discuss IN_STORE orders.
                billing_address:
                    $ref: '#/components/schemas/AddressResponseSchema'
                    description: Order billing address
                shipping_address:
                    $ref: '#/components/schemas/AddressResponseSchema'
                    description: Order shipping address
                date_fulfilled:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    description: Date when the order was fulfilled (UTC)
                    title: Date Fulfilled
                tracking_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: 'The tracking_id from `POST /order_intent` '
                    title: Tracking Id
                vendor_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The id of the vendor
                    title: Vendor Id
                refunds:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/CreateRefundResponseSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: Refunds attached to this order
                    title: Refunds
                order_revision:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: Order revision
                    title: Order Revision
                vendor_name:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    description: The name of the vendor
                    title: Vendor Name
                elapsed_time_ms:
                    anyOf:
                    -   additionalProperties: true
                        type: object
                    -   type: 'null'
                    default: null
                    title: Elapsed Time Ms
                invoice_insurance_provider:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceInsuranceDecisionEnum'
                    -   type: 'null'
                    default: null
                    description: The insurance provider
                tax_subtotals:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/TaxSubtotalSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of tax subtotals for unique tax brackets
                    title: Tax Subtotals
                approved_on_recourse:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    title: Approved On Recourse
                recourse_fallback_enabled:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: Deprecated. Use approved_on_recourse.
                    deprecated: true
                    title: Recourse Fallback Enabled
                merchant_display_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The display name of the merchant
                    title: Merchant Display Name
                terms:
                    anyOf:
                    -   description: For backwards compatibility, `type` can be omitted
                            for instalment terms, if the fields period and number_of_instalments
                            are populated. It is recommended that that clients always
                            provide a type value.
                        discriminator:
                            mapping:
                                INSTALMENTS: '#/components/schemas/OrderInstalmentTerms'
                                NET_TERMS: '#/components/schemas/OrderNetTerms'
                            propertyName: type
                        oneOf:
                        -   $ref: '#/components/schemas/OrderInstalmentTerms'
                        -   $ref: '#/components/schemas/OrderNetTerms'
                    -   type: 'null'
                    default: null
                    description: The terms of this order
                    title: Terms
                lending_terms:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderLendingTermsSchema'
                    -   type: 'null'
                    default: null
                    description: The lending terms of this order associated with a
                        credit line
                credit_line_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: ID of the credit line used to fund the order, created
                        through the Two Credit Line API.
                    title: Credit Line Id
                invoice_distributed_by_merchant:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: If set to true, the invoice is distributed by the
                        merchant
                    title: Invoice Distributed By Merchant
                principal_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Total principal amount to be paid back for this order
                    title: Principal Amount
                buyer_finance_charge_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Total amount of interest/fees the buyer will pay
                        back by fully paying off this order
                    title: Buyer Finance Charge Amount
                preferred_distribution_method:
                    anyOf:
                    -   $ref: '#/components/schemas/DistributionMethodEnum'
                    -   type: 'null'
                    default: null
                    description: Allows merchant to set the method of distribution
                        for the invoice and credit notes of the order, if not set
                        will default to all methods
            required:
            - order_placed_date
            - gross_amount
            - payable_amount
            - invoice_amount
            - prepaid_amount
            - net_amount
            - currency
            - discount_amount
            - discount_rate
            - tax_amount
            - invoice_type
            - order_type
            - buyer
            - line_items
            - merchant_order_id
            - merchant_id
            - billing_address
            - shipping_address
            title: OrderResponseSchema
            type: object
        BuyerRefundSurcharge:
            properties:
                surcharge_type:
                    $ref: '#/components/schemas/BuyerSurchargeType'
                    description: Type of surcharge
                amount:
                    description: Amount of the surcharge, excluding VAT/tax. Must
                        be greater than zero.
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Amount
                    type: string
                description:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Human readable text included in the credit note
                    title: Description
                tax_rate:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                        type: string
                    -   type: 'null'
                    default: '0.00'
                    description: Tax rate of the surcharge if applicable.
                    title: Tax Rate
            required:
            - surcharge_type
            - amount
            title: BuyerRefundSurcharge
            type: object
        BuyerSurchargeType:
            enum:
            - return_fee
            - neglected_order_fee
            - handling_fee
            - processing_fee
            - missing_or_damaged_items_fee
            - return_shipping_fee
            - discount_reversal_fee
            - other_fee
            title: BuyerSurchargeType
            type: string
        CreateRefundResponseSchema:
            additionalProperties: true
            properties:
                id:
                    description: A globally unique ID set by Two.
                    format: uuid
                    title: Id
                    type: string
                amount:
                    deprecated: true
                    description: payable amount being refunded
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Amount
                    type: string
                total_amount:
                    description: payable_amount + prepaid_amount
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Total Amount
                    type: string
                payable_amount:
                    description: 'Amount due from the buyer to Two. Formula: invoice_amount
                        - prepaid_amount. This is the portion Two funds and takes
                        risk on.'
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Payable Amount
                    type: string
                prepaid_amount:
                    default: '0.00'
                    description: Prepaid amount refunded
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Prepaid Amount
                    type: string
                currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: Currency refund is being issued in
                    examples:
                    - GB
                refund_no:
                    deprecated: true
                    description: Refund number, please use credit_note_number. if
                        you supply your own credit note numbers and it contains non
                        numeric values this value will be null
                    title: Refund No
                    type: integer
                credit_note_number:
                    description: A unique, sequential identifier for credit notes,
                        similar to invoice_number. Follows a monotonically increasing
                        series to ensure chronological tracking, prevent duplicates,
                        and maintain auditability and compliance with financial regulations.
                    title: Credit Note Number
                    type: string
                credit_note_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to credit note issued by Two
                    title: Credit Note Url
                line_items:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/LineItemResponseSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of the line items that constitute the order
                    title: Line Items
                reason:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reason for order refund
                    examples:
                    - Damage
                    title: Reason
                tax_subtotals:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/TaxSubtotalSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of tax subtotals for unique tax brackets
                    title: Tax Subtotals
                buyer_refund_surcharges:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/BuyerRefundSurcharge'
                        type: array
                    -   type: 'null'
                    default: null
                    title: Buyer Refund Surcharges
                refund_reference:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    title: Refund Reference
                refund_date:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    title: Refund Date
            required:
            - id
            - amount
            - total_amount
            - payable_amount
            - currency
            - refund_no
            - credit_note_number
            title: CreateRefundResponseSchema
            type: object
        InvoiceDetailsSchema:
            examples:
            -   due_date: '2026-01-31'
                due_in_days: '30'
                invoice_number: string
                invoicing_group_id: string
                payee:
                    bban: string
                    bic: string
                    branch_sort_code: string
                    country_code: string
                    description: string
                    iban: string
                    local_account_number: string
                    organization_name: string
                    organization_number: string
                payment_reference: string
                payment_reference_message: string
                payment_reference_ocr: string
                payment_reference_type: string
            properties:
                payee:
                    anyOf:
                    -   $ref: '#/components/schemas/BankAccountSchema'
                    -   type: 'null'
                    default: null
                payment_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Payment Reference
                payment_reference_type:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Payment Reference Type
                payment_reference_message:
                    default: ''
                    description: Text that will be attached to the payment in order
                        for the merchant to reconcile the payment.
                    title: Payment Reference Message
                    type: string
                payment_reference_ocr:
                    default: ''
                    description: A string of numbers that will be attached to the
                        payment in order for the merchant to reconcile the payment.
                        E.g. "KID-nummer" in Norway.
                    title: Payment Reference Ocr
                    type: string
                payment_status:
                    anyOf:
                    -   $ref: '#/components/schemas/PaymentStatusEnum'
                    -   type: 'null'
                    default: null
                due_in_days:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: Please add terms to order instead, with type NET_TERMS
                        and duration_days
                    title: Due In Days
                invoice_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Number
                invoice_issue_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Issue Date
                due_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    title: Due Date
                invoice_emails:
                    anyOf:
                    -   items:
                            format: email
                            type: string
                        type: array
                    -   type: 'null'
                    default: null
                    description: We will send invoices to all of the email addresses.
                    title: Invoice Emails
                id:
                    format: uuid
                    title: Id
                    type: string
                status:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceStatusEnum'
                    -   type: 'null'
                    default: PENDING
                    description: Status of invoice, mainly interested if has a status
                        of REPLACED from an invoice edit
                invoice_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Url
                due_in_days_calculation_method:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Method for calculating payment terms (e.g., END_OF_MONTH,
                        END_OF_WEEK) at fulfillment.
                    title: Due In Days Calculation Method
                requested_due_in_days:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: The duration_days value requested at order creation,
                        before applying the due_in_days_calculation_method at fulfillment.
                    title: Requested Due In Days
                recourse_request_status:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Status of recourse request if one exists (PENDING,
                        APPROVED, REJECTED).
                    title: Recourse Request Status
            required:
            - id
            title: InvoiceDetailsSchema
            type: object
        InvoiceInsuranceDecisionEnum:
            enum:
            - EULER_HERMES
            - NO_INSURANCE
            title: InvoiceInsuranceDecisionEnum
            type: string
        InvoiceStatusEnum:
            enum:
            - PENDING
            - ACTIVE
            - REPLACED
            title: InvoiceStatusEnum
            type: string
        LaxBuyerSchema:
            description: |-
                A buyer schema that combines relaxed validation for both the nested company and
                representative objects.
            properties:
                representative:
                    anyOf:
                    -   $ref: '#/components/schemas/LaxRepresentativeSchema'
                    -   type: 'null'
                    default: null
                    description: Fields to capture who the order is for
                company:
                    $ref: '#/components/schemas/LaxCompanySchema'
                    description: Fields to capture the details of the company for
                        which the order is intended
            required:
            - company
            title: LaxBuyerSchema
            type: object
        LaxCompanySchema:
            description: |-
                To be used where we don't need validation on the data being returned, such as for responses,
                or where the organization number has been validated upstream.
                Effectively disables the organization_number validator.
            properties:
                id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: Internal company Id
                    title: Id
                country_prefix:
                    $ref: '#/components/schemas/CountryCodeEnum'
                    description: Country code in ISO 3166-1 alpha-2 format
                    examples:
                    - GB
                organization_number:
                    description: National id of the buyer company
                    title: Organization Number
                    type: string
                company_name:
                    default: null
                    description: Legal name of the buyer company
                    maxLength: 255
                    minLength: 1
                    title: Company Name
                    type: string
                company_type:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Type of company placing the order
                    title: Company Type
                company_canonical_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Unique canonical ID representing this company
                    title: Company Canonical Id
                website:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Company's website
                    examples:
                    - https://www.example.com/
                    title: Website
            required:
            - country_prefix
            - organization_number
            title: LaxCompanySchema
            type: object
        OrderLendingTermsSchema:
            properties:
                order_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    title: Order Id
                credit_line_id:
                    format: uuid
                    title: Credit Line Id
                    type: string
                apr:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    title: Apr
                base_rate:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    title: Base Rate
                per_payment_rate_factor:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    title: Per Payment Rate Factor
                margin:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    title: Margin
                hedge_rate:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    -   type: 'null'
                    title: Hedge Rate
            required:
            - order_id
            - credit_line_id
            - apr
            - base_rate
            - per_payment_rate_factor
            - margin
            - hedge_rate
            title: OrderLendingTermsSchema
            type: object
        OrderStateEnum:
            enum:
            - UNVERIFIED
            - VERIFIED
            - CONFIRMED
            - FULFILLING
            - FULFILLED
            - DELIVERED
            - CANCELLED
            - REFUNDED
            - FULFILMENT_NEEDS_MANUAL_RESOLUTION
            title: OrderStateEnum
            type: string
        OrderStatusEnum:
            enum:
            - UNINITIATED
            - APPROVED
            - DECLINED
            - REJECTED
            - PARTIAL
            title: OrderStatusEnum
            type: string
        OrderFeeRequestSchema:
            properties:
                buyer_country_code:
                    $ref: '#/components/schemas/CountryCodeEnum'
                approved_on_recourse:
                    title: Approved On Recourse
                    type: boolean
                invoice_due_in_days:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    title: Invoice Due In Days
                gross_amount:
                    anyOf:
                    -   minimum: 0.0
                        type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    title: Gross Amount
                order_terms:
                    anyOf:
                    -   description: For backwards compatibility, `type` can be omitted
                            for instalment terms, if the fields period and number_of_instalments
                            are populated. It is recommended that that clients always
                            provide a type value.
                        discriminator:
                            mapping:
                                INSTALMENTS: '#/components/schemas/OrderInstalmentTerms'
                                NET_TERMS: '#/components/schemas/OrderNetTerms'
                            propertyName: type
                        oneOf:
                        -   $ref: '#/components/schemas/OrderInstalmentTerms'
                        -   $ref: '#/components/schemas/OrderNetTerms'
                    -   type: 'null'
                    default: null
                    title: Order Terms
                buyer_fee_share:
                    anyOf:
                    -   $ref: '#/components/schemas/BuyerFeeShareSchema'
                    -   $ref: '#/components/schemas/InternalBuyerFeeShareSchema'
                    -   type: 'null'
                    default: null
                    title: Buyer Fee Share
                currency:
                    anyOf:
                    -   $ref: '#/components/schemas/CurrencyEnum'
                    -   type: 'null'
                    default: null
                    description: ISO 4217 currency code that the monetary values in
                        this request are denominated in. Applies to gross_amount and
                        all amounts under buyer_fee_share (threshold, surcharge, cap).
                        When omitted, the merchant's configured fee_currency is assumed.
                        The response always echoes the resolved currency so the caller
                        can verify.
                    examples:
                    - NOK
            required:
            - buyer_country_code
            - approved_on_recourse
            - gross_amount
            title: OrderFeeRequestSchema
            type: object
        BuyerFeeShareSchema:
            additionalProperties: false
            description: API-facing schema — adds reference_terms with mutual exclusion
                against threshold.
            properties:
                threshold:
                    anyOf:
                    -   format: decimal
                        ge: '0'
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Fee amount below which the percentage is not applied.
                        Only the portion of your total fee above this value is eligible
                        to be recharged to the buyer via the percentage field. Either
                        threshold or reference_terms may be specified, but not both.
                    examples:
                    - '0'
                    title: Threshold
                percentage:
                    anyOf:
                    -   maximum: 100.0
                        minimum: 0.0
                        type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    default: '100'
                    description: Percentage of the applicable fee you want to pass
                        to the buyer (0-100). Defaults to 100.
                    examples:
                    - '100.00'
                    title: Percentage
                surcharge:
                    anyOf:
                    -   format: decimal
                        ge: '0'
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Flat amount added to the buyer fee share, in addition
                        to any percentage of your total fee. The surcharge_basis field
                        controls whether this is the amount the buyer is charged on
                        the line item (`buyer_pays`, the default) or the amount you
                        net after Two's fees (`merchant_receives`). Applied before
                        the cap. Ignored when gross_amount is 0.
                    examples:
                    - '5.00'
                    title: Surcharge
                surcharge_basis:
                    $ref: '#/components/schemas/SurchargeBasis'
                    default: buyer_pays
                    description: 'How to interpret the surcharge value. `buyer_pays`
                        (default): the configured amount is what the buyer is charged
                        as a line item; you absorb the variable fee Two applies to
                        that line item. `merchant_receives`: the configured amount
                        is what you net after Two''s fees; the buyer line item is
                        grossed up so the fee on the line item does not reduce your
                        receipt.'
                    examples:
                    - buyer_pays
                cap:
                    anyOf:
                    -   format: decimal
                        ge: '0'
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Upper limit on the final buyer fee share line item
                        (post-gross-up, post-surcharge). If the computed share would
                        exceed this amount, it is clamped to cap and you absorb the
                        remainder. None means no cap.
                    examples:
                    - '50.00'
                    title: Cap
                reference_terms:
                    anyOf:
                    -   description: For backwards compatibility, `type` can be omitted
                            for instalment terms, if the fields period and number_of_instalments
                            are populated. It is recommended that that clients always
                            provide a type value.
                        discriminator:
                            mapping:
                                INSTALMENTS: '#/components/schemas/OrderInstalmentTerms'
                                NET_TERMS: '#/components/schemas/OrderNetTerms'
                            propertyName: type
                        oneOf:
                        -   $ref: '#/components/schemas/OrderInstalmentTerms'
                        -   $ref: '#/components/schemas/OrderNetTerms'
                    -   type: 'null'
                    default: null
                    description: Baseline terms used to compute the threshold automatically.
                        The buyer only pays the fee difference between the order's
                        terms and these baseline terms — use this when you want to
                        absorb the fee for a standard payment option and pass on only
                        the incremental cost of longer terms. Either threshold or
                        reference_terms may be specified, but not both.
                    examples:
                    -   duration_days: 30
                        type: NET_TERMS
                    title: Reference Terms
            title: BuyerFeeShareSchema
            type: object
        InternalBuyerFeeShareSchema:
            additionalProperties: false
            description: Resolved buyer fee share config — reference_terms already
                converted to a threshold.
            properties:
                threshold:
                    anyOf:
                    -   format: decimal
                        ge: '0'
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Fee amount below which the percentage is not applied.
                        Only the portion of your total fee above this value is eligible
                        to be recharged to the buyer via the percentage field. Either
                        threshold or reference_terms may be specified, but not both.
                    examples:
                    - '0'
                    title: Threshold
                percentage:
                    anyOf:
                    -   maximum: 100.0
                        minimum: 0.0
                        type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    default: '100'
                    description: Percentage of the applicable fee you want to pass
                        to the buyer (0-100). Defaults to 100.
                    examples:
                    - '100.00'
                    title: Percentage
                surcharge:
                    anyOf:
                    -   format: decimal
                        ge: '0'
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Flat amount added to the buyer fee share, in addition
                        to any percentage of your total fee. The surcharge_basis field
                        controls whether this is the amount the buyer is charged on
                        the line item (`buyer_pays`, the default) or the amount you
                        net after Two's fees (`merchant_receives`). Applied before
                        the cap. Ignored when gross_amount is 0.
                    examples:
                    - '5.00'
                    title: Surcharge
                surcharge_basis:
                    $ref: '#/components/schemas/SurchargeBasis'
                    default: buyer_pays
                    description: 'How to interpret the surcharge value. `buyer_pays`
                        (default): the configured amount is what the buyer is charged
                        as a line item; you absorb the variable fee Two applies to
                        that line item. `merchant_receives`: the configured amount
                        is what you net after Two''s fees; the buyer line item is
                        grossed up so the fee on the line item does not reduce your
                        receipt.'
                    examples:
                    - buyer_pays
                cap:
                    anyOf:
                    -   format: decimal
                        ge: '0'
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Upper limit on the final buyer fee share line item
                        (post-gross-up, post-surcharge). If the computed share would
                        exceed this amount, it is clamped to cap and you absorb the
                        remainder. None means no cap.
                    examples:
                    - '50.00'
                    title: Cap
            title: InternalBuyerFeeShareSchema
            type: object
        SurchargeBasis:
            description: Perspective from which a buyer fee share surcharge amount
                is interpreted.
            enum:
            - merchant_receives
            - buyer_pays
            title: SurchargeBasis
            type: string
        PricingOrderFeeResponseSchema:
            properties:
                currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: ISO 4217 currency code that total_fee and buyer_fee_share
                        are denominated in. Echoes the currency sent on the request
                        when provided, otherwise the merchant's configured fee_currency.
                    examples:
                    - NOK
                total_fee:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    description: Estimated fee for the provided gross_amount and terms,
                        assuming no buyer_fee_share line item is added to the order.
                        If you add buyer_fee_share to the invoice, the order total
                        will grow by that amount and the fee Two actually charges
                        will be higher than total_fee; buyer_fee_share already accounts
                        for that increase so the merchant nets the intended amount.
                    examples:
                    - '44.29'
                    title: Total Fee
                fixed_fee:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    description: Flat per-order fee component applied to this quote,
                        in `currency`.
                    examples:
                    - '1.00'
                    title: Fixed Fee
                percentage_fee:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    description: 'Variable-rate component applied to this quote, in
                        percent units (e.g. `1.44` means 1.44%). For a non-instalment
                        order: total_fee == fixed_fee + gross_amount * percentage_fee
                        / 100.'
                    examples:
                    - '1.44'
                    title: Percentage Fee
                buyer_fee_share:
                    anyOf:
                    -   type: number
                    -   pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
                        type: string
                    description: Amount to add to the order as an additional line
                        item (paid by the buyer) if you want to recover some or all
                        of the merchant fee. This may exceed total_fee — the line
                        item itself attracts Two's variable fee, so the amount is
                        grossed up to deliver the merchant's intended net. Zero when
                        buyer_fee_share is omitted from the request.
                    examples:
                    - '46.35'
                    title: Buyer Fee Share
                total_fee_tax_rate:
                    description: Tax rate applied to total_fee.
                    examples:
                    - '0.000000'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Total Fee Tax Rate
                    type: string
                pricing_package_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Pricing package ID used for this quote.
                    title: Pricing Package Id
                pricing_package_revision:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: Pricing package revision used for this quote.
                    title: Pricing Package Revision
                pricing_package_metadata:
                    anyOf:
                    -   $ref: '#/components/schemas/PricingPackageMetadataSchema'
                    -   type: 'null'
                    default: null
                    description: 'Rate-card breakdown for this quote: which net-days
                        and cycle-length buckets fired and their individual rates.
                        Null when the fee came from an override or legacy merchant
                        fallback rather than a pricing package.'
            required:
            - currency
            - total_fee
            - fixed_fee
            - percentage_fee
            - buyer_fee_share
            - total_fee_tax_rate
            title: PricingOrderFeeResponseSchema
            type: object
        PricingPackageMetadataSchema:
            properties:
                pricing_package_id:
                    title: Pricing Package Id
                    type: string
                pricing_package_revision:
                    title: Pricing Package Revision
                    type: integer
                buyer_country_code:
                    title: Buyer Country Code
                    type: string
                net_days_category:
                    title: Net Days Category
                    type: string
                net_days_rate:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Net Days Rate
                    type: string
                cycle_length_category:
                    title: Cycle Length Category
                    type: string
                cycle_length_rate:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Cycle Length Rate
                    type: string
            required:
            - pricing_package_id
            - pricing_package_revision
            - buyer_country_code
            - net_days_category
            - net_days_rate
            - cycle_length_category
            - cycle_length_rate
            title: PricingPackageMetadataSchema
            type: object
        PaymentLinkResponseSchema:
            description: Response schema for payment link generation
            properties:
                payment_link:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The generated payment initiation URL. Null if payment
                        link cannot be generated due to unsupported configuration.
                    examples:
                    - https://checkout.two.inc/payment/initiation?token=abc123
                    title: Payment Link
            title: PaymentLinkResponseSchema
            type: object
        OrderResponseList:
            description: List of all orders for a given merchant
            items:
                anyOf:
                -   $ref: '#/components/schemas/OrderResponseSchema'
                -   $ref: '#/components/schemas/BuyerInitiatedLatentOrderResponseSchema'
            title: OrderResponseList
            type: array
        BuyerInitiatedLatentOrderAddressResponseSchema:
            properties:
                organization_name:
                    title: Organization Name
                    type: string
                street_address:
                    title: Street Address
                    type: string
                postal_code:
                    title: Postal Code
                    type: string
                city:
                    title: City
                    type: string
                region:
                    title: Region
                    type: string
                country:
                    $ref: '#/components/schemas/CountryCodeEnum'
                preferred:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    title: Preferred
            required:
            - organization_name
            - street_address
            - postal_code
            - city
            - region
            - country
            title: BuyerInitiatedLatentOrderAddressResponseSchema
            type: object
        BuyerInitiatedLatentOrderResponseSchema:
            example:
                billing_account_id: null
                billing_address:
                    city: Menlo Park
                    country: GB
                    id: cdb98f98-14c2-47b8-8b7c-87d8313ac6aa
                    organization_name: TWO B2B LTD
                    postal_code: SW17 8BY
                    preferred: null
                    region: GB
                    street_address: 1 Hacker Way
                buyer:
                    company:
                        company_name: TWO B2B LTD
                        company_type: ''
                        country_prefix: GB
                        organization_number: '13078389'
                        website: null
                    representative:
                        email: john.doe@twob2bltd.com
                        first_name: John
                        last_name: Doe
                        phone_number: '+447516498321'
                buyer_department: null
                buyer_project: null
                buyer_purchase_order_number: null
                buyer_reference: null
                credit_note_url: null
                currency: GBP
                date_created: '2026-01-01 14:02:02.002222'
                date_fulfilled: null
                date_updated: '2026-01-01 14:02:02.002222'
                decline_reason: null
                discount_amount: '0.00'
                discount_rate: '0.000000'
                elapsed_time_ms: null
                electronic_invoice_recipient: null
                event_log_url: https://tillit.ai
                external_order_id: null
                external_order_status: null
                fixed_fee: null
                gross_amount: '120.00'
                id: f36cfe22-5a46-4830-a8fa-0f2d7236e269
                invoice_details:
                    due_date: null
                    due_in_days: 14
                    id: a49d8790-306c-4d3e-830f-fbdc99676cf8
                    invoice_issue_date: null
                    invoice_number: null
                    payee: null
                    payment_reference: null
                    payment_reference_message: ''
                    payment_reference_ocr: ''
                    payment_reference_type: null
                    payment_status: null
                invoice_insurance_provider: NO_INSURANCE
                invoice_type: FUNDED_INVOICE
                invoice_url: null
                line_items:
                -   description: Blue whale poster
                    details:
                        barcodes:
                        -   type: SKU
                            value: YOUR_BARCODE_VALUE
                        -   type: UPC
                            value: YOUR_BARCODE_VALUE
                        brand: Whale Posters INC
                        categories:
                        - YOUR_CATEGORY_A
                        - YOUR_CATEGORY_B
                        part_number: MANUFACTURER_PART_NUMBER
                    discount_amount: '0.00'
                    gross_amount: '120.00'
                    id: 21d3fd7f-1e12-466a-bbbb-09ab38bfa869
                    image_url: https://www.exampleobjects.com/product-image-800x600
                    line_item_reference: YOUR_LINE_ITEM_REFERENCE
                    name: Whale poster
                    net_amount: '100.00'
                    product_page_url: https://www.example.com/products/######
                    prototype_id: null
                    quantity: 1.0
                    quantity_unit: pcs
                    tax_amount: '20.00'
                    tax_class_name: VAT 20%
                    tax_rate: '0.200000'
                    type: PHYSICAL
                    unit_price: '100.00'
                merchant_additional_info: Additional line item information
                merchant_id: 1115e2ea-f6d2-4129-930f-3657600555ba
                merchant_order_id: YOUR_MERCHANT_ORDER_ID
                merchant_payout_account_alias: null
                merchant_reference: YOUR_MERCHANT_REFERENCE
                merchant_short_name: tillit
                merchant_urls:
                    merchant_cancel_order_url: YOUR_MERCHANT_URL/cancel-order
                    merchant_confirmation_url: YOUR_MERCHANT_URL/confimation
                    merchant_document_urls: null
                    merchant_edit_order_url: YOUR_MERCHANT_URL/edit-order
                    merchant_invoice_url: YOUR_MERCHANT_URL/invoice
                    merchant_order_callback_auth: null
                    merchant_order_callback_url: null
                    merchant_order_verification_failed_url: YOUR_MERCHANT_URL/order-verification-failed
                    merchant_order_verification_pending_url: YOUR_MERCHANT_URL/pending-order
                    merchant_order_verified_url: null
                    merchant_shipping_document_url: YOUR_MERCHANT_URL/shipping-document
                net_amount: '100.00'
                order_note: null
                order_origination: ONLINE
                order_placed_date: '2026-01-01 14:02:02.002222'
                order_revision: null
                order_type: BUYER_INITIATED
                original_order_id: null
                parent_order_id: null
                payment_url: http://localhost:5000/order/f36cfe22-5a46-4830-a8fa-0f2d7236e269
                percentage_fee: null
                recurring: false
                recurring_details: null
                refunds: null
                root_order_id: null
                sale_country_code: null
                shipping_address:
                    city: Menlo Park
                    country: GB
                    id: cdb98f98-14c2-47b8-8b7c-87d8313ac6aa
                    organization_name: TWO B2B LTD
                    postal_code: SW17 8BY
                    preferred: null
                    region: GB
                    street_address: 1 Hacker Way
                shipping_details:
                    address_attn: null
                    address_co: null
                    address_reference: null
                    carrier_name: Example carrier
                    carrier_tracking_url: https://example.com/tracking-url/
                    delivery_method: null
                    expected_delivery_date: '2026-01-08'
                    id_required_on_delivery: null
                    tracking_number: SHIPPING_TRACKING_NUMBER
                state: UNVERIFIED
                status: APPROVED
                tax_amount: '20.00'
                tax_subtotals: null
                total_fee: null
                tracking_id: null
                vendor_id: null
                vendor_name: null
            properties:
                id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: A globally unique ID set by Two.
                    title: Id
                order_placed_date:
                    description: Date the order was placed (UTC)
                    examples:
                    - '2026-01-01 14:02:02.002222'
                    format: date-time
                    title: Order Placed Date
                    type: string
                gross_amount:
                    description: net_amount + tax_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Gross Amount
                    type: string
                payable_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    description: invoice_amount - prepaid_amount
                    examples:
                    - '100.00'
                    title: Payable Amount
                invoice_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    description: total of invoice
                    examples:
                    - '100.00'
                    title: Invoice Amount
                prepaid_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    description: amount paid upfront
                    examples:
                    - '100.00'
                    title: Prepaid Amount
                net_amount:
                    description: (quantity * unit_price) - discount_amount
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Net Amount
                    type: string
                currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: Currency code in ISO 4217 format. E.g. 'NOK'
                    examples:
                    - GBP
                discount_amount:
                    deprecated: true
                    description: Deprecated, discount amount is only applicable at
                        line item level
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Discount Amount
                    type: string
                discount_rate:
                    deprecated: true
                    description: Deprecated, discount rate is only applicable at line
                        item level
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                    title: Discount Rate
                    type: string
                tax_amount:
                    description: net_amount * tax_rate
                    examples:
                    - '0.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                invoice_type:
                    $ref: '#/components/schemas/InvoiceTypeEnum'
                    description: 'FUNDED_INVOICE: Two will handle the invoice and
                        transfer the funds to the merchant as per the factoring agreement.
                        The invoice_details field will be populated by Two. DIRECT_INVOICE:
                        Two generates and sends the invoice to the customer based
                        on the bank account provided by the merchant, but the merchant
                        takes the full credit and fraud risk on direct invoices and
                        they will not receive a payout.'
                    examples:
                    - FUNDED_INVOICE
                order_type:
                    $ref: '#/components/schemas/OrderTypeEnum'
                    description: Type of order (Buyer or Merchant initiated)
                    examples:
                    - BUYER_INITIATED
                sale_country_code:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional sale country code (ISO 3166 Alpha-2) to
                        use for this order, if null defaults to buyer country code.
                    examples:
                    - GB
                    title: Sale Country Code
                merchant_payout_account_alias:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional payee account alias account identifier for
                        multiple accounts setup.
                    title: Merchant Payout Account Alias
                percentage_fee:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Percentage fee
                    examples:
                    - '0.00'
                    title: Percentage Fee
                fixed_fee:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Fixed fee
                    examples:
                    - '0.00'
                    title: Fixed Fee
                total_fee:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Total fee
                    examples:
                    - '0.00'
                    title: Total Fee
                state:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderStateEnum'
                    -   type: 'null'
                    default: null
                    description: Current Order State
                    examples:
                    - UNVERIFIED
                status:
                    anyOf:
                    -   $ref: '#/components/schemas/LatentOrderStatusEnum'
                    -   type: 'null'
                    description: Latent order status
                recurring:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: If set to true, an invoice will be generated periodically
                        according to the specification provided in recurring_details
                    examples:
                    - false
                    title: Recurring
                buyer:
                    $ref: '#/components/schemas/LaxBuyerSchema'
                    description: Fields representing the buyer
                buyer_department:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Department the purchase is to be registered on
                    title: Buyer Department
                buyer_project:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Project the purchase is to be registered on
                    title: Buyer Project
                buyer_purchase_order_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Purchase order number to attribute to the order
                    title: Buyer Purchase Order Number
                buyer_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: 'General buyer reference field for information that
                        is not covered by the specific reference fields, e.g. PO-number.
                        Note: Maximum 140 characters'
                    title: Buyer Reference
                buyer_vat_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Vat number associated with the buyer company
                    title: Buyer Vat Number
                electronic_invoice_recipient:
                    anyOf:
                    -   $ref: '#/components/schemas/ElectronicInvoiceRecipient'
                    -   type: 'null'
                    default: null
                    description: Electronic invoice recipient
                line_items:
                    description: List of the line items that constitute the order
                    items:
                        $ref: '#/components/schemas/LineItemResponseSchema'
                    title: Line Items
                    type: array
                merchant_order_id:
                    description: Your order ID registered in your solution
                    title: Merchant Order Id
                    type: string
                merchant_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Field set by merchant for adding a reference to be
                        used internally by the merchant. Does not appear on invoice.
                    title: Merchant Reference
                merchant_user_id:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    description: Your internal ID of the user (the employee of your
                        business customer) registered for one-click purchase through
                        the Two Trade Account Onboarding API.
                    title: Merchant User Id
                billing_account_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: ID for the billing account linked to this order.
                        Can be set on order creation or order edit while the order
                        is still editable. A null value means no billing account is
                        linked. When set, billing account payment terms control repayment
                        scheduling.
                    title: Billing Account Id
                date_created:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Order creation date (UTC)
                    title: Date Created
                date_updated:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Order update date (UTC)
                    title: Date Updated
                merchant_additional_info:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Additional info the merchant can connect to the order
                    title: Merchant Additional Info
                recurring_details:
                    anyOf:
                    -   $ref: '#/components/schemas/RecurringDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Currently not available
                invoice_details:
                    description: Invoice details are not provided initially for a
                        buyer initiated latent order
                    title: Invoice Details
                    type: 'null'
                merchant_id:
                    description: A globally unique merchant ID set by Two.
                    format: uuid
                    title: Merchant Id
                    type: string
                merchant_short_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The short form name of the merchant
                    title: Merchant Short Name
                merchant_logo_path:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The logo URL of the merchant
                    title: Merchant Logo Path
                merchant_urls:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderMerchantUrlsSchema'
                    -   type: 'null'
                    default: null
                    description: List of urls hosted by the merchant.
                payment_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: '''Redirect the user to Two hosted page to verify
                        the payment.'
                    title: Payment Url
                invoice_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to the invoice pdf. E.g.
                    title: Invoice Url
                credit_note_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to the credit note pdf
                    title: Credit Note Url
                event_log_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: This url returns a list of all events that are associated
                        with the order
                    title: Event Log Url
                shipping_details:
                    anyOf:
                    -   $ref: '#/components/schemas/ShippingDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Optional shipping details to track the shipment
                original_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: The original order id has been deprecated in favor
                        of root_order_id, please use root_order_id instead
                    title: Original Order Id
                root_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The root order id
                    title: Root Order Id
                parent_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The parent order id
                    title: Parent Order Id
                external_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Your external order id
                    title: External Order Id
                external_order_status:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Your external order status
                    title: External Order Status
                decline_reason:
                    anyOf:
                    -   $ref: '#/components/schemas/DeclineReasonEnum'
                    -   type: 'null'
                    default: null
                    description: Reason for order being declined
                recourse_decision_reason:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reason for recourse decision
                    title: Recourse Decision Reason
                order_note:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: General note/message from the buyer to the merchant
                    title: Order Note
                order_origination:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderOriginationEnum'
                    -   type: 'null'
                    default: null
                    description: IN_STORE orders are not enabled by default. Please
                        reach out to us if you would like to discuss IN_STORE orders.
                billing_address:
                    $ref: '#/components/schemas/BuyerInitiatedLatentOrderAddressResponseSchema'
                    description: Billing address details are not provided initially
                        for a buyer initiated latent order
                shipping_address:
                    $ref: '#/components/schemas/BuyerInitiatedLatentOrderAddressResponseSchema'
                    description: Shipping address details are not provided initially
                        for a buyer initiated latent order
                date_fulfilled:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    description: Date when the order was fulfilled (UTC)
                    title: Date Fulfilled
                tracking_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: 'The tracking_id from `POST /order_intent` '
                    title: Tracking Id
                vendor_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The id of the vendor
                    title: Vendor Id
                refunds:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/CreateRefundResponseSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: Refunds attached to this order
                    title: Refunds
                order_revision:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: Order revision
                    title: Order Revision
                vendor_name:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    description: The name of the vendor
                    title: Vendor Name
                elapsed_time_ms:
                    anyOf:
                    -   additionalProperties: true
                        type: object
                    -   type: 'null'
                    default: null
                    title: Elapsed Time Ms
                invoice_insurance_provider:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceInsuranceDecisionEnum'
                    -   type: 'null'
                    default: null
                    description: The insurance provider
                tax_subtotals:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/TaxSubtotalSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of tax subtotals for unique tax brackets
                    title: Tax Subtotals
                approved_on_recourse:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    title: Approved On Recourse
                recourse_fallback_enabled:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: Deprecated. Use approved_on_recourse.
                    deprecated: true
                    title: Recourse Fallback Enabled
                merchant_display_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The display name of the merchant
                    title: Merchant Display Name
                terms:
                    anyOf:
                    -   description: For backwards compatibility, `type` can be omitted
                            for instalment terms, if the fields period and number_of_instalments
                            are populated. It is recommended that that clients always
                            provide a type value.
                        discriminator:
                            mapping:
                                INSTALMENTS: '#/components/schemas/OrderInstalmentTerms'
                                NET_TERMS: '#/components/schemas/OrderNetTerms'
                            propertyName: type
                        oneOf:
                        -   $ref: '#/components/schemas/OrderInstalmentTerms'
                        -   $ref: '#/components/schemas/OrderNetTerms'
                    -   type: 'null'
                    default: null
                    description: The terms of this order
                    title: Terms
                lending_terms:
                    anyOf:
                    -   $ref: '#/components/schemas/OrderLendingTermsSchema'
                    -   type: 'null'
                    default: null
                    description: The lending terms of this order associated with a
                        credit line
                credit_line_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: ID of the credit line used to fund the order, created
                        through the Two Credit Line API.
                    title: Credit Line Id
                invoice_distributed_by_merchant:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: If set to true, the invoice is distributed by the
                        merchant
                    title: Invoice Distributed By Merchant
                principal_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Total principal amount to be paid back for this order
                    title: Principal Amount
                buyer_finance_charge_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Total amount of interest/fees the buyer will pay
                        back by fully paying off this order
                    title: Buyer Finance Charge Amount
                preferred_distribution_method:
                    anyOf:
                    -   $ref: '#/components/schemas/DistributionMethodEnum'
                    -   type: 'null'
                    default: null
                    description: Allows merchant to set the method of distribution
                        for the invoice and credit notes of the order, if not set
                        will default to all methods
            required:
            - order_placed_date
            - gross_amount
            - payable_amount
            - invoice_amount
            - prepaid_amount
            - net_amount
            - currency
            - discount_amount
            - discount_rate
            - tax_amount
            - invoice_type
            - order_type
            - status
            - buyer
            - line_items
            - merchant_order_id
            - invoice_details
            - merchant_id
            - billing_address
            - shipping_address
            title: BuyerInitiatedLatentOrderResponseSchema
            type: object
        LatentOrderStatusEnum:
            enum:
            - QUOTED
            - CANCELLED
            - EXPIRED
            title: LatentOrderStatusEnum
            type: string
        FulfilledOrdersResponseSchema:
            properties:
                fulfilled_orders:
                    description: List of orders attached to the partially fulfilled
                        order
                    items:
                        $ref: '#/components/schemas/OrderResponseSchema'
                    title: Fulfilled Orders
                    type: array
                refunds:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/CreateRefundResponseSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    title: Refunds
            required:
            - fulfilled_orders
            title: FulfilledOrdersResponseSchema
            type: object
        FulfillOrderSchema:
            properties:
                invoice_issue_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Issue Date
                invoice_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Unique, sequential ID for invoices. Set by the merchant
                        if allowed; otherwise, auto-generated. Must follow an increasing
                        order for traceability and compliance. Cannot be manually
                        set for orders in Norway.
                    title: Invoice Number
                partial:
                    anyOf:
                    -   $ref: '#/components/schemas/PartialFulfillOrderSchema'
                    -   type: 'null'
                    default: null
                    description: The partially fulfilled order
                reverse_tax_liable:
                    default: false
                    description: Adds note 'Reverse charge according to Chapter 1,
                        Section 2, first paragraph, 4 of the Value Added Tax Act (1994:200)'
                        to invoice
                    title: Reverse Tax Liable
                    type: boolean
            title: FulfillOrderSchema
            type: object
        PartialFulfillOrderSchema:
            example:
                discount_amount: '0'
                gross_amount: '100'
                line_items:
                -   description: This is a nice game
                    details:
                        barcodes:
                        -   type: SKU
                            value: 5954d9e0-ebfb-4498-86a9-3141e8942dc8
                        -   type: UPC
                            value: cece4007-028c-469c-b0d2-2c038b583b69
                        brand: CD Projekt Red
                        categories:
                        - Games
                        - Entertainment
                        part_number: n/a
                    discount_amount: '0'
                    gross_amount: '100'
                    image_url: https://www.exampleobjects.com/product-image-800x600
                    name: Witcher III - The wild hunt
                    net_amount: '100'
                    product_page_url: https://www.example.com/products/7e34f2a8d
                    quantity: 1
                    quantity_unit: pcs
                    tax_amount: '0'
                    tax_class_name: VAT 0%
                    tax_rate: '0.0'
                    type: DIGITAL
                    unit_price: '100'
                net_amount: '100'
                tax_amount: '0'
            properties:
                gross_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: net_amount + tax_amount for the order amount that
                        is being partially fulfilled
                    title: Gross Amount
                net_amount:
                    description: Net amount for the order amount that is being partially
                        fulfilled
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Net Amount
                    type: string
                discount_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: Deprecated, discount amount is only applicable at
                        line item level
                    examples:
                    - '0.00'
                    title: Discount Amount
                tax_amount:
                    description: net_amount * tax_rate
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                tax_subtotals:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/TaxSubtotalSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of tax subtotals for unique tax brackets
                    title: Tax Subtotals
                line_items:
                    description: List of the line items that constitute the partially
                        fulfilled order
                    items:
                        $ref: '#/components/schemas/LineItemRequestSchema'
                    minItems: 1
                    title: Line Items
                    type: array
            required:
            - gross_amount
            - line_items
            - net_amount
            - tax_amount
            - tax_subtotals
            title: PartialFulfillOrderSchema
            type: object
        IdempotencyHeader:
            additionalProperties: true
            properties:
                Idempotency-Key:
                    anyOf:
                    -   maxLength: 100
                        type: string
                    -   type: 'null'
                    default: null
                    title: Idempotency-Key
            title: IdempotencyHeader
            type: object
        FulfillOrderResponseSchema:
            properties:
                fulfilled_order:
                    $ref: '#/components/schemas/SimpleSchema'
                    description: The id of the partially fulfilled order
                remained_order:
                    anyOf:
                    -   $ref: '#/components/schemas/SimpleSchema'
                    -   type: 'null'
                    default: null
                    description: The id of the remained order after partial fulfillment
                elapsed_time_ms:
                    anyOf:
                    -   additionalProperties: true
                        type: object
                    -   type: 'null'
                    default: null
                    title: Elapsed Time Ms
            required:
            - fulfilled_order
            title: FulfillOrderResponseSchema
            type: object
        SimpleSchema:
            properties:
                id:
                    format: uuid
                    title: Id
                    type: string
            required:
            - id
            title: SimpleSchema
            type: object
        EditOrderRequestSchema:
            properties:
                gross_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: net_amount + tax_amount
                    examples:
                    - '100'
                    title: Gross Amount
                net_amount:
                    description: (quantity * unit_price) - discount_amount
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Net Amount
                    type: string
                currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: Currency code in ISO 4217 format. E.g. 'NOK'
                discount_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: Deprecated, discount amount is only applicable at
                        line item level
                    examples:
                    - '0.00'
                    title: Discount Amount
                discount_rate:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                        type: string
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: Deprecated, discount rate is only applicable at line
                        item level
                    examples:
                    - '0.00'
                    title: Discount Rate
                tax_amount:
                    description: net_amount * tax_rate
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                invoice_details:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceDetailsRequestSchema'
                    -   type: 'null'
                    default: null
                    description: Invoice details are provided by the merchant via
                        Merchant Portal when invoice_type is DIRECT_INVOICE, Two Bank
                        or a 3rd-party bank when invoice_type is FUNDED_INVOICE and
                        empty when invoice_type is CARD. Only editable for FUNDED_INVOICE
                        orders if the order is in UNVERIFIED state.
                recurring:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: If set to true, an invoice will be generated periodically
                        according to the specification provided in recurring_details
                    title: Recurring
                buyer_department:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The department the purchase is to be registered on
                    title: Buyer Department
                buyer_project:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The project the purchase is to be registered on
                    title: Buyer Project
                buyer_purchase_order_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The purchase order number the purchase should to
                        be registered on
                    title: Buyer Purchase Order Number
                buyer_reference:
                    anyOf:
                    -   maxLength: 140
                        type: string
                    -   type: 'null'
                    default: null
                    description: 'General buyer reference field for information that
                        is not covered by the specific reference fields, e.g. PO-number.
                        Note: Maximum 140 characters'
                    title: Buyer Reference
                line_items:
                    description: List of the line items that constitute the order
                    items:
                        $ref: '#/components/schemas/LineItemRequestSchema'
                    title: Line Items
                    type: array
                merchant_order_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Your order ID registered in your solution
                    title: Merchant Order Id
                merchant_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Field set by merchant for adding a reference to be
                        used internally by the merchant. Does not appear on invoice.
                    title: Merchant Reference
                merchant_additional_info:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Additional info the merchant can connect to the order
                    title: Merchant Additional Info
                recurring_details:
                    anyOf:
                    -   $ref: '#/components/schemas/RecurringDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Currently not available
                shipping_details:
                    anyOf:
                    -   $ref: '#/components/schemas/ShippingDetailsSchema'
                    -   type: 'null'
                    default: null
                    description: Optional shipping details to track the shipment
                order_note:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: General note/message from the buyer to the merchant
                    title: Order Note
                billing_account_id:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    description: ID for the billing account to link to this order.
                        Send null to remove an existing link. Do not pass terms when
                        setting billing_account_id; billing account payment terms
                        take precedence. Only allowed while the order is editable
                        (pre-fulfillment). The billing account buyer company must
                        match the order buyer company, must belong to the same merchant
                        as the order, and cannot be combined with INSTALMENTS terms
                        or terms.duration_days_calculated_from.
                    title: Billing Account Id
                billing_address:
                    $ref: '#/components/schemas/CreateAddressRequestSchema'
                    description: Order billing address
                shipping_address:
                    $ref: '#/components/schemas/CreateAddressRequestSchema'
                    description: Order shipping address
                tax_subtotals:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/TaxSubtotalSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of tax subtotals for unique tax brackets
                    title: Tax Subtotals
                terms:
                    anyOf:
                    -   description: For backwards compatibility, `type` can be omitted
                            for instalment terms, if the fields period and number_of_instalments
                            are populated. It is recommended that that clients always
                            provide a type value.
                        discriminator:
                            mapping:
                                INSTALMENTS: '#/components/schemas/OrderInstalmentTerms'
                                NET_TERMS: '#/components/schemas/OrderNetTerms'
                            propertyName: type
                        oneOf:
                        -   $ref: '#/components/schemas/OrderInstalmentTerms'
                        -   $ref: '#/components/schemas/OrderNetTerms'
                    -   type: 'null'
                    default: null
                    title: Terms
            required:
            - billing_address
            - currency
            - gross_amount
            - line_items
            - net_amount
            - shipping_address
            - tax_amount
            - tax_subtotals
            title: EditOrderRequestSchema
            type: object
        InvoiceDetailsWithStatusSchema:
            example:
                billing_period_id: 75bbbadc-95b0-4b4e-bade-3641204a135c
                due_date: '2026-01-31'
                due_in_days: '30'
                gross_amount: '200.00'
                id: ac8f7621-3214-478b-84ad-3f7ada4df83a
                invoice_number: string
                invoicing_group_id: string
                last_updated: '2023-07-07T13:00:25.552211'
                net_amount: '160.00'
                payee:
                    bban: string
                    bic: string
                    branch_sort_code: string
                    country_code: string
                    description: string
                    iban: string
                    local_account_number: string
                    organization_name: string
                    organization_number: string
                payment_reference: string
                payment_reference_message: string
                payment_reference_ocr: string
                payment_reference_type: string
                statement_number: '123'
                tax_amount: '40.00'
                total_collected_amount: '0.00'
                total_credited_amount: '0.00'
                total_paid_amount: '0.00'
                total_recoursed_amount: '0.00'
                unpaid_amount: '200.00'
            properties:
                payee:
                    anyOf:
                    -   $ref: '#/components/schemas/BankAccountSchema'
                    -   type: 'null'
                    default: null
                payment_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Payment Reference
                payment_reference_type:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Payment Reference Type
                payment_reference_message:
                    default: ''
                    description: Text that will be attached to the payment in order
                        for the merchant to reconcile the payment.
                    title: Payment Reference Message
                    type: string
                payment_reference_ocr:
                    default: ''
                    description: A string of numbers that will be attached to the
                        payment in order for the merchant to reconcile the payment.
                        E.g. "KID-nummer" in Norway.
                    title: Payment Reference Ocr
                    type: string
                payment_status:
                    anyOf:
                    -   $ref: '#/components/schemas/PaymentStatusEnum'
                    -   type: 'null'
                    default: null
                due_in_days:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    deprecated: true
                    description: Please add terms to order instead, with type NET_TERMS
                        and duration_days
                    title: Due In Days
                invoice_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Number
                invoice_issue_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Issue Date
                due_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    title: Due Date
                invoice_emails:
                    anyOf:
                    -   items:
                            format: email
                            type: string
                        type: array
                    -   type: 'null'
                    default: null
                    description: We will send invoices to all of the email addresses.
                    title: Invoice Emails
                id:
                    format: uuid
                    title: Id
                    type: string
                status:
                    anyOf:
                    -   $ref: '#/components/schemas/InvoiceStatusEnum'
                    -   type: 'null'
                    default: PENDING
                    description: Status of invoice, mainly interested if has a status
                        of REPLACED from an invoice edit
                invoice_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Invoice Url
                due_in_days_calculation_method:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Method for calculating payment terms (e.g., END_OF_MONTH,
                        END_OF_WEEK) at fulfillment.
                    title: Due In Days Calculation Method
                requested_due_in_days:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: The duration_days value requested at order creation,
                        before applying the due_in_days_calculation_method at fulfillment.
                    title: Requested Due In Days
                recourse_request_status:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Status of recourse request if one exists (PENDING,
                        APPROVED, REJECTED).
                    title: Recourse Request Status
                gross_amount:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Gross Amount
                    type: string
                net_amount:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Net Amount
                    type: string
                tax_amount:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Tax Amount
                    type: string
                total_paid_amount:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Total Paid Amount
                    type: string
                total_credited_amount:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Total Credited Amount
                    type: string
                total_collected_amount:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Total Collected Amount
                    type: string
                total_recoursed_amount:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Total Recoursed Amount
                    type: string
                unpaid_amount:
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Unpaid Amount
                    type: string
                statement_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Statement Number
                billing_period_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Billing Period Id
                last_updated:
                    format: date-time
                    title: Last Updated
                    type: string
            required:
            - id
            - gross_amount
            - net_amount
            - tax_amount
            - total_paid_amount
            - total_credited_amount
            - total_collected_amount
            - total_recoursed_amount
            - unpaid_amount
            - last_updated
            title: InvoiceDetailsWithStatusSchema
            type: object
        OrderRequestQueryList:
            properties:
                start_date:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: First date that should be included in the list of
                        orders.
                    title: Start Date
                end_date:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Last date that should be included in the list of
                        orders.
                    title: End Date
                limit:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: Limit the number of results per page to this number.
                    title: Limit
                page:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: Page number to display results for.
                    title: Page
                offset:
                    anyOf:
                    -   type: integer
                    -   type: 'null'
                    default: null
                    description: Number of offset results by (page parameter is disregarded
                        if provided).
                    title: Offset
            title: OrderRequestQueryList
            type: object
        OrderListRequestSchema:
            properties:
                items:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/OrderResponseSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of orders
                    title: Items
                page:
                    anyOf:
                    -   additionalProperties:
                            anyOf:
                            -   type: integer
                            -   type: 'null'
                        type: object
                    -   type: 'null'
                    default: null
                    description: Elements that describe paged endpoints
                    examples:
                    -   current: 1000
                        items: 100
                        limit: 10
                        pages: 1
                    title: Page
            title: OrderListRequestSchema
            type: object
        VerificationDataResponseSchema:
            properties:
                link_sent:
                    description: If a link to verify has been sent
                    title: Link Sent
                    type: boolean
                link_recipient_phone_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Phone number of the person most recently contacted
                        to verify the order
                    examples:
                    - +46XXXXXXXXXX
                    title: Link Recipient Phone Number
                link_timestamp:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Time the verification link was sent (UTC)
                    example: '2026-01-01 14:02:02.002222'
                    title: Link Timestamp
                link_verification_successful:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: null
                    description: If the link recipient has successfully verified
                    title: Link Verification Successful
            required:
            - link_sent
            title: VerificationDataResponseSchema
            type: object
        NotifyRequestSchema:
            description: |-
                Triggers buyer notifications.

                For trade account orders, notifications are sent to the contact information (phone/email)
                registered with the trade account, regardless of what's in the order.buyer object.
            example:
                channel: sms
            properties:
                channel:
                    $ref: '#/components/schemas/NotificationChannel'
            required:
            - channel
            title: NotifyRequestSchema
            type: object
        NotificationChannel:
            enum:
            - sms
            - email
            title: NotificationChannel
            type: string
        RefundRequestSchema:
            anyOf:
            -   $ref: '#/components/schemas/FullRefundRequestSchema'
            -   $ref: '#/components/schemas/PartialRefundRequestSchema'
            description: |-
                Refund request

                Can be either a full or a partial refund
            title: RefundRequestSchema
        FullRefundRequestSchema:
            example:
                amount: '100.00'
                currency: GBP
                reason: Example reason
            properties:
                order_revision:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    title: Order Revision
                reason:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reason for order refund
                    title: Reason
                refund_reference:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    title: Refund Reference
                buyer_refund_surcharges:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/BuyerRefundSurcharge'
                        type: array
                    -   type: 'null'
                    default: null
                    title: Buyer Refund Surcharges
                amount:
                    const: null
                    default: null
                    description: Gross amount being refunded
                    title: Amount
                    type: 'null'
                currency:
                    const: null
                    default: null
                    description: Currency refund is being issued in
                    title: Currency
                    type: 'null'
                upload_references:
                    anyOf:
                    -   items:
                            type: string
                        type: array
                    -   type: 'null'
                    default: null
                    description: references of externally uploaded credit notes
                    title: Upload References
            title: FullRefundRequestSchema
            type: object
        LineItemPrototypeSchema:
            properties:
                id:
                    format: uuid
                    title: Id
                    type: string
                name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Name
                description:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Description
                discount_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    title: Discount Amount
                gross_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    title: Gross Amount
                net_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    title: Net Amount
                quantity:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,8})?
                        type: string
                    -   type: 'null'
                    default: null
                    title: Quantity
                unit_price:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                        type: string
                    -   type: 'null'
                    default: null
                    title: Unit Price
                tax_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    title: Tax Amount
                tax_rate:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                        type: string
                    -   type: 'null'
                    default: null
                    title: Tax Rate
                tax_class_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Tax Class Name
                quantity_unit:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Quantity Unit
                image_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Image Url
                product_page_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Product Page Url
                type:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    title: Type
                details:
                    anyOf:
                    -   $ref: '#/components/schemas/ProductDetailsSchema'
                    -   type: 'null'
                    default: null
                vendor_name:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    title: Vendor Name
            required:
            - id
            title: LineItemPrototypeSchema
            type: object
        PartialRefundRequestSchema:
            properties:
                order_revision:
                    anyOf:
                    -   format: uuid
                        type: string
                    -   type: 'null'
                    default: null
                    title: Order Revision
                amount:
                    description: Gross amount being refunded
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Amount
                    type: string
                currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: Currency refund is being issued in
                line_items:
                    anyOf:
                    -   items:
                            anyOf:
                            -   $ref: '#/components/schemas/LineItemPrototypeSchema'
                            -   $ref: '#/components/schemas/LineItemRequestSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of the line items that are being refunded
                    title: Line Items
                reason:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reason for order refund
                    title: Reason
                tax_subtotals:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/TaxSubtotalSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of tax subtotals for unique tax brackets
                    title: Tax Subtotals
                buyer_refund_surcharges:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/BuyerRefundSurcharge'
                        type: array
                    -   type: 'null'
                    default: null
                    title: Buyer Refund Surcharges
                refund_reference:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    title: Refund Reference
                upload_references:
                    anyOf:
                    -   items:
                            type: string
                        type: array
                    -   type: 'null'
                    default: null
                    description: references of externally uploaded credit notes
                    title: Upload References
            required:
            - amount
            - currency
            - tax_subtotals
            title: PartialRefundRequestSchema
            type: object
        RefundSummaryResponseSchema:
            additionalProperties: true
            properties:
                id:
                    description: A globally unique ID set by Two.
                    format: uuid
                    title: Id
                    type: string
                amount:
                    deprecated: true
                    description: payable amount being refunded
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Amount
                    type: string
                total_amount:
                    description: payable_amount + prepaid_amount
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Total Amount
                    type: string
                payable_amount:
                    description: 'Amount due from the buyer to Two. Formula: invoice_amount
                        - prepaid_amount. This is the portion Two funds and takes
                        risk on.'
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Payable Amount
                    type: string
                prepaid_amount:
                    default: '0.00'
                    description: Prepaid amount refunded
                    examples:
                    - '100.00'
                    format: decimal
                    pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                    title: Prepaid Amount
                    type: string
                currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: Currency refund is being issued in
                    examples:
                    - GB
                refund_no:
                    deprecated: true
                    description: Refund number, please use credit_note_number. if
                        you supply your own credit note numbers and it contains non
                        numeric values this value will be null
                    title: Refund No
                    type: integer
                credit_note_number:
                    description: A unique, sequential identifier for credit notes,
                        similar to invoice_number. Follows a monotonically increasing
                        series to ensure chronological tracking, prevent duplicates,
                        and maintain auditability and compliance with financial regulations.
                    title: Credit Note Number
                    type: string
                credit_note_url:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Link to credit note issued by Two
                    title: Credit Note Url
                line_items:
                    anyOf:
                    -   items:
                            items:
                                $ref: '#/components/schemas/LineItemResponseSchema'
                            type: array
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of the line items that have been refunded
                    title: Line Items
                reason:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Reason for order refund
                    examples:
                    - Damage
                    title: Reason
                tax_subtotals:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/TaxSubtotalSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of tax subtotals for unique tax brackets
                    title: Tax Subtotals
                buyer_refund_surcharges:
                    anyOf:
                    -   items:
                            items:
                                $ref: '#/components/schemas/BuyerRefundSurcharge'
                            type: array
                        type: array
                    -   type: 'null'
                    default: null
                    description: List of the surcharges included in the refunds of
                        this order
                    title: Buyer Refund Surcharges
                refund_reference:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: null
                    title: Refund Reference
                refund_date:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    title: Refund Date
            required:
            - id
            - amount
            - total_amount
            - payable_amount
            - currency
            - refund_no
            - credit_note_number
            title: RefundSummaryResponseSchema
            type: object
        GetInvoiceRequestQueryList:
            properties:
                v:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional parameter `v=original` to download the original
                        invoice and not the credit note (if any)
                    examples:
                    - original
                    title: V
                lang:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Specify language to generate PDF [`en_US`, `nb_NO`,
                        `sv_SE`]
                    examples:
                    - en_US
                    title: Lang
                generate:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: 'false'
                    description: Optional parameter generate (defaults to false) to
                        help with testing or the need to re-create if the template
                        changes etc
                    title: Generate
            title: GetInvoiceRequestQueryList
            type: object
        GetInvoicesRequestQueryList:
            properties:
                v:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional parameter `v=original` to download the original
                        invoice and not the credit note (if any)
                    examples:
                    - original
                    title: V
                lang:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Specify language to generate PDF [`en_US`, `nb_NO`,
                        `sv_SE`]
                    examples:
                    - en_US
                    title: Lang
                generate:
                    anyOf:
                    -   type: boolean
                    -   type: 'null'
                    default: 'false'
                    description: Optional parameter generate (defaults to false) to
                        help with testing or the need to re-create if the template
                        changes etc
                    title: Generate
                order_id:
                    description: Order IDs of the invoices, provided multiple times
                        as a query parameter
                    format: uuid
                    title: Order Id
                    type: string
            required:
            - order_id
            title: GetInvoicesRequestQueryList
            type: object
        EditInvoiceRequestSchema:
            properties:
                buyer_purchase_order_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Order purchase number being edited
                    title: Buyer Purchase Order Number
                buyer_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: New value for buyer reference on order
                    title: Buyer Reference
                order_note:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Notes associated with invoice edit
                    title: Order Note
                buyer_project:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: New value for buyer project on order
                    title: Buyer Project
                billing_address:
                    anyOf:
                    -   $ref: '#/components/schemas/CreateAddressRequestSchema'
                    -   type: 'null'
                    default: null
                    description: Order billing address
                line_item_updates:
                    anyOf:
                    -   items:
                            $ref: '#/components/schemas/InvoiceLineItemChangeRequestSchema'
                        type: array
                    -   type: 'null'
                    default: null
                    description: Changes to existing line items
                    title: Line Item Updates
            title: EditInvoiceRequestSchema
            type: object
        InvoiceLineItemChangeRequestSchema:
            properties:
                id:
                    description: ID of line item to change
                    format: uuid
                    title: Id
                    type: string
                name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: short name of the product
                    title: Name
                line_item_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Your line item reference
                    title: Line Item Reference
                discount_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Discount applied to line item (defaults to 0.0),
                        excluded tax
                    examples:
                    - '0.00'
                    title: Discount Amount
                gross_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: net_amount + tax_amount
                    examples:
                    - '100.00'
                    title: Gross Amount
                net_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: (quantity * unit_price) - discount_amount
                    examples:
                    - '100.00'
                    title: Net Amount
                quantity:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,8})?
                        type: string
                    -   type: 'null'
                    description: Number of units for the specific line item (up to
                        8 decimal places)
                    examples:
                    - '1'
                    title: Quantity
                unit_price:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                        type: string
                    -   type: 'null'
                    description: The price of one unit excluding tax and discount
                        (up to 6 decimal places)
                    examples:
                    - '100.00'
                    title: Unit Price
                tax_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: net_amount * tax_rate
                    examples:
                    - '0.00'
                    title: Tax Amount
                tax_rate:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,6})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Tax rate on the line item level
                    examples:
                    - '0.00'
                    title: Tax Rate
                tax_class_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: A description of the tax class (e.g. 'VAT 20%')
                    examples:
                    - VAT 0%
                    title: Tax Class Name
                quantity_unit:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Unit like kg, l, pcs, etc.
                    examples:
                    - pcs
                    title: Quantity Unit
            required:
            - id
            - quantity
            - unit_price
            title: InvoiceLineItemChangeRequestSchema
            type: object
        EditInvoiceEmailsRequest:
            properties:
                email_addresses:
                    items:
                        type: string
                    title: Email Addresses
                    type: array
            required:
            - email_addresses
            title: EditInvoiceEmailsRequest
            type: object
        InvoiceCreationRequestSchema:
            description: |-
                Request schema for invoice creation operation.

                Creates an invoice for one or more verified orders atomically.
                For multiple orders, consolidates them into a single order before fulfillment.

                Note: When merging multiple orders, the first order's invoicing details
                (billing address, etc.) will be used for the consolidated invoice.
            properties:
                order_ids:
                    description: List of order IDs to create invoice for (minimum
                        1). All orders must be in VERIFIED or CONFIRMED state and
                        belong to the same buyer/merchant.
                    items:
                        type: string
                    title: Order Ids
                    type: array
                merchant_order_id:
                    description: Merchant order ID for the invoice.
                    title: Merchant Order Id
                    type: string
                merchant_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Optional merchant reference for the invoice
                    title: Merchant Reference
            required:
            - order_ids
            - merchant_order_id
            title: InvoiceCreationRequestSchema
            type: object
        InvoiceCreationResponseSchema:
            description: |-
                Response schema for successful invoice creation operation.

                Returns the ID of the order in FULFILLING state that represents the invoice.
            properties:
                id:
                    description: UUID of the order in FULFILLING state representing
                        the created invoice
                    title: Id
                    type: string
            required:
            - id
            title: InvoiceCreationResponseSchema
            type: object
        CreateMerchantAPIKeyResponseSchema:
            properties:
                id:
                    description: Unique identifier of the API key
                    format: uuid
                    title: Id
                    type: string
                hint:
                    description: Hint for the API key (last 4 characters)
                    title: Hint
                    type: string
                label:
                    description: Label for the API key (e.g. how it was created)
                    title: Label
                    type: string
                date_created:
                    description: Date that the API key was created (UTC)
                    format: date-time
                    title: Date Created
                    type: string
                date_last_used:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Date that the API key was last used (UTC)
                    title: Date Last Used
                date_expiry:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Date that the API key expires (UTC)
                    title: Date Expiry
                usage_count:
                    description: Number of times the API key has been used
                    title: Usage Count
                    type: integer
                merchant_id:
                    description: Unique identifier of the merchant
                    format: uuid
                    title: Merchant Id
                    type: string
                api_key:
                    description: Newly created API key to pass with X-Api-Key header
                    title: Api Key
                    type: string
            required:
            - id
            - hint
            - label
            - date_created
            - usage_count
            - merchant_id
            - api_key
            title: CreateMerchantAPIKeyResponseSchema
            type: object
        MerchantAPIKeyResponseSchemaList:
            items:
                $ref: '#/components/schemas/MerchantAPIKeyResponseSchema'
            title: MerchantAPIKeyResponseSchemaList
            type: array
        MerchantAPIKeyResponseSchema:
            properties:
                id:
                    description: Unique identifier of the API key
                    format: uuid
                    title: Id
                    type: string
                hint:
                    description: Hint for the API key (last 4 characters)
                    title: Hint
                    type: string
                label:
                    description: Label for the API key (e.g. how it was created)
                    title: Label
                    type: string
                date_created:
                    description: Date that the API key was created (UTC)
                    format: date-time
                    title: Date Created
                    type: string
                date_last_used:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Date that the API key was last used (UTC)
                    title: Date Last Used
                date_expiry:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    default: null
                    description: Date that the API key expires (UTC)
                    title: Date Expiry
                usage_count:
                    description: Number of times the API key has been used
                    title: Usage Count
                    type: integer
                merchant_id:
                    description: Unique identifier of the merchant
                    format: uuid
                    title: Merchant Id
                    type: string
            required:
            - id
            - hint
            - label
            - date_created
            - usage_count
            - merchant_id
            title: MerchantAPIKeyResponseSchema
            type: object
        PaginatedSettlementListCursorSchema:
            properties:
                items:
                    items:
                        $ref: '#/components/schemas/Settlement'
                    title: Items
                    type: array
                cursor_page_metadata:
                    $ref: '#/components/schemas/CursorPageMetadata'
            required:
            - items
            - cursor_page_metadata
            title: PaginatedSettlementListCursorSchema
            type: object
        CursorPageMetadata:
            properties:
                previous_page_cursor:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: cursor to the previous page
                    title: Previous Page Cursor
                next_page_cursor:
                    anyOf:
                    -   minLength: 1
                        type: string
                    -   type: 'null'
                    default: cursor to the next page
                    title: Next Page Cursor
                limit:
                    description: The maximum number of items on a single page, ie
                        the page size.
                    minimum: 0
                    title: Limit
                    type: integer
            required:
            - limit
            title: CursorPageMetadata
            type: object
        Settlement:
            properties:
                settlement_id:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: The global settlement ID.
                    title: Settlement Id
                settlement_date:
                    anyOf:
                    -   format: date
                        type: string
                    -   type: 'null'
                    default: null
                    description: Date of the settlement payout
                    title: Settlement Date
                recipient_account_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Recipient account number.
                    title: Recipient Account Number
                recipient_account_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Recipient account name.
                    title: Recipient Account Name
                recipient_iban:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Recipient account IBAN.
                    title: Recipient Iban
                recipient_bban:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Recipient account BBAN.
                    title: Recipient Bban
                funding_provider:
                    description: Funding provider
                    title: Funding Provider
                    type: string
                funding_provider_account_holder_name:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Funding provider account name.
                    title: Funding Provider Account Holder Name
                funding_provider_account_number:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Funding provider account number.
                    title: Funding Provider Account Number
                payout_currency:
                    $ref: '#/components/schemas/CurrencyEnum'
                    description: Payout currency.
                    examples:
                    - GBP
                payout_amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    default: null
                    description: Payout amount.
                    examples:
                    - '10000.00'
                    title: Payout Amount
                payment_reference:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: null
                    description: Payment reference.
                    title: Payment Reference
            required:
            - funding_provider
            - payout_currency
            title: Settlement
            type: object
        GetStatementRequestQuerySchema:
            properties:
                start_date:
                    description: The first date that should be included in the statement.
                    examples:
                    - '2023-01-01'
                    title: Start Date
                    type: string
                end_date:
                    description: The last date that should be included in the statement.
                    examples:
                    - '2023-01-31'
                    title: End Date
                    type: string
                filetype:
                    anyOf:
                    -   type: string
                    -   type: 'null'
                    default: xlsx
                    description: The filetype of the statement file. Two currently
                        supports csv and xlsx as value for the filetype parameter.
                        Default is xlsx.
                    title: Filetype
                country_code:
                    default: 'NO'
                    description: The country code of the payout account you want to
                        extract a settlement file for. Country code in ISO 3166 alpha-2
                        format
                    examples:
                    - GB
                    title: Country Code
                    type: string
            required:
            - start_date
            - end_date
            title: GetStatementRequestQuerySchema
            type: object
        ReconOutcomeEventsRequestSchema:
            properties:
                transactions:
                    description: 'List of transactions e.g: Payin, credit notes and
                        credit losses for the given order ID.'
                    items:
                        $ref: '#/components/schemas/ReconOutcomeEventSchema'
                    minItems: 1
                    title: Transactions
                    type: array
            required:
            - transactions
            title: ReconOutcomeEventsRequestSchema
            type: object
        ReconOutcomeEventSchema:
            properties:
                id:
                    description: Reference ID of this specific event in your system.
                    title: Id
                    type: string
                type:
                    anyOf:
                    -   $ref: '#/components/schemas/ReconOutcomeEventTypeEnum'
                    -   type: 'null'
                    description: This event type can be either Payin, Credit Note,
                        or Credit Loss
                amount:
                    anyOf:
                    -   format: decimal
                        pattern: ^-?[0-9]+(\.[0-9]{0,2})?
                        type: string
                    -   type: 'null'
                    description: Non-negative amount to be reconciled against this
                        event
                    title: Amount
                time:
                    anyOf:
                    -   format: date-time
                        type: string
                    -   type: 'null'
                    description: Datetime for the event occured (UTC)
                    title: Time
            required:
            - id
            - type
            - amount
            - time
            title: ReconOutcomeEventSchema
            type: object
        ReconOutcomeEventTypeEnum:
            enum:
            - PAYIN
            - CREDIT_NOTE
            - CREDIT_LOSS
            title: ReconOutcomeEventTypeEnum
            type: string
    securitySchemes:
        X-Api-Key:
            type: apiKey
            description: |-
                For instructions on how to obtain API keys, visit [this page](/docs/guides/getting-api-keys-page/).
                You will obtain two different keys, an initial one for testing in our sandbox environment and once ready, for production.
                Your API keys enables others to act on your behalf if they are able to obtain them, so make sure to keep them safe.
                Your API key is not to be shared with anyone, including in your version control system, client-side code, in public chatrooms and so on.
                The API key is applied in the request header. For example:
                ```
                GET /something
                X-Api-Key: secret_test_aabbccddeeff0123456789
                ```

                API Keys have the following structure: `secret_<env>_<key>` where:
                - `env` is determined by the environment (`prod` for production, `test` for test environments)
                - `key` is a random, URL-safe, 64-bit encoded text string containing 32 random bytes.
            name: X-Api-Key
            in: header
servers:
-   url: https://api.sandbox.two.inc
    description: Testing
-   url: https://api.two.inc
    description: Production
security: []