상점·프로젝트 정보 | Bootpay 커머스 매뉴얼

연동이 어느 프로젝트에 붙었는지, 웹훅이 실제로 도착하는지 먼저 확인해요.

프로젝트 정보

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

운영 키로 개발 프로젝트를 부르고 있거나 결제용 키를 커머스에 넣은 경우, 다른 API 를 붙이기 전에 이 한 번의 호출로 드러나요.

상점 정보

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

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

{
  "mall": { "status": 1, "...": "..." },
  "seller": { "...": "..." }
}json

몰 설정의 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회로 제한돼요. 수신 서버가 응답하지 않아도 테스트 API 자체는 성공 응답을 돌려줘요. 수신 측에서는 idempotency_key 로 중복을 걸러요. 웹훅 테스트 API

본문은 환경별로 미리 정해 둔 테스트 주문에서 만들어요. 그 주문이 없으면 TEST_WEBHOOK_ORDER_NOT_FOUND 가 돌아와요.

에러 코드

인증·권한 관련 에러는 v1 인증 오류를 참고해요.

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

함께 보기

서버 인증 — 키와 권한을 먼저 확인해요
주문 웹훅 설정 — 수신 서버를 만들어요