Checkout API
Volr Checkout API를 사용하면 자체 결제 화면을 직접 구현할 수 있습니다. 키오스크, POS, 모바일 앱, 웹사이트 등 어디서든 원하는 UI로 스테이블코인 결제를 받을 수 있습니다.
개요
Volr Checkout은 다음과 같은 기능을 제공합니다:
- QR 코드 기반 결제: 고객이 스마트폰으로 QR 코드를 스캔하여 결제
- 다중 법정화폐(Fiat) 지원: USD, KRW, EUR 등 다양한 통화로 가격을 설정하면 생성 시점 환율 기준으로 스테이블코인 금액으로 자동 변환
- 실시간 결제 감지: 블록체인 트랜잭션을 자동으로 감지하고 검증
- Webhook 알림: 결제 완료 시 서버로 알림 전송
아키텍처
핵심 개념
Checkout
결제 요청 단위입니다. 각 Checkout은 고유한 ID와 입금 주소(deposit address)를 가집니다.
Deposit Address
CREATE2로 생성된 결정론적 주소로, 고객이 토큰을 전송하면 자동으로 판매자에게 정산됩니다.
Fiat Payment
USD, KRW, EUR 등 지원되는 법정화폐로 가격을 설정하면 Volr API가 생성 시점의 환율로 스테이블코인 금액을 계산합니다. 환율 변동 리스크는 expiryMinutes 파라미터로 관리할 수 있습니다 (기본 30분, 최대 1440분).
가격 설정 방식
Volr Checkout은 다양한 사용 사례에 맞는 두 가지 가격 설정 방식을 지원합니다:
1. 암호화폐 기준 (고정 토큰 수량)
받고 싶은 정확한 토큰 수량을 지정합니다. 환율 변환이 없습니다.
{
"chainId": 8453,
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"amount": "499000000"
}
사용 사례: "정확히 499 USDC를 받고 싶습니다"
- 고객은 정확히 499 USDC를 지불
- 환율 리스크 없음
- 예측 가능한 암호화폐 수량이 필요할 때 적합
2. 법정화폐 기준 (고정 법정화폐 가치)
법정화폐 금액을 지정하면 Volr이 현재 환율로 토큰 수량을 계산합니다.
{
"chainId": 8453,
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"fiatAmount": "499",
"fiatCurrency": "USD"
}
사용 사례: "$499 상당의 USDC 를 받고 싶습니다"
- 체크아웃 생성 시점에 토큰 수량 계산 (예: USDC = $0.9996일 경우, 고객은 ~499.2 USDC 지불)
- 생성 시점의 환율로 고정
- 예측 가능한 법정화폐 가치가 필요할 때 적합
어떤 방식을 선택해야 할까요?
- 암호화폐 기준: 크립토 네이티브 상품을 판매하거나 정확한 토큰 수량이 필요할 때
- 법정화폐 기준: 비즈니스가 법정화폐 기준으로 운영될 때 (예: "99,000원짜리 상품")
지원 토큰
현재 지원되는 스테이블코인:
| 토큰 | 지원 네트워크 |
|---|---|
| USDC | Base |
추가 예정
Arbitrum, Polygon 네트워크 및 USDT 토큰 지원이 향후 추가될 예정입니다.
다음 단계
- 빠른 시작 - 5분 안에 첫 결제 연동하기
- 인증 - API Key 발급 및 인증
- Checkout 생성 - Checkout 생성 API 상세