{"uid":"cap_lcHFYQUZjDbE3LYEPX4M-","slug":"try-madhousewallet-com-77cc3960","name":"Madhouse Wallet – Create Payout Recipient","description":"Convert USDC to 45+ local currencies and receive funds directly to your bank account. Fast, secure crypto offramp powered by Madhouse Wallet.","url":"https://try.madhousewallet.com/api/public/recipients","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{"id":12345,"type":"nigeria_bank_account","active":true,"country":"NG","details":{"bankCode":"058","accountNumber":"0123456789"},"currency":"NGN","accountHolderName":"Ada Lovelace"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_m8YdsMvswXmDRYSoAJQU2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:48.901Z","isFirstParty":false}