Create B2B contractor invoice

Machine Tool Interface · create-b2b-invoice

$0.015 / callPaid per call · 0 free tier No signup

Create a merchant-direct Base token invoice. New automated payments require a durable EOA authorization journal and a configured provider. No active protocol fee; no generic bank-wire authority, independent delivery or contract-wallet guarantee.

Honest Scope Guarantee

Generates a pre-clearable gasless B2B settlement invoice record on Base L2 with capped floating fee and dual-rail bank coordinates for the contracting parties. Invoice generation is deterministic; settlement is on-chain and non-custodial.

Run in Playground (Free) Buy Card Credits Agent Quickstart

Quickstart & Execution

cURL (Paid-only route — unauthenticated calls return HTTP 402 Payment Required)

curl -X POST https://api.code402.dev/v1/tools/create-b2b-invoice/call \
  -H "content-type: application/json" \
  -d '{"amount_usdc":50000,"merchant":"0xc59c85e661d34084a7769f955d17fd38254a6235","client_name":"Apex AI","memo":"Sprint #14 Milestones"}'

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
`amount_usdc` (REQUIRED)	`number`	Invoice total in USDC (e.g. 50000).
`merchant` (REQUIRED)	`string`	Beneficiary contractor Base EVM wallet address (0x...).
`client_name`	`string`	Client enterprise organization name (optional).
`memo`	`string`	Engagement scope / milestone description (optional).
`referrer`	`string`	Optional attribution reference. Referral payouts and protocol fees are not active.

Response Format

Deterministic JSON payload fields: tool, valid, invoice_id, amount_usdc, merchant, status, cart_hash, protocol_fee_usdc, invoice_url, pay_url, 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 pre-disbursement-guard 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 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