Moove API
호출 한 번. 전액 수령.
코드에서 결제 링크를 만드세요. 고객은 어떤 토큰으로든 결제하고, 금액은 원하는 토큰으로 전액 받습니다.
키 발급부터 첫 결제까지.
API 키 만들기
Moove Business에서 Moove Receive Agent용 키를 만드세요. 키는 한 번만 표시되므로 바로 환경 변수에 넣어 두세요.결제 링크 만들기
POST 한 번이면 결제 URL이 반환됩니다. 고객은 그곳에서 어떤 체인의 어떤 토큰으로든 결제합니다.결제되면 알림 받기
HTTPS 엔드포인트를 등록하면 링크가 결제되는 즉시 Moove가 서명된 이벤트를 보냅니다.
작은 API, 확실한 보장.
어떤 토큰으로 받든, 정산은 내 토큰으로
고객은 30개 이상의 블록체인 네트워크에서 보유한 자산으로 결제합니다. 모든 결제는 선택한 체인과 토큰으로 지갑에 정산됩니다.믿고 개발할 수 있는 API 규약
경로로 버전을 관리하고, v1에서는 추가만 하며, 실시간 OpenAPI 스키마를 제공합니다.명확한 한도, 명확한 오류
키별·IP별 한도, 단순한 429, 안정적인 코드를 갖춘 하나의 오류 형식.API 자체는 무료입니다.
구독료도, 호출당 요금도 없습니다. 다른 토큰이나 체인으로 결제하는 고객이 0.02%를 부담하므로 전액을 받습니다.- API 이용
- 무료
- 같은 토큰, 같은 네트워크
- 무료
- 토큰 또는 네트워크 간
- 0.02%
Moove vs 직접 구축.
| Moove vs 직접 구축. | Moove | 자체 구축 |
|---|---|---|
| 지원 체인 | Moove: 엔드포인트 하나로 30개 이상 | 자체 구축: 체인마다 별도 연동 |
| 내 토큰으로 변환 | Moove: 모든 결제에 기본 포함 | 자체 구축: 스왑·브리지 라우팅 직접 구축 |
| 결제 도착 확인 | Moove: 서명된 웹훅과 목록 엔드포인트 | 자체 구축: 체인마다 직접 운영하는 리스너 |
| 결제 페이지 | Moove: 호스팅된 링크, 바로 공유 가능 | 자체 구축: 디자인, 개발, 호스팅 모두 직접 |
| 키가 유출되면 | Moove: 나에게 오는 결제 요청만 가능 | 자체 구축: 핫월렛에 있는 모든 자산 |
자주 묻는 질문.
API 키는 어떻게 받나요?
Moove Business 콘솔에 로그인해 API 키 메뉴를 여세요. 키 이름을 정하고 Moove Receive Agent를 선택하면 결제 링크를 만들고 조회할 수 있는 권한이 부여됩니다. 전체 키는 생성할 때 한 번만 표시되고 다시는 볼 수 없으므로 시크릿 매니저에 보관하세요. 키를 만드는 엔드포인트가 없으므로 하나의 키로 다른 키를 발급할 수 없습니다.
고객이 결제하면 돈은 어디로 가나요?
키 소유자의 기본 지갑으로, 해당 지갑의 체인과 정산 토큰으로 들어갑니다. 호출하는 쪽에서 다른 수신처를 지정할 수 없습니다. 그래서 첫 호출 전에 계정에 등록된 Moove handle과 정산 토큰이 설정된 기본 지갑이 모두 있어야 합니다. 둘 중 하나라도 없으면 링크를 만들 때 계정이 결제를 받을 준비가 되지 않았다는 409가 반환됩니다.
지급 API가 있나요?
아직 없습니다. 이 API는 결제를 받을 뿐 보내지는 않습니다. 지금 공급업체나 계약자에게 지급하려면 Moove Business 콘솔의 송금을 사용하세요. Moove Send Agent가 발표되었으며, 출시되면 문서에 추가됩니다.
Moove 웹훅은 어떻게 작동하나요?
콘솔에서 HTTPS 엔드포인트를 최대 5개까지 등록하세요. 각 엔드포인트는 두 가지 이벤트를 받습니다. 링크에 대한 결제가 정산될 때, 그리고 링크가 완료될 때입니다. 전송은 한 번만 표시되는 시크릿으로 HMAC-SHA256 서명됩니다. 최소 한 번(at-least-once) 전송되므로 이벤트 ID로 중복을 제거하세요. 실패한 전송은 최대 6회까지 재시도됩니다.
요청 속도 제한이 있나요?
네. 요청은 API 키별, 출발지 IP별로 제한되며 먼저 도달한 한도가 적용되고, 초과하면 429가 반환됩니다. 거부된 요청도 횟수에 포함되므로 즉시 재시도하지 말고 지터를 더한 지수 백오프를 적용하세요. 결제 상태는 링크 하나를 반복 조회하지 말고 웹훅으로 받으세요. 여러 연동이 한 호스트를 공유한다면 IP 한도를 기준으로 요청량을 계획하세요.
API 버전은 어떻게 관리되나요?
경로로 관리합니다. 현재 공개 버전은 v1 하나입니다. 한 버전 안의 변경은 새 엔드포인트, 새 선택 필드, 새 응답 필드처럼 추가만 합니다. 필드 삭제나 타입 변경처럼 클라이언트를 깨뜨릴 수 있는 변경은 새 경로 버전으로 배포됩니다. 클라이언트는 알 수 없는 필드를 무시하고, 메시지가 아닌 오류 코드로 분기하도록 만드세요.
