서비스 개요 (Introduction)
SoloPay는 블록체인 기반 결제 게이트웨이입니다. 가맹점이 ERC-20 토큰 결제를 서비스에 손쉽게 통합할 수 있도록 REST API와 SDK를 제공합니다.
서비스 소개
SoloPay의 핵심 특징은 가스리스(Gasless) 결제입니다. 사용자는 MetaMask 등의 지갑에서 서명 한 번만 하면 결제가 완료됩니다. 가스비(네트워크 수수료)는 SoloPay 릴레이어(Relayer) 서버가 대신 부담합니다.
도입 장점
| 항목 | 설명 |
|---|---|
| 가스비 없는 UX | 사용자가 ETH/MATIC 같은 네이티브 토큰 없이 서명만으로 결제 완료 |
| 빠른 연동 | REST API 또는 SDK로 수 시간 내 연동 가능 |
| orderId 중복 방지 | 주문 ID 기반 멱등성(idempotency) 보장 |
| 실시간 알림 | Webhook으로 결제 상태 변경을 즉시 수신 |
| 멀티 토큰 지원 | 가맹점이 원하는 ERC-20 토큰을 결제 수단으로 지정 |
| 환불 기능 내장 | API만으로 온체인 환불 처리 |
지원 네트워크 및 자산
지원 체인
| 체인 | 네트워크 ID | 구분 |
|---|---|---|
| Polygon | 137 | Mainnet |
| Polygon Amoy | 80002 | Testnet |
서비스 엔드포인트
SoloPay는 개발 환경과 운영 환경을 별도로 제공합니다. 두 환경 모두 Testnet(Amoy)과 Mainnet(Polygon)을 지원합니다.
개발 환경 — 공지 없이 수시 업데이트
| 서비스 | URL |
|---|---|
| 결제 API 서버 | https://gateway.dev.solonetwork.io |
| 연동 가이드 | https://guide.dev.solonetwork.io |
| 결제 위젯 | https://widget.dev.solonetwork.io |
| 샘플 가맹점 | https://sample-merchant.dev.solonetwork.io |
운영 환경 — 변경사항 사전 공지 후 업데이트
| 서비스 | URL |
|---|---|
| 결제 API 서버 | https://gateway.solonetwork.io |
| 연동 가이드 | https://guide.solonetwork.io |
| 결제 위젯 | https://widget.solonetwork.io |
| 샘플 가맹점 | https://sample-merchant.solonetwork.io |
운영 환경 안내
운영 환경은 아직 공개되지 않았습니다. 연동 및 테스트에는 개발 환경 엔드포인트를 사용해 주세요.
지원 토큰
가맹점별로 결제 수단으로 사용할 ERC-20 토큰을 직접 지정할 수 있습니다. 토큰은 SoloPay 플랫폼의 화이트리스트에 등록되어야 합니다.
Permit(EIP-2612) 지원 토큰
USDC 등 EIP-2612를 지원하는 토큰은 최초 결제 시에도 Approve 트랜잭션 없이 100% 가스리스 결제가 가능합니다. 지원 여부는 연동하려는 토큰의 컨트랙트 스펙을 확인하세요.
사전 준비 사항
SoloPay를 사용하려면 아래 절차가 필요합니다.
1. 가맹점 등록
SoloPay 운영팀에 가맹점 등록을 요청합니다. 등록 시 아래 정보가 필요합니다.
- 서비스(쇼핑몰 등) 도메인 주소
- 사용할 체인 (예: Polygon Amoy 80002)
- 수령 지갑 주소 (결제 금액을 받을 ERC-20 토큰 지갑)
- 결제에 사용할 토큰 주소
2. API Key 발급
가맹점 등록 후 운영팀으로부터 두 가지 키를 발급받습니다.
| 키 종류 | 접두사 | 용도 | 사용 |
|---|---|---|---|
| API Key | sk_... | 관리/설정 작업 (초기 세팅) | 클라이언트 코드에 절대 포함 금지 |
| Public Key | pk_... | 결제 생성, 상태 조회 | 클라이언트 사이드 (위젯) |
API Key 보안
sk_ 로 시작하는 API Key는 절대 프론트엔드 코드에 포함하지 마세요. API Key는 관리/설정 목적으로만 사용되며, 클라이언트 사이드 위젯 연동에는 필요하지 않습니다.
3. 결제 수단(토큰) 활성화
가맹점 등록 후 결제에 사용할 토큰을 활성화합니다. 이 단계는 클라이언트 사이드 연동과 별개로 진행하는 1회성 관리 설정입니다.
관리 설정
SoloPay 운영팀에 문의하거나 대시보드를 통해 결제 수단을 활성화합니다. API를 직접 사용하는 경우 POST /merchant/payment-methods 엔드포인트에 API Key(sk_...)가 필요합니다.