빠른 시작
이 가이드를 따라 5분 안에 첫 스테이블코인 결제를 연동해보세요.
사전 요구사항
- Volr Dashboard 계정 및 프로젝트
- API Key (Dashboard에서 발급)
- 테스트용 USDC (Base Testnet 또는 Sepolia)
Step 1: API Key 발급
- Volr Dashboard에 로그인
- 프로젝트 선택 → Settings → API Keys
- API Key 복사 (예:
volr_sk_xxx...)
API Key 보안
API Key는 서버 사이드에서만 사용하세요. 클라이언트(브라우저, 앱)에 노출하면 안 됩니다.
Step 2: Checkout 생성
curl -X POST https://api.volr.io/dashboard/projects/{projectId}/checkouts \
-H "x-api-key: volr_sk_xxx" \
-H "Content-Type: application/json" \
-d '{
"chainId": 8453,
"tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"fiatAmount": "5000",
"fiatCurrency": "KRW",
"itemName": "아메리카노",
"referenceId": "ORDER-12345"
}'
응답
{
"ok": true,
"data": {
"id": "cm5xyz123...",
"chainId": 8453,
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"amount": "3703703",
"depositAddress": "0xabc123...",
"status": "PENDING",
"expiresAt": "2026-01-30T11:00:00.000Z",
"fiatAmount": "5000",
"fiatCurrency": "KRW",
"exchangeRateUsed": "1350.50",
"itemName": "아메리카노",
"referenceId": "ORDER-12345"
}
}
Step 3: QR 코드 표시
depositAddress를 QR 코드로 표시합니다. 고객이 이 주소로 스테이블코인을 전송하면 결제가 완료됩니다.
Step 4: 결제 확인
Webhook (권장)
Dashboard에서 Webhook URL을 설정하면 결제 완료 시 자동으로 알림을 받습니다.
{
"event": "checkout.paid",
"data": {
"checkoutId": "cm5xyz123...",
"status": "PAID",
"fiatAmount": "5000",
"fiatCurrency": "KRW",
"exchangeRateUsed": "1350.50",
"paymentTxHash": "0xdef456...",
"referenceId": "ORDER-12345"
}
}