x402-payment-safety

PAID. Call this immediately BEFORE signing an x402 payment envelope. Returns one short-lived, Guild-signed AGPD-1 allow/block credential bound to the exact target payment: scheme, CAIP-2 network, asset contract, atomic amount, payee and resource URL, plus optional capability and policy thresholds. Verify it offline with POST /wallet-binding/decision/verify. This is the native MCP transport for the existing HTTP POST /wallet-binding/decision product. An unpaid call returns a complete x402 v2 challenge for the exact request digest. Retry with the official ``_meta['x402/payment']`` carrier; adapters that cannot set request metadata may pass the identical signed PaymentPayload as ``x402_payment``. Conflicting carriers fail closed before facilitator verification or settlement. The decision is issued before metering, so malformed inputs or signing failures are never charged. ``api_key`` uses sandbox credits and is never external revenue. The free identity-only alternative is GET /wallet-binding/resolve.

{'type': 'object', 'required': ['payment'], 'properties': {'policy': {'anyOf': [{'type': 'object', 'properties': {'max_risk': {'type': 'number'}, 'min_confidence': {'type': 'number'}}, 'description': 'Optional caller thresholds; server baselines can only make them stricter.'}, {'type': 'null'}], 'default': None}, 'api_key': {'type': 'string', 'default': ''}, 'payment': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'pay_to', 'resource'], 'properties': {'asset': {'type': 'string'}, 'amount': {'type': 'string'}, 'pay_to': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'resource': {'type': 'string'}}, 'description': 'The exact target payment being authorized before wallet signing.'}, 'capability': {'type': 'string', 'default': ''}, 'ttl_seconds': {'type': 'integer', 'default': 300}, 'x402_payment': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'string'}, {'type': 'null'}], 'default': None}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}