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

# Create a merchant

> Creates a merchant under a partner. A website belongs to one merchant across all partners, so `MERCHANT_ALREADY_EXISTS` confirms that some merchant holds it, and names none. `consent` records the person's acceptance of the agreements every merchant accepts with the create. Leave it out to record each later through `agreement_acceptance`. The `CONSENT_AGREEMENT_*` codes name the agreement in `details`. A retry with the same key answers the merchant the first one created, and records no consent again.

Credentials: `partner`

Permission: `merchants:create`



## OpenAPI

````yaml /api-reference/v1/openapi.json post /partners/{id}/merchants
openapi: 3.1.0
info:
  title: Quidkey API
  version: 1.0.0
  description: >-
    The Quidkey public API.


    Within a version, a response can carry what this document doesn't list yet:
    a new field, a new value of an enum, a new error code. Handle a value you
    don't recognise rather than refusing the response. A client generated from
    this document turns an `enum` into a closed type unless told otherwise, so
    turn on its option for unknown values, such as openapi-generator's
    `enumUnknownDefaultCase`. A request is held to what's listed: a value it
    doesn't list is refused.
  contact:
    name: Quidkey
    url: https://docs.quidkey.com
servers:
  - url: https://api.quidkey.com/v1
security:
  - bearer: []
tags:
  - name: account_owner
  - name: agreement
  - name: agreement_acceptance
  - name: api_key
  - name: bank
  - name: bank_account
  - name: capability
  - name: country
  - name: identity_verification
  - name: legal_entity
  - name: merchant
  - name: party
  - name: payment_link
  - name: payout
  - name: transaction
  - name: webhook_endpoint
