# Madhouse Wallet – Create Payout Recipient

> Madhouse Wallet – Create Payout Recipient is a paid API for AI agents from try.madhousewallet.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Registers a bank payout recipient (with sanctions screening) for a given currency, account type, and bank details, returning a recipient ID to use in a subsequent transfer.

## Facts

- Endpoint: POST https://try.madhousewallet.com/api/public/recipients
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/try-madhousewallet-com-77cc3960
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lcHFYQUZjDbE3LYEPX4M-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability try-madhousewallet-com-77cc3960 -d '<json body>'
```

Example prompt: Register a payout recipient on Madhouse Wallet for Maria Santos who has a EUR bank account (IBAN: DE89370400440532013000, BIC: COBADEFFXXX) — the funding wallet is wallet_abc123.

## When to prefer this

Use this endpoint when you need to register a new bank payout recipient before initiating a cross-border money transfer via Madhouse Wallet. This is the required first step in the transfer flow: first get field requirements (/api/public/requirements), then create a recipient here, then create a transfer using the returned recipient ID.

## Known failure modes

- Invalid or unsupported target currency → 400 Bad Request
- Missing required bank detail fields for the given currency/account type → 400 validation error
- Recipient fails sanctions screening upstream → compliance rejection response
- Invalid or unauthorized funding wallet ID → 401/403 error
- Malformed bank details (e.g. invalid IBAN format) → 422 Unprocessable Entity
- Insufficient USDC balance to cover the 0.01 USDC fee → payment failure

## How this service works

Convert USDC to 45+ local currencies and receive funds directly to your bank account. Fast, secure crypto offramp powered by Madhouse Wallet.

## Output

Returns a recipient ID (to be passed to the transfer creation endpoint), along with confirmation that the recipient has passed upstream sanctions screening. May also return validation errors if the bank details are incomplete or the recipient fails compliance checks.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "type": "string",
   "description": "Account type id from /api/public/requirements, e.g. nigeria_bank_account."
  },
  "wallet": {
   "type": "string",
   "description": "Funding wallet address (0x EVM address or Solana base58 address)."
  },
  "details": {
   "type": "object",
   "description": "Key/value map of the bank-detail fields required for this currency and type (field key to value), per /api/public/requirements."
  },
  "currency": {
   "type": "string",
   "description": "ISO 4217 target currency, e.g. NGN."
  },
  "accountHolderName": {
   "type": "string",
   "description": "Full legal name of the recipient account holder."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": 12345,
  "type": "nigeria_bank_account",
  "active": true,
  "country": "NG",
  "details": {
   "bankCode": "058",
   "accountNumber": "0123456789"
  },
  "currency": "NGN",
  "accountHolderName": "Ada Lovelace"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/try-madhousewallet-com-77cc3960/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from try.madhousewallet.com](https://www.zero.xyz/host/try.madhousewallet.com/llms.txt)