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

# Payee events

> `payee.created`, then one event per later status: `payee.details_pending`, `payee.verifying`, `payee.active`, `payee.inactive`.
`onboarding_url` is always `null` inside events.




## OpenAPI

````yaml /api-reference/openapi.yaml webhook payee-events
openapi: 3.1.0
info:
  title: Infinity API
  version: v1
  description: >
    Send cross-border payouts from your USD balance to payees' bank accounts.


    - **Hosts:** `https://sandbox-api.infinityapp.in/v1` for testing and
    `https://api.infinityapp.in/v1` for live money.

    - **Auth:** `Authorization: Bearer sk_test_…` on the sandbox, `sk_live_…` on
    live.

    - **JSON:** field names are snake_case. Amounts are decimal strings
    (`"500.00"`), currency codes are lowercase ISO 4217 (`"eur"`), countries are
    uppercase ISO 3166 alpha-2 (`"NL"`), and timestamps are ISO 8601 in UTC.

    - **Fixed shapes:** every documented response field is always present. It's
    `null` when there's no value, and `metadata` is `{}` when empty.

    - **Strict input:** an unknown field or query parameter gets a `400
    unknown_parameter`, and a number where a string is expected gets a `400
    type_mismatch`.

    - **Lists:** `limit` (1–100, default 20) and `starting_after` (the last id
    you saw). Responses are `{ "data": [...], "has_more": true }`, newest first.

    - **Idempotency:** the `Idempotency-Key` header is required on money-moving
    creates and optional on the others. The same key with the same body within
    24 hours returns the original response.

    - **Request ID:** every response has a `Request-Id` header. Quote it to
    support.

    - **Rate limits:** 20 requests per second per key, with bursts up to 40.
    Over that gets a `429` with `Retry-After`.

    - **Versioning:** `/v1` only grows. New fields, endpoints, enum values,
    event types and error codes can be added at any time, so ignore what you
    don't recognise.
servers:
  - url: https://sandbox-api.infinityapp.in/v1
    description: Sandbox (sk_test_ keys)
  - url: https://api.infinityapp.in/v1
    description: Live (sk_live_ keys)
security:
  - apiKey: []
tags:
  - name: Account
    description: Your account profile and settings.
  - name: Wallets
    description: >-
      Funds held for you, one wallet per currency. Every payout names the wallet
      that pays for it.
  - name: Funding addresses
    description: Bank details you send money to, to fund your balance.
  - name: Deposits
    description: Money credited to your balance.
  - name: Currencies
    description: The currencies we support and which ones you can pay out in.
  - name: Exchange rates
    description: Indicative rates. A quote is the price.
  - name: Payees
    description: The people and businesses you pay.
  - name: Payee addresses
    description: >-
      A payee's bank account, sent by you instead of the payee filling in our
      hosted form.
  - name: Bank requirements
    description: The fields each currency and rail needs.
  - name: Quotes
    description: Price payouts before you send them. Nothing is saved.
  - name: Payouts
    description: Create 1 to 100 payouts in one call, then track, update or cancel them.
  - name: Batches
    description: The set of payouts created by one Create payouts call.
  - name: Webhook endpoints
    description: URLs we notify when something changes.
  - name: Events
    description: Every change from the last 30 days, to catch up on missed webhooks.
paths: {}
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >
        Your secret key: `sk_test_…` on the sandbox host, `sk_live_…` on live. A
        key on the wrong host gets a `401 wrong_environment`.

        Keys are secret. Keep them on your server, never in a browser or app.

````

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