> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jupico.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create multiple invites

> Creates multiple onboarding invites in a single request, for bulk merchant migrations. Set `dryRun` to `true` to validate the batch without creating any invites.



## OpenAPI

````yaml /openapi.json post /v1/onboardinginvites/createmany
openapi: 3.0.0
info:
  title: Jupico - OpenAPI 3.0
  description: >-
    The Jupico API lets Service Providers onboard merchants, process card and
    eCheck (ACH) payments, run hosted payment pages, manage recurring billing,
    send payouts, and query every resource. All endpoints use HTTPS with Basic
    authentication and accept and return JSON. Endpoints are grouped by
    workflow: onboard merchants first, then accept payments, then move funds and
    report.
  termsOfService: https://help.jupico.com/references-and-resources/legal
  contact:
    email: support@jupico.com
  license:
    name: Jupico License
    url: https://jupico.com
  version: 1.0.5
servers:
  - url: https://sandbox-platform.jupico.com
security:
  - basicAuth: []
tags:
  - name: Status
    description: Health check for the Jupico API.
  - name: Onboarding Invites
    description: >-
      Create and send invites that onboard merchants through the Jupico-hosted
      flow, with optional pre-filled identity, fees, and payout bank account
      data.
  - name: Provisioning
    description: >-
      Onboard merchants from your own UI. Collect onboarding data and submit it
      through the provisioning chain: applicant → application → submerchant.
  - name: Session
    description: >-
      Create browser authorization sessions for the Jupico web components, so
      card and bank account data is tokenized client-side and never touches your
      servers.
  - name: Tokenization
    description: >-
      Convert one-time tokens from the web components into permanent Jupico
      tokens, or tokenize raw card data if your systems are PCI DSS compliant.
  - name: Customer
    description: >-
      Create and manage customer records that payments, subscriptions,
      installments, and invoices link to.
  - name: Card Transactions
    description: >-
      Process credit and debit card transactions using tokenized card data:
      sale, authorization, capture, void, refund, and rollback.
  - name: eCheck Transactions
    description: >-
      Debit customer bank accounts via eCheck (ACH): sale, void, refund,
      rollback, and bank account tokenization.
  - name: Checkouts
    description: >-
      Hosted checkout sessions where customers complete payment on a
      Jupico-hosted page.
  - name: Payment Links
    description: >-
      Shareable links that open a Jupico-hosted payment page — no integration
      code needed at the point of sharing.
  - name: Invoices
    description: Create and email invoices that customers pay online.
  - name: Subscriptions
    description: >-
      Recurring billing. Plans define billing schedules and pricing models;
      subscriptions enroll customers against a stored payment token.
  - name: Installments
    description: Split a fixed total into scheduled payments with an optional deposit.
  - name: Payouts
    description: >-
      Send funds from a submerchant's available balance to a tokenized bank
      account with on-demand payout instructions.
  - name: Query
    description: >-
      Search and report across every resource: transactions, merchants,
      settlements, balances, disputes, fees, and more. All query endpoints
      accept the same filter, sort, and pagination envelope — see the Query
      Capabilities guide.
