Counterparty Risk Indicators
pre-disbursement-guardCheck supplier tax and bank identifiers (IBAN, LEI, EU VAT, UK company number), domain-age evidence and country mismatch signals before vendor payment. Requires a preceding receipt hash. An advisory result is not verified identity, fraud clearance or authorization to release funds.
Quickstart & Execution
curl -X POST https://api.code402.dev/v1/tools/pre-disbursement-guard/call \
-H "content-type: application/json" \
-d '{"recipient_iban":"GB82WEST12345698765432","vendor_domain":"billing@acme-consulting.co.uk","declared_country":"GB","company_number":"01234567","invoice_amount_usd":4500,"prev_receipt_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"}'
This route is paid-only (0 free calls/day); every unauthenticated request returns an HTTP 402 Payment Required challenge with its payment terms. Machines use USDC on Base; card credits (instant Stripe checkout) are enabled in this deployment. Signed XDR-1 receipts authenticate recorded service claims, not independent settlement, delivery or zero-knowledge proofs.
Input Parameters
| Field | Type | Meaning & Constraints |
|---|---|---|
recipient_iban | string | Recipient bank IBAN (optional). |
vendor_domain | string | Vendor website domain or invoicing email address (optional). |
declared_country | string | 2-letter ISO country code where vendor claims to be registered (optional, e.g. 'GB', 'US', 'DE'). |
company_number | string | Official corporate registration number, e.g. UK Companies House 8 digits/chars (optional). |
lei | string | ISO 17442 Legal Entity Identifier (optional). |
vat_number | string | EU VAT number (optional). |
physical_address | string | Vendor physical office address (optional). |
invoice_amount_usd | number | Disbursement transaction amount in USD (optional). |
prev_receipt_hash | string | Preceding verification receipt hash (may also be passed via X-PREV-RECEIPT-HASH header). |
Response Format
Deterministic JSON payload fields: tool, clear_to_disburse, risk_level, risk_score, decision, summary, checks, flags_triggered, recommendations, inspected_counterparty, scope. Paid responses also carry an offline-verifiable receipt object (XDR-1, secp256k1 signature recoverable to the authorized signer).
Related Conformance Tools
aci-trust-lookup dip-file-dispute pod-verify-delivery csp-commitment-create iso20022-validate iso20022-to-x402-intent iban-check lei-check vat-mod97-check company-number-format swift-bic-check aba-routing-check ein-format-check ifsc-check abn-check gstin-check cnpj-check uscc-check japan-corp-check kra-pin-check rfc-check iso4217-currency-check upi-vpa-check pan-format-check uae-trn-check isin-check sedol-check isbn-check ean13-check luhn-check e164-check vendor-onboarding-pack rent-deposit-guard rental-listing-risk rental-verdict india-supplier-check china-supplier-check japan-supplier-check latam-supplier-check gulf-supplier-check africa-supplier-check settlement-history-check balance-check erc20-balance tx-activity block-info token-contract-risk ofac-sdn-check simulate-spend-sentinel create-ap2-pilot create-b2b-invoice get-b2b-invoice calculate-fx-savings fx-spot-price-oracle quote-3rd-party-insurance bind-insurance-policy list-approved-insurers batch-validate context-distill crypto-ticker instant-json-schema-verifier clean-markdown-scraper