Volr에 오신 것을 환영합니다
Volr은 스테이블코인 결제를 받기 위한 체크아웃 솔루션입니다. API로 체크아웃을 생성하고, 결제 링크를 공유하고, 온체인 결제가 확인되면 웹훅 알림을 받으세요.
작동 방식
왜 스테이블코인 체크아웃인가?
- 글로벌 결제 — 100개국 이상에서 결제 수신, 가맹점 계좌 불필요
- 낮은 수수료 — 카드 결제 2.9% + $0.30 대비 ~0.5%
- 차지백 없음 — 블록체인 거래는 최종적
- 즉시 정산 — 온체인 확인 후 바로 지갑에 입금
- 법정화폐 가격 책정 — USD/KRW로 가격 설정, 토큰 금액 자동 변환
연동 방식
Checkout SDK (권장)
서버 사이드 TypeScript SDK로 프로그래밍 방식으로 체크아웃을 생성하고 관리합니다.
npm install @volr/checkout-sdk
import { VolrCheckout } from '@volr/checkout-sdk';
const volr = new VolrCheckout({ serverKey: process.env.VOLR_SERVER_KEY! });
const checkout = await volr.create({
chainId: 8453,
tokenAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
merchantAddress: '0xYOUR_WALLET',
fiatAmount: '25.00',
fiatCurrency: 'USD',
itemName: '프리미엄 플랜',
});
Checkout API
모든 언어와 플랫폼에서 사용할 수 있는 HTTP API입니다.
curl -X POST https://api.volr.io/v1/checkouts \
-H "X-API-Key: volr_server_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"chainId": 8453, "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "merchantAddress": "0xYOUR_WALLET", "fiatAmount": "25.00", "fiatCurrency": "USD"}'
AI 지원 연동
AI 코딩 어시스턴트(Claude Code, Cursor, Codex, Windsurf)와 함께 Volr Skills를 사용하여 가이드된 연동을 할 수 있습니다.
npx create-volr
volr skill install
시작하기
- CLI 설치 —
npx create-volr(프로젝트 생성 + 토큰 설정) - 빠른 시작 — SDK 설치 및 첫 체크아웃 만들기
- Checkout SDK — SDK 상세 문서
- Checkout API — REST API 레퍼런스
가장 빠른 연동 방법
npx create-volr로 프로젝트를 설정한 후, AI 코딩 어시스턴트(Claude Code, Cursor, Codex, Windsurf)를 사용하여 SDK 연동을 진행하세요.
npx create-volr
volr skill install
```자세한 내용은 [AI 연동 가이드](./skills/intro)를 참고하세요.