> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.crisscross.money/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.crisscross.money/_mcp/server.

# A beneficiary was created and is awaiting activation.

POST 

Reference: https://docs.crisscross.money/api-reference/exchange/webhooks/beneficiaries/beneficiary-pending

## Request

### Payload

- `eventType` (string, required) — The event type, e.g. `beneficiary.pending`.
- `timestamp` (datetime, required) — When the event was generated.
- `payload` (Beneficiary, required)

## Types

### Beneficiary

- `beneficiaryId` (string, required)
- `status` (enum, required) — - `pending` — created, awaiting activation. - `active` — usable in withdrawals. - `rejected` — failed compliance or bank checks. - `disabled` — no longer usable.
  - Allowed values: `pending`, `active`, `rejected`, `disabled`
- `currency` (string, required) — One currency per beneficiary.
- `name` (string, required) — Legal name.
- `entityType` (enum, required)
  - Allowed values: `business`, `individual`
- `accountDetails` (list of AccountDetail, required)
- `routingDetails` (list of RoutingDetail, required)
- `createdAt` (datetime, required)
- `statusReason` (enum, optional) — Machine-readable context for the current status. Present when additional detail is available.
  - Allowed values: `compliance_review`, `awaiting_rfi`
- `address` (Address, optional)
- `activatedAt` (datetime, optional) — When the beneficiary became active. Absent until activation.

### AccountDetail

A single account identifier. For fiat use `account_number`, `iban`, `clabe`, or `other`. For crypto use `wallet_address` paired with a `CryptoRoutingDetail`.

- `type` (enum, required)
  - Allowed values: `account_number`, `iban`, `clabe`, `wallet_address`, `other`
- `value` (string, required)

### RoutingDetail

- `rail`: `fiat` (fiat)
  - `paymentType` (enum, required)
    - Allowed values: `ach`, `fedwire`, `swift`, `sepa`, `sepa_instant`, `faster_payments`, `chaps`, `bacs`, `local`, `other`
  - `routingNumber` (string, required)
  - `routingNumberType` (enum, required)
    - Allowed values: `aba`, `bic`, `swift`, `sort_code`, `iban`, `bsb_code`, `cnaps`, `ifsc`, `other`
  - `bank` (FiatRoutingDetailBank, optional)
- `rail`: `crypto` (crypto)
  - `network` (enum, required) — Blockchain network identifier.
    - Allowed values: `ethereum`, `tron`, `solana`
  - `beneficiaryCorpCountry` (string, optional) — Country of incorporation, ISO 3166-1 alpha-2, returned lowercase. Required when `beneficiaryType` is `entity`.
  - `beneficiaryCorpName` (string, optional) — Registered company name. Required when `beneficiaryType` is `entity`.
  - `beneficiaryCountry` (string, optional) — Country of residence of the individual, ISO 3166-1 alpha-2, returned lowercase. Required when `beneficiaryType` is `individual`.
  - `beneficiaryName` (string, optional) — Full legal name of the individual. Required when `beneficiaryType` is `individual`.
  - `beneficiaryType` (enum, optional) — Whether the third party you are paying is a person or a company. Required when `isAddressOwner` is `false`; ignored for first-party.
    - Allowed values: `individual`, `entity`
  - `isAddressOwner` (boolean, optional) — `true` if the destination wallet is held in your own name (first-party). `false` if you are paying a third party. Required when creating a beneficiary. This is about whose name the account is in, not about who holds the private keys — use `sendTo` for that.
  - `sendTo` (enum, optional) — Kind of destination. `private_wallet` for a self-custodied wallet, `another_vasp` for an account at an exchange, custodian, or other virtual asset service provider. Required when creating a beneficiary.
    - Allowed values: `private_wallet`, `another_vasp`
  - `vasp` (string, optional) — Identifier of the receiving VASP. Required when `sendTo` is `another_vasp`.
  - `vaspName` (string, optional) — Display name of the receiving VASP. Required when `sendTo` is `another_vasp`.

### Address

- `line1` (string, optional)
- `line2` (string, optional)
- `city` (string, optional)
- `postcode` (string, optional)
- `country` (string, optional) — ISO 3166-1 alpha-2.

### FiatRoutingDetailBank

- `name` (string, optional)
- `address` (string, optional)