시작하기
Eppay를 처음 사용하시나요? 첫 암호화폐 결제를 받기 전에 모든 가맹점에 필요한 세 단계를 안내합니다.
1. 계정을 만들고 이메일을 인증하세요
eppay.io에서 이메일 또는 소셜 로그인(Google, Facebook)으로 가입하세요. 받은 편지함에 도착한 주소를 인증하시면 결제 알림과 보안 알림을 보내드릴 수 있습니다.
2. 수취 지갑 주소를 등록하세요
설정을 열고 결제를 받으려는 각 블록체인에서 본인이 관리하는 지갑 주소를 붙여넣으세요. Eppay는 자금을 보관하지 않습니다 — 모든 결제는 설정하신 주소로 직접 정산됩니다.
3. API 키를 발급하거나 결제 링크를 만드세요
일회성 청구서는 상품을 만들어 호스팅된 결제 링크를 공유하세요. 체크아웃 연동의 경우 API 탭에서 API 키를 발급하고 POST /api/v2/create-payment를 호출해 프로그램으로 링크를 생성하세요.
결제 및 승인
Eppay는 아래 네트워크에서 USDT 및 USDC 스테이블코인 결제를 처리합니다. 각 체인마다 승인 속도와 수수료 구조가 다릅니다.
지원 네트워크
Ethereum, Binance Smart Chain(BSC), Polygon, Arbitrum, Avalanche, Fantom, Cronos, Celo, Cosmos입니다. 가맹점 수요에 따라 체인을 계속 추가하고 있으니 필요한 네트워크를 알려주세요.
지원 토큰
지원되는 각 체인의 USDT(Tether)와 USDC(USD Coin)입니다. 둘 다 USD에 연동된 스테이블코인이므로 고객이 보내는 금액은 결제 시 표시한 가격과 일치합니다.
승인에는 얼마나 걸리나요?
승인 시간은 체인에 따라 다릅니다. BSC, Polygon, Arbitrum에서는 보통 1분 이내에 결제가 확정됩니다. Ethereum 메인넷에서는 일반적인 네트워크 상황에서 약 1~3분, 수수료가 급등할 때는 그보다 오래 걸립니다. 온체인 거래가 필요한 승인 수에 도달하는 즉시 Eppay는 결제를 "완료"로 표시합니다.
네트워크 수수료는 누가 부담하나요?
고객이 선택한 체인의 가스 수수료를 부담합니다. Eppay는 계정 대시보드에 명시된 플랫폼 수수료 외에는 결제 자체에서 수수료를 받지 않습니다.
고객이 금액을 적게 보내면 어떻게 되나요?
고객이 요청 금액보다 적게 보내면 결제는 부분 결제로 기록되며, 잔액이 도착하거나 링크가 만료될 때까지 링크가 유지됩니다. 부분 결제에 대한 환불은 귀하와 고객 간에 직접 처리하며, Eppay는 자금을 보관하지 않습니다.
API 및 연동
Eppay는 REST API, Shopify 앱, 그리고 어떤 웹 스택에도 결제를 삽입할 수 있는 JavaScript SDK를 제공합니다.
API 키는 어디서 발급받나요?
로그인 후 대시보드에서 API 탭을 열고 Create API Key를 클릭하세요. 각 키는 귀하의 계정에 한정되며 언제든 폐기하고 교체할 수 있습니다. API 키는 비밀번호처럼 취급하고 서버 측에만 보관하세요.
API v1과 v2 중 무엇을 사용해야 하나요?
새로운 연동에는 모두 v2를 사용하세요. v2 엔드포인트(POST /api/v2/create-payment, GET /api/v2/payments/{id}/status)가 지원되는 표준입니다. v1 엔드포인트는 기존 호출자를 위해 여전히 응답하지만 새 작업에는 사용하지 마세요.
웹훅을 지원하나요?
지원합니다. 계정에서 웹훅 URL을 설정하면 결제 상태가 변경될 때 Eppay가 서명된 JSON 페이로드를 POST로 전송합니다. 이벤트를 신뢰하기 전에 서명 헤더를 검증하세요.
Shopify 연동은 어떻게 작동하나요?
Shopify 앱스토어에서 Eppay 앱을 설치하고 Eppay 계정과 연결하면 고객에게 암호화폐가 결제 옵션으로 표시됩니다. 결제는 Eppay에 설정한 지갑으로 정산되며, 온체인 거래가 승인되면 Shopify에서 주문이 자동으로 결제 완료 처리됩니다.
계정 및 보안
계정 관련 자주 묻는 질문입니다:
비밀번호를 잊어버렸습니다
로그인 페이지의 "비밀번호 찾기" 링크를 이용하세요. 60분간 유효한 재설정 링크를 이메일로 보내드립니다. 메일이 도착하지 않으면 스팸함을 확인하고 가입에 사용한 주소가 맞는지 확인하세요.
2단계 인증은 어떻게 설정하나요?
프로필 설정을 열고 2FA 설정 마법사를 따르세요. 지갑 주소를 추가하거나 API 키를 발급하기 전에 2FA를 활성화하시길 권장합니다.
지갑 주소를 변경할 수 있나요?
가능합니다. 설정에서 언제든 주소를 수정하세요. 이후 결제는 새 주소로 전달됩니다. 이미 진행 중인 결제는 결제 링크 생성 당시 활성화되어 있던 주소로 정산됩니다.
문제 해결
가장 자주 발생하는 다섯 가지 문제와 해결 방법입니다:
결제가 "대기 중"에서 멈춰 있습니다
대기 중은 거래가 전파되었지만 체인에서 필요한 승인 수에 도달하지 못했다는 뜻입니다. 블록 탐색기(Ethereum은 etherscan.io, BSC는 bscscan.com, Polygon은 polygonscan.com 등)에서 거래 해시를 조회해 채굴 여부를 확인하세요. 온체인에서는 승인되었는데 10분이 지나도 Eppay에서 대기 중이라면 거래 해시와 함께 문의해 주세요.
고객이 다른 체인으로 결제했습니다
동일한 지갑 주소로 관리 중인 체인에서 결제를 받으셨다면(대부분의 EVM 체인은 주소 형식을 공유합니다) 해당 체인에서 자금을 회수할 수 있습니다. 고객이 귀하가 키를 보유하지 않은 체인으로 보냈다면 안타깝게도 Eppay를 통해서는 회수할 수 없습니다.
API 키가 401 Unauthorized를 반환합니다
키를 Authorization 헤더에 Bearer 토큰으로 전달하고 있는지, 대시보드에서 키가 폐기되지 않았는지, 올바른 환경을 호출하고 있는지 확인하세요. 마지막 수단으로 키를 다시 발급하세요.
표시된 금액이 실제 송금액과 다릅니다
Eppay는 금액을 스테이블코인(USDT 또는 USDC)으로 표시하므로 1 USDT를 받으면 1 USDT가 나갑니다 — 환전이 없습니다. 고객이 다른 토큰(예: USDT 대신 ETH)을 보냈다면 결제가 일치하지 않습니다. 소수점 정밀도는 체인마다 다르며 기본적으로 소수점 여섯 자리까지 표시합니다.
웹훅이 전혀 호출되지 않습니다
URL이 외부에서 접근 가능한지(localhost나 VPN 전용 호스트가 아닌지), 5초 이내에 HTTP 2xx로 응답하는지, 방화벽이 저희 IP를 차단하고 있지 않은지 확인하세요. 전송에 실패하면 최대 24시간 동안 지수적 간격으로 재시도합니다.
응답 시간
모든 이메일에 영업일 기준 1일(월~금) 이내 답변을 드리고자 합니다. 결제를 막는 긴급한 문제는 우선 처리합니다. 업무 시간은 중앙유럽시간을 기준으로 하지만, 팀이 여러 지역에 분산되어 있어 그 외 시간에도 답변드리는 경우가 많습니다.
더 빠른 답변을 위해 첫 이메일에 다음을 포함해 주세요: 계정 이메일, 해당되는 경우 결제 ID 또는 거래 해시, 네트워크, 스크린샷 또는 오류 메시지.
비즈니스 및 제휴 문의
제휴, 대규모 연동, 맞춤 정산 조건 또는 언론 문의는 제목에 "Partnership"을 적어 info@eppay.io로 보내주시고 구축 중인 내용을 간략히 알려주세요. 모든 정식 문의에 영업일 기준 2일 이내로 답변드립니다.