웹 전용, moove.xyz/dashboard/api-keys에서. 모바일 대응 화면은 없습니다.
API 키는 어떻게 만드나요?
1
관리 → API 키 열기
웹 대시보드에서.
2
이름 붙이기
6개월 뒤에도 알아볼 수 있는 이름 — 어떤 서비스나 환경을 위한 키인지.
3
에이전트 고르기
실제로 존재하는 것은 Moove Receive Agent입니다. 그 에이전트에 필요한 범위로 펼쳐집니다.
4
키 복사하기
https://api.moove.xyz입니다.
원시 범위가 아니라 Moove 에이전트
권한 문자열이 아니라 에이전트를 고릅니다. “Moove Receive Agent”는 판매자가 이해할 수 있는 단위이고,payment_link:create는 그렇지 않습니다.
곧 출시되는 세 에이전트는 비활성 상태로 표시됩니다. 그중 하나를 선택하면 아무 권한도 없는 키가 만들어지므로, 선택기가 이를 허용하지 않습니다.
API 키가 할 수 있는 것과 할 수 없는 것
키는 당신의 축소판입니다. 당신의 계정으로 동작하며, 당신이 할 수 있는 일의 일부만 할 수 있습니다.자금을 옮기는 엔드포인트는 없습니다. 결제 링크는 언제나 당신의 기본 지갑으로, 그 지갑의 토큰으로 정산됩니다 — 호출하는 쪽이 목적지를 지정할 수 없습니다. 유출된 키는 당신에게 지급되는 요청을 만들 수 있을 뿐, 다른 누구에게도 지급할 수 없습니다.
키를 어떻게 안전하게 지키나요?
키는 몇 개까지 가질 수 있나요?
계정당 활성 키 10개까지입니다. 열한 번째를 만들면 요청이TOO_MANY_API_KEYS로 거부되니, 더 쓰지 않는 키를 먼저 폐기하세요.
키는 어떻게 폐기하나요?
1
키 메뉴 열기
관리 → API 키에서 해당 키 행의 … 메뉴를 열고 해지를 고르세요.
2
확인하기
확인하려면 해지를 한 번 더 클릭하세요. 키는 즉시 작동을 멈춥니다.
키는 어떻게 사용하나요?
모든 요청의X-API-Key 헤더에 담아 보내세요.
첫 호출 전에
API는 결제를 받을 수 없는 계정을 위해서는 링크를 만들지 않습니다. Moove 핸들을 확보하고 정산 토큰이 설정된 기본 지갑을 지정했는지 확인하세요 — 그러지 않으면409가 돌아옵니다.
다음에 읽을 것
인증
헤더가 작동하는 방식.
Moove Agentic Payments
AI 도구가 연동을 대신하게 하기.
Moove Payment Links API
엔드포인트 전체.