Modular settlement OS

결제·정산을 Receipt 하나로.
PayFi · Agentic · A2A.

SoftLedger는 파트너 웹훅을 표준 Receipt FSM으로 정규화합니다. PayApp, PayFi, px402 agentic payment, A2A, agentic commerce를 동일한 정산 커널 위에서 운영·검증할 수 있습니다.

Commerce manifest Health check

Ledger 확인 중…

// PayApp · agent service · commerce orchestrator
import { parseAgenticPaymentWebhook } from
  '@paychain/integrations-kit';

const parsed = parseAgenticPaymentWebhook(body);
// requestId: px402:job:… → Receipt AUTHORIZED

10분 Quickstart

스테이징에서 manifest → register → webhook 순으로 연결합니다.

1 · Discovery
GET /api/integrations/commerce-rails/manifest — 활성 rail·webhook URL·env 체크리스트.
2 · Register
온보딩 UI 또는 POST /api/integrations/onboard/register — merchantId·webhook secret.
3 · Webhook
파트너 이벤트를 rail별 endpoint로 POST — HMAC 서명 포함. Receipt가 생성·전이됩니다.

온보딩 UI 열기 Ops readiness

모듈화 · 재사용 · 연계

Ledger는 오케스트레이터만 담당합니다. 파트너 레일은 kit·adapter로 임베드하거나 웹훅으로 연결합니다.

integrations-kit

Webhook bridges

PayApp · PayFi · Stripe · onramp · px402 · A2A · agentic commerce 파서 + HMAC 검증 + mock sweep.

settlement-kernel

Job ↔ Receipt

px402:job: · a2a:job: · commerce:job: prefix SSOT. Global ledger · amend · pipeline.

execution-adapter-*

Execution rails

PSP · 3DS · payout · escrow · payfi-vault · x402 — Receipt 상태와 분리된 실행 어댑터.

agent-sdk

Agentic layer

px402 agent client · registry SDK · OIDC skeleton. Agentic payment → Ledger webhook 또는 sidecar.

Commerce rails

Railway Ledger + Supabase Postgres. Merchant registry는 Postgres에 영속화됩니다.

PayApp · PayFi

Traditional + PayFi

모바일 PG · payout · escrow · vault. PSP 3DS authenticate op.

px402

Agentic payment

Agent가 API·리소스에 지불. job.funded → AUTHORIZED → COMMITTED.

A2A

Agent-to-agent

에이전트 간 결제·escrow. Session → a2a:job: binding.

Agentic commerce

Commerce orchestration

장바구니·체크아웃·정산 handoff. Order → commerce:job:.

Developer API

Ledger API base는 환경에 따라 설정됩니다. 쿼리: ?api=https://your-ledger.up.railway.app

GET /api/integrations/commerce-rails/manifest Commerce rails discovery

GET /api/public/health 운영 health · store · integrations

GET /api/integrations/ops/readiness env checklist · merchant registry

GET /api/integrations/onboard Onboard UI · simulate · mock sweep (dev)

POST /api/integrations/px402/webhook Agentic payment webhook

POST /api/integrations/a2a/webhook A2A payment webhook

POST /api/integrations/agentic-commerce/webhook Agentic commerce webhook

POST /api/integrations/mock/sweep Dev: 6 rails end-to-end (INTEGRATIONS_ONBOARD_DEV=1)

Developer docs

연동·운영·모듈 가이드. 기술 문서 중심 — Medium·논문 링크는 공개 표면에 포함하지 않습니다.

Guide

Modular guide

임베드 패턴 · commerce rails · mock harness · npm publish · UX 가이드.

Developer

Developer guide

Ledger API · Receipt FSM · SoftLedger 10분 연동 · ops env.

Ops

Production env

Railway 변수 템플릿 · webhook secrets · adapter flags.

Design system

Plus Jakarta Sans · JetBrains Mono · teal / indigo on slate — brand/TOKENS.md

결제·정산을 Receipt 하나로.PayFi · Agentic · A2A.