Use for supplier identity and VAT reconciliation, not the full signed five-gate invoice decision. Reconciles the claimed legal name, company registration number and VAT number against the Irish Companies Registration Office (IE) and the EU VIES VAT service, and returns an advisory RELEASE, REVIEW, BLOCK or INSUFFICIENT_EVIDENCE decision with per-check results and reason codes plus verification_id. Use decide_supplier_payment for the signed invoice/PO/GRN workflow, individual check tools for one check, and get_verification only to retrieve this stored result. This creates a verification and may call external sources; it never executes or authorises a bank payment. Requires explicit x402 service-fee approval or an authorized bearer token; do not automatically retry paid calls.
View input schema
{
"type": "object",
"properties": {
"schema_version": {
"const": "1.0",
"description": "Request schema version; always the literal string 1.0.",
"title": "Schema Version",
"type": "string"
},
"request_id": {
"description": "Caller-generated unique request UUID used for idempotency. This is not the returned verification_id used for retrieval.",
"format": "uuid",
"title": "Request Id",
"type": "string"
},
"policy_id": {
"const": "eu-b2b-payment-v1",
"description": "Verification policy identifier; always eu-b2b-payment-v1.",
"title": "Policy Id",
"type": "string"
},
"supplier": {
"$ref": "#/$defs/SupplierInput",
"description": "Claimed supplier identity and Irish identifiers to reconcile with CRO/VIES; not the signed invoice-decision supplier object."
},
"transaction": {
"anyOf": [
{
"$ref": "#/$defs/TransactionInput"
},
{
"type": "null"
}
],
"default": null
},
"customer_assertions": {
"anyOf": [
{
"$ref": "#/$defs/AssertionsInput"
},
{
"type": "null"
}
],
"default": null
},
"payment_destination": {
"anyOf": [
{
"$ref": "#/$defs/PaymentDestinationInput"
},
{
"type": "null"
}
],
"default": null
},
"requested_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Requested At"
},
"evidence": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/EvidenceInput"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Evidence"
},
"callback": {
"anyOf": [
{
"$ref": "#/$defs/CallbackInput"
},
{
"type": "null"
}
],
"default": null
},
"metadata": {
"anyOf": [
{
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Metadata"
}
},
"required": [
"schema_version",
"request_id",
"policy_id",
"supplier"
],
"$defs": {
"AssertionsInput": {
"additionalProperties": false,
"properties": {
"supplier_approved": {
"title": "Supplier Approved",
"type": "boolean"
},
"po_matched": {
"title": "Po Matched",
"type": "boolean"
},
"amount_within_po": {
"title": "Amount Within Po",
"type": "boolean"
},
"currency_matched": {
"title": "Currency Matched",
"type": "boolean"
},
"invoice_supplier_matched": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Invoice Supplier Matched"
},
"assertion_source": {
"anyOf": [
{
"enum": [
"SAP",
"D365",
"ORACLE",
"NETSUITE",
"OTHER"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Assertion Source"
}
},
"required": [
"supplier_approved",
"po_matched",
"amount_within_po",
"currency_matched"
],
"title": "AssertionsInput",
"type": "object"
},
"CallbackInput": {
"additionalProperties": false,
"properties": {
"url": {
"title": "Url",
"type": "string"
},
"authentication_reference": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Authentication Reference"
}
},
"required": [
"url"
],
"title": "CallbackInput",
"type": "object"
},
"EvidenceInput": {
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"INVOICE",
"PURCHASE_ORDER",
"SUPPLIER_MASTER",
"BANK_CHANGE_REQUEST",
"OTHER"
],
"title": "Type",
"type": "string"
},
"sha256": {
"pattern": "^[a-f0-9]{64}$",
"title": "Sha256",
"type": "string"
},
"observed_at": {
"title": "Observed At",
"type": "string"
},
"content_uri": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Uri"
},
"media_type": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Media Type"
}
},
"required": [
"type",
"sha256",
"observed_at"
],
"title": "EvidenceInput",
"type": "object"
},
"PaymentDestinationInput": {
"additionalProperties": false,
"properties": {
"fingerprint": {
"maxLength": 256,
"minLength": 32,
"title": "Fingerprint",
"type": "string"
},
"fingerprint_algorithm": {
"const": "HMAC-SHA-256",
"title": "Fingerprint Algorithm",
"type": "string"
},
"country_code": {
"pattern": "^[A-Z]{2}$",
"title": "Country Code",
"type": "string"
},
"beneficiary_name": {
"anyOf": [
{
"maxLength": 300,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Beneficiary Name"
},
"is_declared_change": {
"default": false,
"title": "Is Declared Change",
"type": "boolean"
}
},
"required": [
"fingerprint",
"fingerprint_algorithm",
"country_code"
],
"title": "PaymentDestinationInput",
"type": "object"
},
"SupplierInput": {
"additionalProperties": false,
"properties": {
"customer_supplier_id": {
"anyOf": [
{
"maxLength": 128,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Customer Supplier Id"
},
"claimed_legal_name": {
"description": "Legal supplier name claimed on the invoice, to reconcile with registry evidence.",
"maxLength": 300,
"minLength": 1,
"title": "Claimed Legal Name",
"type": "string"
},
"country_code": {
"description": "Uppercase ISO country code. Company-registry verification currently supports IE only.",
"pattern": "^[A-Z]{2}$",
"title": "Country Code",
"type": "string"
},
"company_registration_number": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Irish CRO company number, supplied as a string; not a VAT number.",
"title": "Company Registration Number"
},
"vat_number": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Claimed supplier VAT identifier for VIES reconciliation. Irish VAT validation is supported.",
"title": "Vat Number"
},
"lei": {
"anyOf": [
{
"pattern": "^[A-Z0-9]{20}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Lei"
},
"claimed_address": {
"anyOf": [
{
"maxLength": 500,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Claimed Address"
}
},
"required": [
"claimed_legal_name",
"country_code"
],
"title": "SupplierInput",
"type": "object"
},
"TransactionInput": {
"additionalProperties": false,
"properties": {
"invoice_id": {
"maxLength": 128,
"minLength": 1,
"title": "Invoice Id",
"type": "string"
},
"purchase_order_id": {
"anyOf": [
{
"maxLength": 128,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Purchase Order Id"
},
"amount": {
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,4})?$",
"title": "Amount",
"type": "string"
},
"currency": {
"pattern": "^[A-Z]{3}$",
"title": "Currency",
"type": "string"
},
"invoice_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Invoice Date"
},
"due_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Due Date"
}
},
"required": [
"invoice_id",
"amount",
"currency"
],
"title": "TransactionInput",
"type": "object"
}
},
"title": "verify_supplier_paymentArguments"
}