paths:
  /v1/onboardinginvites/createmany:
    post:
      tags:
        - Onboarding Invites
      summary: Create multiple invites
      description: >-
        Creates multiple onboarding invites in a single request, for bulk
        merchant migrations. Set `dryRun` to `true` to validate the batch
        without creating any invites.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                invites:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                        description: The name of the individual or entity being invited.
                        example: John Doe
                      email:
                        type: string
                        format: email
                        description: The email address of the invitee.
                        example: example@example.com
                      phoneNumber:
                        type: string
                        description: The phone number of the invitee.
                        example: '2232322323'
                      reference:
                        type: string
                        description: A reference identifier for the invite.
                        example: Reference 123
                      identity:
                        type: object
                        properties:
                          owners:
                            $ref: '#/components/schemas/Owner'
                          business:
                            $ref: '#/components/schemas/Business'
                          contact:
                            $ref: '#/components/schemas/Contact'
                        description: >-
                          The identity object containing data about the business
                          and its representatives
                      payoutBankAccounts:
                        type: array
                        items:
                          type: object
                          properties:
                            accountRouting:
                              type: string
                              example: '123123122'
                              description: 9-digit ABA routing number.
                            accountNumber:
                              type: string
                              example: '8789545642'
                              description: Bank account number.
                            accountType:
                              type: string
                              enum:
                                - checking
                              example: checking
                              description: Bank account type, such as `checking`.
                            nameOnAccount:
                              type: string
                              example: Updatedjonnydooeiacc
                              description: Name on the bank account.
                        description: Bank accounts where the merchant receives payouts.
                      feesTemplateId:
                        description: >-
                          UUID of the fees template with predefined fees. If no
                          value is passed, the id of the default template will
                          be used.
                        type: string
                      fees:
                        description: >-
                          The fees object will overwrite the values set on the
                          fees template, as specified by the feesTemplateId.
                          This allows for customization of fees at the invite
                          overriding any defaults defined in the template.
                        type: object
                        properties:
                          platform:
                            type: object
                            properties:
                              interchange:
                                type: object
                                properties:
                                  enabled:
                                    type: boolean
                                    example: false
                                    description: Whether this setting is enabled.
                                  billTo:
                                    type: string
                                    enum:
                                      - spProduct
                                      - submerchant
                                    example: spProduct
                                    description: >-
                                      Which party is billed for this fee:
                                      `spProduct` (the Service Provider) or
                                      `submerchant` (the merchant).
                                description: Interchange pass-through fee settings.
                              perTransaction:
                                type: object
                                properties:
                                  ccCnpSale:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 2
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0.3
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each card-not-present sale.
                                  ccCnpCapture:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 2
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0.3
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: >-
                                      Fee applied to each card-not-present
                                      capture.
                                  ccCnpAuth:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 2
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0.25
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: >-
                                      Fee applied to each card-not-present
                                      authorization.
                                  ccCnpVoid:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each card-not-present void.
                                  ccCnpRefund:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: >-
                                      Fee applied to each card-not-present
                                      refund.
                                  ccCnpCredit:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: >-
                                      Fee applied to each card-not-present
                                      credit.
                                  ccCnpReversal:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: >-
                                      Fee applied to each card-not-present
                                      reversal.
                                  ccCnpChargeback:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 25
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each chargeback.
                                  ccCnpAvsOnly:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each AVS-only verification.
                                  ccCnpDeclined:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.5
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: >-
                                      Fee applied to each declined
                                      card-not-present attempt.
                                  checkSale:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 2.9
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0.3
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each eCheck sale.
                                  checkVerification:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 0
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each eCheck verification.
                                  checkVoid:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each eCheck void.
                                  checkRefund:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each eCheck refund.
                                  checkCredit:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each eCheck credit.
                                  checkReversal:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each eCheck reversal.
                                description: >-
                                  Event-based fees, one entry per transaction
                                  event type.
                              perPeriod:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    period:
                                      type: string
                                      example: daily
                                      enum:
                                        - today
                                        - yesterday
                                        - last-7-days
                                        - this-month
                                        - this-year
                                        - last-6-months
                                        - one-time
                                        - daily
                                        - weekly
                                        - monthly
                                        - quarterly
                                        - per-semester
                                        - annually
                                      description: Billing period for this recurring fee.
                                    fixed:
                                      type: number
                                      example: 3
                                      description: >-
                                        Fixed fee amount charged each time this
                                        event occurs.
                                    since:
                                      type: string
                                      format: date-time
                                      example: '2025-08-01T03:00:00.000Z'
                                      description: >-
                                        Start of the window during which this
                                        fee applies (ISO 8601).
                                    until:
                                      type: string
                                      format: date-time
                                      example: '2025-08-23T03:00:00.000Z'
                                      description: >-
                                        End of the window during which this fee
                                        applies (ISO 8601).
                                    status:
                                      type: string
                                      example: enabled
                                      description: >-
                                        Whether this recurring fee is currently
                                        active.
                                    isTriggerFirstTx:
                                      type: boolean
                                      example: false
                                      description: >-
                                        When true, the recurring fee starts only
                                        after the merchant processes their first
                                        transaction.
                                    isProrated:
                                      type: boolean
                                      example: true
                                      description: >-
                                        Whether the first billing period is
                                        prorated.
                                description: >-
                                  Recurring fees charged on a fixed schedule,
                                  such as monthly service fees.
                            description: Fee configuration at the platform level.
                          spProduct:
                            type: object
                            properties:
                              interchange:
                                type: object
                                properties:
                                  enabled:
                                    type: boolean
                                    example: false
                                    description: Whether this setting is enabled.
                                  billTo:
                                    type: string
                                    example: submerchant
                                    description: >-
                                      Which party is billed for this fee:
                                      `spProduct` (the Service Provider) or
                                      `submerchant` (the merchant).
                                description: Interchange pass-through fee settings.
                              perTransaction:
                                type: object
                                properties:
                                  ccCnpSale:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 2
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0.3
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each card-not-present sale.
                                  ccCnpCapture:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 2
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0.3
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: >-
                                      Fee applied to each card-not-present
                                      capture.
                                  ccCnpAuth:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 2
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0.25
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: >-
                                      Fee applied to each card-not-present
                                      authorization.
                                  ccCnpVoid:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each card-not-present void.
                                  ccCnpRefund:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: >-
                                      Fee applied to each card-not-present
                                      refund.
                                  ccCnpCredit:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: >-
                                      Fee applied to each card-not-present
                                      credit.
                                  ccCnpReversal:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: >-
                                      Fee applied to each card-not-present
                                      reversal.
                                  ccCnpChargeback:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 25
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each chargeback.
                                  ccCnpAvsOnly:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each AVS-only verification.
                                  ccCnpDeclined:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.5
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: >-
                                      Fee applied to each declined
                                      card-not-present attempt.
                                  checkSale:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 2.9
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0.3
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each eCheck sale.
                                  checkVerification:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      discountRate:
                                        type: number
                                        example: 0
                                        description: >-
                                          Percentage fee charged on the event
                                          amount.
                                      fixed:
                                        type: number
                                        example: 0
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                    description: Fee applied to each eCheck verification.
                                  checkVoid:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each eCheck void.
                                  checkRefund:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each eCheck refund.
                                  checkCredit:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each eCheck credit.
                                  checkReversal:
                                    type: object
                                    properties:
                                      billTo:
                                        type: string
                                        enum:
                                          - spProduct
                                          - submerchant
                                        example: spProduct
                                        description: >-
                                          Which party is billed for this fee:
                                          `spProduct` (the Service Provider) or
                                          `submerchant` (the merchant).
                                      fixed:
                                        type: number
                                        example: 0.75
                                        description: >-
                                          Fixed fee amount charged each time this
                                          event occurs.
                                      reverseFixed:
                                        type: boolean
                                        example: false
                                        description: >-
                                          Whether the fixed fee is returned when
                                          the underlying transaction is reversed.
                                      reverseDiscountRate:
                                        type: boolean
                                        example: true
                                        description: >-
                                          Whether the percentage fee is returned
                                          when the underlying transaction is
                                          reversed.
                                    description: Fee applied to each eCheck reversal.
                                description: >-
                                  Event-based fees, one entry per transaction
                                  event type.
                              perPeriod:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    period:
                                      type: string
                                      example: daily
                                      enum:
                                        - today
                                        - yesterday
                                        - last-7-days
                                        - this-month
                                        - this-year
                                        - last-6-months
                                        - one-time
                                        - daily
                                        - weekly
                                        - monthly
                                        - quarterly
                                        - per-semester
                                        - annually
                                      description: Billing period for this recurring fee.
                                    fixed:
                                      type: number
                                      example: 3
                                      description: >-
                                        Fixed fee amount charged each time this
                                        event occurs.
                                    since:
                                      type: string
                                      format: date-time
                                      example: '2025-08-01T03:00:00.000Z'
                                      description: >-
                                        Start of the window during which this
                                        fee applies (ISO 8601).
                                    until:
                                      type: string
                                      format: date-time
                                      example: '2025-08-23T03:00:00.000Z'
                                      description: >-
                                        End of the window during which this fee
                                        applies (ISO 8601).
                                    status:
                                      type: string
                                      example: enabled
                                      description: >-
                                        Whether this recurring fee is currently
                                        active.
                                    isTriggerFirstTx:
                                      type: boolean
                                      example: false
                                      description: >-
                                        When true, the recurring fee starts only
                                        after the merchant processes their first
                                        transaction.
                                    isProrated:
                                      type: boolean
                                      example: true
                                      description: >-
                                        Whether the first billing period is
                                        prorated.
                                description: >-
                                  Recurring fees charged on a fixed schedule,
                                  such as monthly service fees.
                            description: >-
                              Fee configuration at the Service Provider product
                              level.
                      onboardingFlowTemplateId:
                        type: string
                        description: >-
                          UUID of the onboarding flow template to be used for
                          the onboarding experience.
                        example: ''
                  description: >-
                    Invites to create. Each entry follows the create-invite
                    schema.
                dryRun:
                  type: boolean
                  description: >-
                    A flag indicating whether the operation should be run in dry
                    run mode (true) or not (false).
              example:
                invites:
                  - name: Tech
                    email: test@gmail.com
                    phoneNumber: '2995318324'
                    reference: '1234'
                    identity:
                      owners:
                        - title: Mr.
                          firstName: jonny
                          middleName: eric
                          lastName: dooei
                          birthDate: '2000-08-01'
                          phoneNumber: '2232322323'
                          streetNum: '79'
                          streetName: clarks
                          city: ny
                          state: NY
                          postalCode: '23434'
                          ssn: '123123123'
                          ownershipPercentage: 100
                          email: mail_m@asd.com
                  - name: Tech2
                    email: test2@gmail.com
                    phoneNumber: '2995318325'
                    reference: '1235'
                    identity:
                      business:
                        legalName: testInvite
                        dbaName: testDBAInvite
                        federalTaxId: '999999999'
                        tinType: SSN
                        phoneNumber: '2232322323'
                        address:
                          streetNum: '123'
                          streetName: main street
                          city: ny
                          state: NY
                          postalCode: '22222'
                        websiteUrl: https://www.sarasa.com
                        ownershipType: SoleProprietorship
                        businessEstablishedDate: '2023-11-02'
                        expectedMonthlyVolume: 200
                payoutBankAccounts:
                  - accountRouting: '123123122'
                    accountNumber: '8789545642'
                    accountType: checking
                    nameOnAccount: Updatedjonnydooeiacc
                dryRun: true
      responses:
        '200':
          $ref: '#/components/responses/createManyOnboardingInvites'
        '400':
          description: Bad Request. Invalid input.
        '401':
          description: Unauthorized.
        '500':
          description: Internal Server Error.
