Code402 Webhooks API

The Webhooks API from Code402 — 1 operation(s) for webhooks.

GitHub OpenAPI

Operations 1

POST /webhooks/commerce-guard Universal Stateless Commerce & ERP Webhook Guard (Shopify Plus B2B, Stripe… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/code402-dev:code402-dev-webhooks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

code402-dev-webhooks-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Code402 Dev Webhooks API
  version: 1.3.0
  contact:
    name: JUANA LIMITED (HCRB / Code402)
    url: https://hcrb.in
    email: support@code402.dev
  x-guidance: 'Pay-per-call deterministic checks with machine-readable x402 challenges. PAID routes declare a published floor in x-payment-info; the 402 challenge body is authoritative for recipient, amount, asset and network, and the configured gas-cost floor may raise the amount — read accepts[0] before authorizing. FREE routes carry security: []. Start with the four flagship checks (iban-check, lei-check, vat-mod97-check, swift-bic-check): 5 free calls/day per caller, then the published per-call floor. If 77 routes is more than your budget allows, GET /.well-known/x402.slim.json for a four-route first-call manifest instead. Receipt verification is free and needs no account: POST /v1/receipt/verify or /v1/receipt/verify/batch (up to 1000 per request), and verifying keys are public at /.well-known/jwks.json so verification never requires calling us. A valid receipt proves the declared signer signed those exact bytes — not settlement, delivery, ownership or the truth of a business claim. Non-custodial throughout: payer to seller, no deposit, no float.'
  x-provider-name: JUANA LIMITED (HCRB / Code402)
  description: 'Operations tagged Webhooks across 2 of this provider''s published API definitions: code402-dev-openapi-hcrb.json, code402-dev-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://hcrb.in
tags:
- name: Webhooks
paths:
  /webhooks/commerce-guard:
    post:
      operationId: webhooks_commerce_guard
      summary: Universal Stateless Commerce & ERP Webhook Guard (Shopify Plus B2B, Stripe…
      description: 'Accepts native JSON webhooks from Shopify B2B, Stripe Invoicing, Xero, QuickBooks, and SAP S/4HANA. Normalizes counterparty Tax/VAT ID, Company Registration Number, IBAN, and currency in Worker RAM (Zero-Retention), executes verify_id + commerce_reconcile + fx_best_execution, and returns a signed XDR-1 receipt URL. Authenticate with Authorization: Bearer ck_live_ or x402 v2 PAYMENT-SIGNATURE.'
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.005'
          max: '0.05'
        protocols:
        - x402: {}
        note: Published floor and ceiling. Read accepts[0].amount on HTTP 402 before authorizing.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
              properties:
                id:
                  type: string
                  description: External order, bill, or invoice ID
                currency:
                  type: string
                  default: GBP
                total_price:
                  type:
                  - string
                  - number
                  description: Shopify B2B total price
                billing_address:
                  type: object
                  properties:
                    country_code:
                      type: string
                      default: GB
                company:
                  type: object
                  properties:
                    tax_id:
                      type: string
                      description: Buyer VAT or Tax ID
                    external_id:
                      type: string
                      description: Buyer Company Registration Number (CRN)
                iban:
                  type: string
                  description: Supplier IBAN for ISO 7064 MOD-97 check
            example:
              id: shopify_b2b_9001
              currency: EUR
              total_price: '2500.00'
              billing_address:
                country_code: 'NO'
              company:
                tax_id: NO971036081MVA
                external_id: '971036081'
              iban: NO9386011117947
      responses:
        '200':
          description: Stateless verification verdict (`CLEAR` or `FLAG_FOR_REVIEW`) + signed XDR-1 receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment or `ck_live_` Bearer quota key required (`https://hcrb.in/checkout?module=commerce_reconcile`)
      tags:
      - Webhooks
    servers:
    - url: https://hcrb.in
components:
  securitySchemes:
    OperatorQuotaBearer:
      type: http
      scheme: bearer
      description: Prepaid non-custodial quota key (ck_live_...) purchased at https://hcrb.in/checkout
    X402PaymentSignature:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: Base64-encoded EIP-3009 transferWithAuthorization voucher on Base (eip155:8453)
x-refined-from:
- code402-dev-openapi-hcrb.json
- code402-dev-openapi.yml