상점·프로젝트 정보

현재 인증의 프로젝트 정보와 상점 정보를 조회하고, 웹훅 테스트를 발송합니다.

프로젝트 정보

GEThttps://api.bootapi.com/v1/projects/meBasic Auth

파라미터가 없습니다. 현재 인증에 물린 프로젝트​​를 돌려줍니다. 유효한 프로젝트 키만 확인하고 scope 는 검사하지 않습니다. 응답에는 server_key·private_key 같은 비공개 키도 있으므로 화면이나 로그에 원문을 남기지 않습니다. 프로젝트 응답 필드

curl -X GET "https://api.bootapi.com/v1/projects/me" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash
키 확인

운영 키로 개발 프로젝트를 부르고 있거나 결제용 키를 커머스에 넣은 경우 이 호출 결과로 확인할 수 있습니다.

상점 정보

GEThttps://api.bootapi.com/v1/storeBasic Auth

몰 설정(mall)과 판매자 기본 정보(seller)를 함께 돌려줍니다.

{
  "mall": { "status": 1, "...": "..." },
  "seller": { "...": "..." }
}json
몰이 꺼져 있으면 HTTP 442 입니다

몰 설정의 status 가 비활성이면 442 MALL_INACTIVE 로 거절됩니다. 이 API 는 422 대신 442 를 사용합니다. 상품 목록도 같은 검사를 하니, 상품 조회가 갑자기 막히면 여기부터 확인합니다. 공통 오류 형식

필요한 권한

상점 정보·상점 상세는 연동키에 user:product_detail scope 가 있어야 합니다. 없으면 401 API_SCOPE_INVALID 로 거절됩니다.

상점 상세 정보

GEThttps://api.bootapi.com/v1/store/detailBasic Auth

사업자 정보를 포함한 판매자 상세를 돌려줍니다. 청구서·영수증 하단의 사업자 표기를 만들 때 사용합니다.


웹훅 테스트 발송

POSThttps://api.bootapi.com/v1/webhook/testBasic Auth

실제 결제 없이 order.done 모양의 웹훅 한 건​​을 보내 봅니다. 수신 서버가 본문 파싱·멱등 처리·응답을 제대로 하는지 확인하는 용도입니다.

파라미터 타입 필수 설명
webhook_url String 선택 보낼 주소. 생략하면 프로젝트에 등록된 웹훅 URL 로 보냅니다
header_content_type Integer 선택 전송 Content-Type. 생략하면 프로젝트 설정을 따릅니다
curl -X POST "https://api.bootapi.com/v1/webhook/test" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -H "Content-Type: application/json" \
  -d '{ "webhook_url": "https://your-server.example.com/webhook/commerce" }'bash
{
  "webhook_job_id": "68b0f2a1c3d4e5f6a7b8c9d0",
  "webhook_url": "https://your-server.example.com/webhook/commerce",
  "webhook_data": { "webhook_type": "order.done", "...": "..." }
}json
필드 타입 설명
webhook_job_id String 선택
webhook_url String 선택
webhook_data Object 선택
테스트 웹훅은 재시도 1회입니다

테스트 발송은 실제 결제 없이 준비된 샘플 주문으로 비동기 전송하며, 재시도는 1회로 제한됩니다. 수신 서버가 응답하지 않아도 테스트 API 자체는 성공 응답을 돌려줍니다. 수신 측에서는 idempotency_key 로 중복을 거릅니다. 웹훅 테스트 API

환경마다 고정된 테스트 주문을 사용합니다

본문은 환경별로 미리 정해 둔 테스트 주문에서 만듭니다. 그 주문이 없으면 TEST_WEBHOOK_ORDER_NOT_FOUND 가 돌아옵니다.

에러 코드

공통 에러

인증·권한 관련 에러는 v1 인증 오류를 참고합니다.

코드 메시지 대처 방법
MALL_INACTIVE 몰이 비활성 상태입니다 관리자에서 몰을 활성화합니다
WEBHOOK_URL_BLANK 웹훅 URL 이 비어 있습니다 webhook_url 을 넘기거나 프로젝트에 웹훅을 등록합니다
TEST_WEBHOOK_ORDER_NOT_FOUND 테스트용 주문을 찾을 수 없습니다 부트페이에 문의합니다

함께 보기