components:
  schemas:
    Owner:
      type: array
      items:
        type: object
        properties:
          title:
            type: string
            enum:
              - Mr.
              - Ms.
              - Mrs.
            example: Mr.
            description: Title.
          firstName:
            type: string
            example: jonny
            description: First name.
          middleName:
            type: string
            example: eric
            description: Middle name.
          lastName:
            type: string
            example: dooei
            description: Last name.
          birthDate:
            type: string
            format: date
            example: '2000-08-01'
            description: Date of birth (YYYY-MM-DD).
          phoneNumber:
            type: string
            example: '2232322323'
            description: Phone number.
          streetNum:
            type: string
            example: '79'
            description: Street number.
          streetName:
            type: string
            example: clarks
            description: Street name.
          city:
            type: string
            example: ny
            description: City name.
          state:
            type: string
            enum:
              - AK
              - AL
              - AR
              - AZ
              - CA
              - CO
              - CT
              - DE
              - FL
              - GA
              - HI
              - IA
              - ID
              - IL
              - IN
              - KS
              - KY
              - LA
              - MA
              - ME
              - MD
              - MI
              - MN
              - MS
              - MO
              - MT
              - NC
              - ND
              - NE
              - NH
              - NJ
              - NM
              - NV
              - NY
              - OH
              - OK
              - OR
              - PA
              - RI
              - SC
              - SD
              - TN
              - TX
              - UT
              - VA
              - VT
              - WA
              - WI
              - WV
              - WY
            example: NY
            description: Two-letter US state code.
          postalCode:
            type: string
            example: '23434'
            description: ZIP or postal code.
          ssn:
            type: string
            example: '123123123'
            description: Social Security number, 9 digits.
          position:
            type: string
            enum:
              - OW
              - CEO
              - CFO
              - COO
              - PRESIDENT
              - VICE PRESIDENT
              - DIR
              - TR
              - SEC
              - PA
              - MEMBER LLC
              - OTH
              - SP
            description: |
              The position of the owner. Possible values are:
              - OW: Owner
              - CEO: Chief Executive Officer
              - CFO: Chief Financial Officer
              - COO: Chief Operating Officer
              - PRESIDENT: President
              - VICE PRESIDENT: Vice President
              - DIR: Director
              - TR: Treasurer
              - SEC: Secretary
              - PA: Partner
              - MEMBER LLC: Member of LLC
              - OTH: Other
              - SP: Sole Proprietorship
            example: CEO
          ownershipPercentage:
            type: integer
            example: 100
            description: Percentage of the business this owner holds (0-100).
          email:
            type: string
            format: email
            example: mail_m@asd.com
            description: Email address.
    Business:
      type: object
      properties:
        legalName:
          type: string
          example: testInvite
          description: Registered legal name of the business.
        dbaName:
          type: string
          example: testDBAInvite
          description: >-
            The merchant's doing-business-as name. Appears on customer
            statements unless overridden.
        federalTaxId:
          type: string
          example: '999999999'
          description: Federal tax ID, 9 digits.
        tinType:
          type: string
          enum:
            - SSN
            - EIN
            - Other
          example: SSN
          description: |
            The type of Tax Identification Number (TIN):
            - SSN (Social Security Number)
            - EIN (Employer Identification Number)
            - Other
        mccCode:
          type: string
          example: '5812'
          description: >-
            Four-digit merchant category code (MCC) that classifies the
            business.
        phoneNumber:
          type: string
          example: '2232322323'
          description: Phone number.
        address:
          type: object
          properties:
            streetNum:
              type: string
              example: '123'
              description: Street number.
            streetName:
              type: string
              example: main street
              description: Street name.
            city:
              type: string
              example: ny
              description: City name.
            state:
              type: string
              enum:
                - AK
                - AL
                - AR
                - AZ
                - CA
                - CO
                - CT
                - DE
                - FL
                - GA
                - HI
                - IA
                - ID
                - IL
                - IN
                - KS
                - KY
                - LA
                - MA
                - ME
                - MD
                - MI
                - MN
                - MS
                - MO
                - MT
                - NC
                - ND
                - NE
                - NH
                - NJ
                - NM
                - NV
                - NY
                - OH
                - OK
                - OR
                - PA
                - RI
                - SC
                - SD
                - TN
                - TX
                - UT
                - VA
                - VT
                - WA
                - WI
                - WV
                - WY
              example: NY
              description: Two-letter US state code.
            postalCode:
              type: string
              example: '22222'
              description: ZIP or postal code.
          description: Address details.
        websiteUrl:
          type: string
          format: uri
          example: https://www.sarasa.com
          description: Business website URL.
        ownershipType:
          type: string
          enum:
            - PublicCorporation
            - Government
            - PrivateCorporation
            - SoleProprietorship
            - LLC
            - Partnership
            - NonProfit
            - Trust
          example: PrivateCorporation
          description: Legal structure of the business.
        businessEstablishedDate:
          format: date-time
          example: '2023-11-02'
          description: 'Format: YYYY-MM-DD'
        expectedMonthlyVolume:
          type: integer
          example: 200
          description: Expected monthly processing volume, used in underwriting.
    Contact:
      type: object
      properties:
        firstName:
          type: string
          example: John
          description: First name.
        middleName:
          type: string
          example: Michael
          description: Middle name.
        lastName:
          type: string
          example: Doe
          description: Last name.
        birthDate:
          type: string
          format: date
          example: '1990-01-15'
          description: 'Format: YYYY-MM-DD'
        position:
          type: string
          example: CEO
          description: Role of the owner in the business.
        ssn:
          type: string
          example: 123-45-6789
          description: Social Security Number
        phoneNumber:
          type: string
          example: '5551234567'
          description: Phone number.
        email:
          type: string
          format: email
          example: john.doe@example.com
          description: Email address.
  responses:
    createManyOnboardingInvites:
      description: Successfully fetched onboarding invites.
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                description: >-
                  Whether the request was processed successfully. Declines
                  return HTTP 200 with `success: false`.
              code:
                type: string
                description: Machine-readable result code. See the Error Codes reference.
              message:
                type: string
                description: Human-readable result message.
              data:
                type: object
                properties:
                  total:
                    type: integer
                    description: Total number of records processed.
                  succeeded:
                    type: object
                    properties:
                      count:
                        type: integer
                        description: Number of records.
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            inviteId:
                              type: string
                              description: Unique identifier of the onboarding invite.
                            name:
                              type: string
                              description: Display name.
                            email:
                              type: string
                              description: Email address.
                        description: The individual records.
                    description: The subset that succeeded, with count and results.
                  failed:
                    type: object
                    properties:
                      count:
                        type: integer
                        description: Number of records.
                      results:
                        type: array
                        items:
                          type: object
                        description: The individual records.
                    description: The subset that failed, with count and results.
                  dryRun:
                    type: boolean
                    description: When true, validates the request without creating invites.
                description: The response payload.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````