{"uid":"cap_32qhvlxY6Dq45VL5fg_KR","slug":"try-madhousewallet-com-6c187cf4","name":"Madhouse Wallet Recipient Bank-Detail Fields Refresh","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/requirements/refresh","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"type":{"type":"string","description":"Account type id from a prior requirements response, e.g. nigeria_bank_account."},"details":{"type":"object","description":"Key/value map of the recipient detail fields collected so far (a field key to its chosen value), used to resolve conditional fields."},"currency":{"type":"string","description":"ISO 4217 currency code, e.g. NGN. May also be passed as the ?currency= query param."}}},"responseSchema":{"type":"json","example":{"data":[{"type":"nigeria_bank_account","title":"Bank account","fields":[{"name":"Recipient bank details","group":[{"key":"bankCode","name":"Bank","type":"select","required":true,"valuesAllowed":[{"key":"058","name":"GTBank"}],"refreshRequirementsOnChange":true},{"key":"accountNumber","name":"Account number","type":"text","required":true,"maxLength":10,"minLength":10,"refreshRequirementsOnChange":false}]}]}]}},"example":{"request":{"type":"bank_account","details":{"bank":"GTBank"},"currency":"NGN"},"response":{"_truncated":true,"_originalSize":13312}},"exampleRequest":{"type":"bank_account","details":{"bank":"GTBank"},"currency":"NGN"},"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_4bmLfwQrpWR61zdq-EwcP","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":"Refreshes and reveals conditional recipient bank-detail input fields based on currency, account type, and previously collected values.","exampleAgentPrompt":"I'm setting up a recipient for a Nigerian NGN bank transfer — I've already selected account type 'bank_account' and picked GTBank as the bank; now refresh the required fields so I can see what branch or routing fields I still need to fill in.","exampleUseCases":null,"resultDescription":"Returns an updated set of recipient bank-detail input fields, including any conditionally revealed fields (such as branch code, routing number, or bank-specific fields) that depend on the currency, account type, and values already provided.","failureModes":["Invalid or unsupported currency code returns an error","Missing required fields in the partial detail set causes a validation error","Unknown account type returns an error","Payment of 0.01 USDC not fulfilled results in 402 Payment Required","Malformed request body returns a 400 error"],"whenToPreferThis":"Use this endpoint during a multi-step recipient bank-detail collection flow when you need to discover what additional or dependent fields are required after the user has selected a currency, account type, or specific bank. It acts as a dynamic form-field resolver, revealing conditional inputs (like branch codes) that only appear after certain choices are made — essential for building correct payout recipient records across different countries and banks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:13.403Z","isFirstParty":false}