paths:
  /partners/{id}/merchants:
    post:
      tags:
        - merchant
      summary: Create a merchant
      description: >-
        Creates a merchant under a partner. A website belongs to one merchant
        across all partners, so `MERCHANT_ALREADY_EXISTS` confirms that some
        merchant holds it, and names none. `consent` records the person's
        acceptance of the agreements every merchant accepts with the create.
        Leave it out to record each later through `agreement_acceptance`. The
        `CONSENT_AGREEMENT_*` codes name the agreement in `details`. A retry
        with the same key answers the merchant the first one created, and
        records no consent again.


        Credentials: `partner`


        Permission: `merchants:create`
      operationId: merchant.create
      parameters:
        - name: id
          in: path
          required: true
          schema:
            minLength: 1
            type: string
        - name: Idempotency-Key
          in: header
          required: true
          description: >-
            1 to 255 printable ASCII characters with no spaces, quotes or
            backslashes, in double quotes as the IETF draft defines, or without
            them. We recommend a UUID. Make one for each thing you mean to
            happen once and store it before you send the request, so a retry
            after a crash sends the same key. Keys are scoped to your account
            and the endpoint, not to a token, so a new token or a rotated secret
            doesn't affect a retry. A partner and its merchant are separate
            accounts, so the same key sent with each credential starts two
            requests. Keys are kept for at least 7 days. After that, the same
            key starts a new request.
          schema:
            type: string
            minLength: 1
            maxLength: 257
            pattern: >-
              ^(?:([\x21\x23-\x5B\x5D-\x7E]{1,255})|"([\x21\x23-\x5B\x5D-\x7E]{1,255})")$
      requestBody:
        required: true
        content:
          application/json:
            schema:
              additionalProperties: false
              type: object
              required:
                - brand_name
                - website_url
                - category_code
              properties:
                brand_name:
                  minLength: 1
                  maxLength: 255
                  type: string
                website_url:
                  format: uri
                  pattern: ^https://
                  maxLength: 255
                  type: string
                category_code:
                  pattern: ^[0-9]{4}$
                  type: string
                  description: >-
                    An ISO 18245 merchant category code: four digits, `0742` for
                    veterinary services.
                country:
                  pattern: ^[A-Z]{2}$
                  type: string
                account_owners:
                  maxItems: 1
                  description: At most one, who becomes the primary owner.
                  type: array
                  items:
                    additionalProperties: false
                    type: object
                    required:
                      - full_name
                      - email
                    properties:
                      full_name:
                        minLength: 1
                        maxLength: 255
                        type: string
                      email:
                        format: email
                        maxLength: 255
                        type: string
                        pattern: >-
                          ^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$
                      phone:
                        anyOf:
                          - pattern: ^\+[1-9]\d{1,14}$
                            type: string
                            minLength: 8
                          - type: 'null'
                      job_title:
                        anyOf:
                          - maxLength: 100
                            type: string
                          - type: 'null'
                consent:
                  $ref: '#/components/schemas/Consent'
                  description: >-
                    The person accepts the agreements every merchant accepts:
                    `merchant_terms`, `privacy_notice`,
                    `data_processing_addendum`, `prohibited_use_policy`,
                    `pricing_plan`, `third_party_services` and
                    `banking_partner_authorization`. `agreements` must hold the
                    current version of each, and nothing else: list agreements
                    for them. Optional. Send it to record the person's
                    acceptance with the create, or accept later through
                    `agreement_acceptance`.
      responses:
        '201':
          description: The merchant, in the full view.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
            Location:
              description: The URL of the created resource.
              schema:
                type: string
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - result
                  - entities
                  - not_included
                properties:
                  result:
                    $ref: '#/components/schemas/MerchantFull'
                  entities:
                    additionalProperties: false
                    description: Nothing can be included here.
                    type: object
                    properties: {}
                  not_included:
                    type: array
                    items:
                      $ref: '#/components/schemas/NotIncludedEntry'
        '400':
          description: >-
            `CONSENT_ACCEPTED_AT_INVALID`: accepted_at is before the agreement
            took effect, too far in the future or too old.


            `CONSENT_AGREEMENT_DUPLICATE`: Consent names the same agreement more
            than once.


            `CONSENT_AGREEMENT_MISSING`: Consent is missing an agreement this
            operation requires.


            `CONSENT_AGREEMENT_NOT_REQUIRED`: Consent names an agreement this
            operation doesn't require.


            `CONSENT_AGREEMENT_STALE`: Consent names an agreement version that
            isn't current.


            `CONSENT_NOT_ACCEPTED`: `is_accepted` must be `true`, stating that
            the person accepted.


            `IDEMPOTENCY_KEY_REQUIRED`: This endpoint requires an
            Idempotency-Key header.


            `UNKNOWN_AGREEMENT`: This names no agreement.


            `VALIDATION_FAILED`: The request is malformed or failed validation.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - CONSENT_ACCEPTED_AT_INVALID
            - CONSENT_AGREEMENT_DUPLICATE
            - CONSENT_AGREEMENT_MISSING
            - CONSENT_AGREEMENT_NOT_REQUIRED
            - CONSENT_AGREEMENT_STALE
            - CONSENT_NOT_ACCEPTED
            - IDEMPOTENCY_KEY_REQUIRED
            - UNKNOWN_AGREEMENT
            - VALIDATION_FAILED
        '401':
          description: '`UNAUTHENTICATED`: A valid bearer token is required.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - UNAUTHENTICATED
        '403':
          description: >-
            `FORBIDDEN`: This credential doesn't have permission for this
            endpoint.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - FORBIDDEN
        '404':
          description: '`NOT_FOUND`: Not found.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - NOT_FOUND
        '406':
          description: '`NOT_ACCEPTABLE`: This endpoint doesn''t offer the format in Accept.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - NOT_ACCEPTABLE
        '409':
          description: >-
            `IDEMPOTENCY_IN_PROGRESS`: An earlier request with this
            Idempotency-Key hasn't finished. If this persists, contact support.


            `MERCHANT_ALREADY_EXISTS`: A merchant already holds this website.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - IDEMPOTENCY_IN_PROGRESS
            - MERCHANT_ALREADY_EXISTS
        '422':
          description: >-
            `IDEMPOTENCY_KEY_REUSED`: This Idempotency-Key was used with a
            different request.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - IDEMPOTENCY_KEY_REUSED
        '429':
          description: '`RATE_LIMITED`: Too many requests.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - RATE_LIMITED
        '500':
          description: '`INTERNAL_ERROR`: Something went wrong on our side.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - INTERNAL_ERROR
        '503':
          description: '`SERVICE_UNAVAILABLE`: The service is busy. Try again shortly.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            Idempotent-Replayed:
              $ref: '#/components/headers/IdempotentReplayed'
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          x-error-codes:
            - SERVICE_UNAVAILABLE
