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

# List connected providers

> The payment providers connected to your account, each with its connection status, and which providers can be connected.



## OpenAPI

````yaml /api-reference/openapi.en.json get /account/providers
openapi: 3.1.0
info:
  title: Infi API
  version: 0.0.1
  description: >
    The Infi REST API: catalog, customers, usage metering, subscriptions,

    invoices, payments and checkout.


    **Authentication.** Send your secret key as `Authorization: Bearer
    sk_test_…`

    (sandbox) or `sk_live_…` (production). The key prefix selects the
    environment.

    Checkout routes (`/pay/*`) and `/public/*` take no key: they run in the

    payer's browser.


    **Idempotency.** Every request that changes data requires an

    `Idempotency-Key` header. A retry with the same key returns the original

    response instead of running again.


    **Amounts.** Money and quantities travel as decimal strings (`"150.00"`,

    `"0.0001"`), never as floating-point numbers.


    **Errors.** The body carries `error_code` (stable, branch on it), `message`

    (for humans) and `tracer_id` (send it to support). Rate-limit and
    idempotency

    errors are nested under `error`, with `code` and `request_id`.
servers:
  - url: https://api-sandbox.beinfi.com
    description: Sandbox
  - url: https://api.beinfi.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Catalog
  - name: Customers
  - name: Metering
  - name: Subscriptions
  - name: Invoices
  - name: Payments
  - name: Checkout
  - name: Coupons
  - name: Billing
  - name: Account
  - name: Webhooks
  - name: Test account
  - name: Rail
  - name: Storefronts
paths:
  /account/providers:
    get:
      tags:
        - Account
      summary: List connected providers
      description: >-
        The payment providers connected to your account, each with its
        connection status, and which providers can be connected.
      operationId: listProviderConnections
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                required:
                  - connections
                  - supported
                properties:
                  connections:
                    type: array
                    items:
                      $ref: '#/components/schemas/ProviderConnection'
                  supported:
                    type: array
                    items:
                      type: string
          description: Success.
components:
  schemas:
    ProviderConnection:
      type: object
      required:
        - provider
        - status
        - webhookRegistered
      properties:
        provider:
          type: string
        status:
          type: string
          enum:
            - pending_provider_verification
            - pending_wallet
            - pending_webhook
            - pending_key
            - connected
            - degraded
            - needs_reconnect
            - disabled
          description: >-
            `connected` when it is ready to collect. The `pending_*` states name
            the missing step; `needs_reconnect` asks you to connect again.
        externalAccountId:
          type: string
          description: Your account ID at the provider.
        walletId:
          type: string
        walletAddress:
          type: string
          description: Receiving wallet address
        verificationStatus:
          type: string
        settlementAsset:
          type: string
          enum:
            - USDC
        settlementNetwork:
          type: string
          enum:
            - base
            - solana
        webhookRegistered:
          type: boolean
          description: Whether the provider's notifications to Infi are set up.
        webhookUrl:
          type: string
          format: uri
        webhookEvents:
          type: array
          items:
            type: string
        publishableKey:
          type: string
        pixKey:
          type: string
          description: The Pix key that receives charges.
        connectedAt:
          type: string
          format: date-time
        lastVerifiedAt:
          type: string
          format: date-time
      description: A connection to a payment provider. Secrets are never returned.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your account's secret key: `Authorization: Bearer sk_test_…` or
        `sk_live_…`. Server-side only.

````