{"uid":"cap_JrP5VwCuzUsjQnL4sv3RR","slug":"invoket-payment-preflight-iban-verification-beneficiary-screening-f60b0080","name":"Invoket Payment Preflight — IBAN Verification & Beneficiary Screening","description":"The checks your agent runs before it acts: verify a bank account, a phone number, a law in force, the weather or a vehicle — computed from official sources, with provenance in every response. You only pay for answers.","url":"https://api.invoket.com/preflight/payment","method":"POST","headers":{},"bodySchema":{"type":"object","required":["iban","include_weak","beneficiary_name"],"properties":{"iban":{"type":"string","description":"The beneficiary IBAN, up to 64 characters (separators tolerated). A structurally invalid IBAN is a USEFUL answer: HTTP 200 with a motivated 'stop', not an error"},"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2 filter on the beneficiary's DECLARED country, applied to the name screening only. It is your declaration, never an assertion of ours, and it can only remove candidates whose country the list published in a comparable form"},"include_weak":{"type":"string","description":"Whether weak name matches count towards the verdict; default false. Same semantics as /screen/entity: it changes only the verdict, weak matches are returned either way"},"beneficiary_name":{"type":"string","description":"Name of the beneficiary, 2 to 200 characters, screened against the designation lists exactly as GET /screen/entity does. Optional - but WITHOUT it the verdict can never be 'ok': the beneficiary was not looked at, and an 'ok' would read as a green light on them"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eFHBtExvlmMHePWuXiyzo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an IBAN structurally and screens the beneficiary name against sanctions/designation lists before a payment is executed.","exampleAgentPrompt":"Before I send this payment, can you run a preflight check on IBAN DE89370400440532013000 for beneficiary 'Acme GmbH' — include weak name matches in the verdict — and confirm they're not on any designation lists?","exampleUseCases":[{"title":"Pre-payment sanctions check for vendor","prompt":"I'm about to pay a new supplier. Can you verify IBAN GB29NWBK60161331926819 and screen 'Northern Logistics Ltd' against sanctions lists before I approve the wire? Include weak matches in the verdict."},{"title":"Automated payroll compliance gate","prompt":"Before we process payroll, check IBAN FR7630006000011234567890189 for employee 'Jean Dupont' — we need to confirm the IBAN is structurally valid and they don't appear on any designation list. Don't include weak matches in the verdict."},{"title":"Flagging a structurally invalid IBAN","prompt":"Run a preflight check on this IBAN I received from a new client: XX99FAKE000099887766 for 'Global Trade Partners' — I want to know if the IBAN is even valid before I do anything else."}],"resultDescription":"Returns a verdict object indicating whether the payment is safe to proceed ('ok'), should be stopped ('stop'), or requires review, along with IBAN structural validity details, beneficiary sanctions screening results (including any weak matches), and provenance information sourcing the official designation lists consulted.","failureModes":["IBAN longer than 64 characters returns validation error","beneficiary_name shorter than 2 or longer than 200 characters rejected","missing required fields (iban, include_weak, beneficiary_name) returns 400","structurally invalid IBAN returns HTTP 200 with a 'stop' verdict and explanation, not an error","payment required (402) if x402 payment header is missing or invalid"],"whenToPreferThis":"Use this endpoint when an AI agent is about to initiate or approve a payment and needs to verify both the structural validity of the destination IBAN and screen the beneficiary against current sanctions/designation lists in a single call, with full provenance. Prefer this over standalone IBAN validators when compliance screening is also needed, and over general entity screening when IBAN validation must happen simultaneously.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:35.811Z","isFirstParty":false}