components:
  schemas:
    Consent:
      additionalProperties: false
      type: object
      required:
        - is_accepted
        - accepted_at
        - accepted_by
        - accepted_ip
        - wording
        - locale
        - agreements
      properties:
        is_accepted:
          const: true
          type: boolean
        accepted_at:
          format: date-time
          pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$
          type: string
          description: >-
            When the person accepted. Before the agreement took effect, more
            than 5 minutes in the future or more than 30 days old is refused,
            with `CONSENT_ACCEPTED_AT_INVALID`.
        accepted_by:
          additionalProperties: false
          type: object
          required:
            - full_name
            - email
          properties:
            full_name:
              minLength: 1
              maxLength: 200
              pattern: ^[^\x00-\x1F\x7F]*$
              description: On one line, with no control character.
              type: string
            email:
              format: email
              maxLength: 320
              type: string
              pattern: >-
                ^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$
        accepted_ip:
          anyOf:
            - format: ipv4
              type: string
            - format: ipv6
              type: string
        wording:
          minLength: 1
          maxLength: 10000
          pattern: ^[^\x00-\x08\x0B\x0C\x0E-\x1F\x7F]*$
          description: >-
            The exact text the person saw, with no control character but a line
            break or a tab.
          type: string
        locale:
          pattern: ^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8})*$
          type: string
          maxLength: 35
        agreements:
          minItems: 1
          maxItems: 7
          type: array
          items:
            $ref: '#/components/schemas/AgreementRequestLink'
    MerchantFull:
      additionalProperties: false
      type: object
      required:
        - _type
        - _uri
        - _view
        - id
        - created_at
        - updated_at
        - partner
        - brand_name
        - website_url
        - category_code
        - country
        - status
        - home_currency
        - is_multi_account_allowed
        - account_owners
        - onboarding
        - legal_entities
        - payment_links
        - agreement_acceptances
        - bank_accounts
        - capabilities
        - webhook_endpoints
        - transactions
        - payouts
      properties:
        _type:
          const: merchant
          type: string
        _uri:
          pattern: ^/
          description: The canonical URI, relative to the version root.
          type: string
        _view:
          const: full
          type: string
        id:
          type: string
        created_at:
          anyOf:
            - format: date-time
              pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$
              type: string
            - type: 'null'
        updated_at:
          anyOf:
            - format: date-time
              pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$
              type: string
            - type: 'null'
        partner:
          $ref: '#/components/schemas/UnpublishedPartnerLink'
        brand_name:
          type: string
        website_url:
          anyOf:
            - format: uri
              type: string
            - type: 'null'
          description: >-
            Unique across all merchants. Sent as absolute HTTPS. One set outside
            this API can read `http://`. `null` when none is held.
        category_code:
          type: string
        country:
          anyOf:
            - pattern: ^[A-Z]{2}$
              type: string
            - type: 'null'
          description: '`null` when none is held.'
        status:
          type: string
          enum:
            - pending
            - active
            - suspended
          description: >-
            Where the merchant stands with Quidkey.


            - `pending`: Not live yet: it takes no live payment transactions.
            Read `onboarding` for what is outstanding.

            - `active`: Live. A live payment transaction can still be refused:
            after 12 months with none, until Quidkey has reviewed the merchant,
            or while the account it would land in awaits verification.

            - `suspended`: Quidkey has paused it, whether or not it had gone
            live: no live payment transaction, refund or payout starts.
            Reinstating it answers `pending` or `active`. Why isn't shared.
        home_currency:
          anyOf:
            - pattern: ^[A-Z]{3}$
              type: string
            - type: 'null'
          description: >-
            What a payment transaction through a virtual account is converted
            into and paid out in when the merchant has no payout account in the
            transaction's own currency. A direct payment transaction is never
            converted. It's set from the merchant's first payout account, where
            that currency can be held, and only Quidkey can change it. `null`
            while it has none, and a merchant can't go live without one.
        is_multi_account_allowed:
          type: boolean
          description: >-
            Whether another `owned` account can be added while one is active.
            Linking a bank account isn't limited by it. It can't be set through
            this API.
        account_owners:
          $ref: '#/components/schemas/AccountOwnerCollectionLink'
        onboarding:
          $ref: '#/components/schemas/OnboardingSubResourceLink'
        legal_entities:
          $ref: '#/components/schemas/LegalEntityCollectionLink'
        payment_links:
          $ref: '#/components/schemas/PaymentLinkCollectionLink'
        agreement_acceptances:
          $ref: '#/components/schemas/AgreementAcceptanceCollectionLink'
        bank_accounts:
          $ref: '#/components/schemas/BankAccountCollectionLink'
        capabilities:
          $ref: '#/components/schemas/CapabilityCollectionLink'
        webhook_endpoints:
          $ref: '#/components/schemas/WebhookEndpointCollectionLink'
          description: A partner's credential can't follow this link, and answers 403.
        transactions:
          $ref: '#/components/schemas/TransactionCollectionLink'
        payouts:
          $ref: '#/components/schemas/PayoutCollectionLink'
    NotIncludedEntry:
      additionalProperties: false
      type: object
      required:
        - link
        - reason
      properties:
        link:
          $ref: '#/components/schemas/AnyLink'
        reason:
          type: string
          enum:
            - no_permission
            - not_published
          description: >-
            Why this link has no entity.


            - `no_permission`: This credential can't read it. Fetching it
            answers 403, or 404 where a 403 would reveal that it exists.

            - `not_published`: The API doesn't show it: a type it doesn't
            publish, or a record it doesn't show on a type it does, such as a
            failed payout. Fetching it, where it has a URI, answers 404.
    Error:
      additionalProperties: false
      type: object
      required:
        - error
      properties:
        error:
          additionalProperties: false
          type: object
          required:
            - code
            - message
            - details
            - retryable
            - request_id
          properties:
            code:
              description: Branch on this. New codes can appear.
              type: string
            message:
              description: For people. It can change.
              type: string
            details:
              type: array
              items:
                $ref: '#/components/schemas/ErrorDetail'
            retryable:
              description: >-
                Whether sending the same request again unchanged, after a wait,
                can succeed with nothing else changing.
              type: boolean
            request_id:
              description: Quote this to support.
              type: string
    AgreementRequestLink:
      additionalProperties: false
      type: object
      required:
        - id
      properties:
        id:
          minLength: 1
          maxLength: 100
          type: string
        _link:
          pattern: ^/
          type: string
        _type:
          const: agreement
          type: string
      x-link-target:
        resource: agreement
        kind: request
        is_published: true
    UnpublishedPartnerLink:
      additionalProperties: false
      type: object
      required:
        - _type
        - id
      properties:
        _type:
          const: partner
          type: string
        id:
          type: string
      x-link-target:
        resource: partner
        kind: resource
        is_published: false
    AccountOwnerCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: account_owner
        kind: collection
        is_published: true
        views:
          - full
    OnboardingSubResourceLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
        - id
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: onboarding
          type: string
        id:
          type: string
      x-link-target:
        resource: onboarding
        kind: singleton
        is_published: true
        views:
          - full
    LegalEntityCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: legal_entity
        kind: collection
        is_published: true
        views:
          - full
    PaymentLinkCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: payment_link
        kind: collection
        is_published: true
        views:
          - full
          - summary
    AgreementAcceptanceCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: agreement_acceptance
        kind: collection
        is_published: true
        views:
          - full
    BankAccountCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: bank_account
        kind: collection
        is_published: true
        views:
          - full
    CapabilityCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: capability
        kind: collection
        is_published: true
        views:
          - full
    WebhookEndpointCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: webhook_endpoint
        kind: collection
        is_published: true
        views:
          - full
    TransactionCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: transaction
        kind: collection
        is_published: true
        views:
          - full
          - summary
    PayoutCollectionLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: collection
          type: string
      x-link-target:
        resource: payout
        kind: collection
        is_published: true
        views:
          - full
    AnyLink:
      anyOf:
        - additionalProperties: false
          type: object
          required:
            - _link
            - _type
            - id
          properties:
            _link:
              pattern: ^/
              type: string
            _type:
              type: string
            id:
              type: string
        - additionalProperties: false
          type: object
          required:
            - _type
            - id
          properties:
            _type:
              type: string
            id:
              type: string
      x-link-target:
        resource: any
        kind: any
        is_published: true
    ErrorDetail:
      anyOf:
        - additionalProperties: false
          type: object
          required:
            - field
            - message
          properties:
            field:
              type: string
            message:
              type: string
        - additionalProperties: false
          type: object
          required:
            - required_actions
            - message
          properties:
            required_actions:
              description: The `required_actions` codes holding this back.
              type: array
              items:
                type: string
            message:
              type: string
        - additionalProperties: false
          type: object
          required:
            - available_percent
            - message
          properties:
            available_percent:
              $ref: '#/components/schemas/Percent'
            message:
              type: string
        - additionalProperties: false
          type: object
          required:
            - agreement
            - message
          properties:
            agreement:
              $ref: '#/components/schemas/AgreementLink'
            message:
              type: string
        - additionalProperties: false
          type: object
          required:
            - agreement
            - current_agreement
            - message
          properties:
            agreement:
              $ref: '#/components/schemas/AgreementLink'
            current_agreement:
              $ref: '#/components/schemas/AgreementLink'
            message:
              type: string
        - additionalProperties: false
          type: object
          required:
            - legal_entity
            - message
          properties:
            legal_entity:
              $ref: '#/components/schemas/LegalEntityLink'
            message:
              type: string
    Percent:
      pattern: ^\d+(\.\d+)?$
      description: 'A percentage as a decimal string: `"25.00"` is 25%.'
      type: string
    AgreementLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
        - id
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: agreement
          type: string
        id:
          type: string
      x-link-target:
        resource: agreement
        kind: resource
        is_published: true
        views:
          - full
    LegalEntityLink:
      additionalProperties: false
      type: object
      required:
        - _link
        - _type
        - id
      properties:
        _link:
          pattern: ^/
          type: string
        _type:
          const: legal_entity
          type: string
        id:
          type: string
      x-link-target:
        resource: legal_entity
        kind: resource
        is_published: true
        views:
          - full
  headers:
    RequestId:
      description: Identifies this request. Quote it to support.
      schema:
        type: string
    IdempotentReplayed:
      description: '`true` on a retry that answers with the first attempt''s outcome.'
      schema:
        type: string
        enum:
          - 'true'
    RetryAfter:
      description: How many seconds to wait before retrying.
      schema:
        minimum: 0
        type: integer
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.