Document Pipeline

{
  "flat_price_usd": 0.05,
  "note": "ILLUSTRATIVE SAMPLE showing the exact response shape, composed from real component outputs (parse/verify samples recorded 2026-07-27); this bundled product itself had no production calls when this sample was written. LLM-backed, production only. No payment was taken.",
  "ok": true,
  "sample": true,
  "stages": {
    "fields": {
      "data": {
        "currency": "JPY",
        "customer": "Example Buyer Inc.",
        "due_date": "2026-08-31",
        "invoice_no": "INV-2026-0731",
        "issue_date": "2026-07-31",
        "line_items": [
          [
            "consulting",
            1,
            10000,
            10000
          ]
        ],
        "reg_no": "T0123456789012",
        "subtotal": "10000",
        "tax_jpy": "1000",
        "total_jpy": "11000",
        "vendor": "Example Seller K.K."
      },
      "ok": true
    },
    "parse": {
      "chars": 1620,
      "ok": true,
      "pages": 1,
      "route": "embedded"
    },
    "verify": {
      "checks": [
        {
          "check": "tax_rate_10pct",
          "pass": true
        },
        {
          "check": "line_items_sum_eq_subtotal",
          "pass": true
        },
        {
          "check": "invoice_reg_no_checkdigit",
          "pass": true
        }
      ],
      "corp_registry": {
        "note": "existence only - NOT qualified-invoice-issuer registration status",
        "source": "Japan NTA corporate number registry",
        "status": "found",
        "vendor_name_match": "exact"
      },
      "ok": true,
      "verified": true
    }
  }
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://mart402.com/v1/document-pipeline' \
  -H 'content-type: application/json' \
  --data-raw '{"enrich":false,"url":"https://mart402.com/samples/assets/doc.pdf"}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://mart402.com/v1/document-pipeline' \
  -H 'content-type: application/json' \
  --data-raw '{"enrich":false,"url":"https://mart402.com/samples/assets/doc.pdf"}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.05 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.05" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.05 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fmart402.com%2Fv1%2Fdocument-pipeline&method=POST
const res = await pay("https://mart402.com/v1/document-pipeline", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "enrich": false,
    "url": "https://mart402.com/samples/assets/doc.pdf"
  }),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.05 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.05"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://mart402.com/v1/document-pipeline",
        json={
            "enrich": False,
            "url": "https://mart402.com/samples/assets/doc.pdf",
        },
    )
    print(res.status_code, res.text)