에러 코드
"해당 결제 내역을 찾지 못했습니다"(-2100)는 무엇을 잘못 보낸 건가요?
조회 키가 틀렸거나, 그 결제 건이 다른 프로젝트에 있을 때 납니다. 가장 흔한 실수는 주문할 때 만든 order_id 로 검증을 요청하는 것입니다. 검증·취소는 부트페이가 발급한 receipt_id 로만 됩니다.
이 코드로 들어온 상담 16건을 읽고 정리했습니다.
먼저 볼 것
- order_id 가 아니라 receipt_id 를 보내고 있는지 확인합니다.
- 호출에 쓴 API 키·application_id 가 그 receipt_id 를 만든 프로젝트의 것인지 확인합니다.
- receipt_id 변수가 undefined 인 채로 URL에 붙어 엉뚱한 주소로 나가고 있지 않은지 봅니다.
- Java SDK에서 Map을 직접 쓸 때는 receiptId 가 아니라 receipt_id 로 보내야 합니다.
테스트 결제라면 이미 취소됐을 수 있습니다
KG이니시스 등 일부 PG의 테스트 결제는 결제 직후 자동으로 취소 처리됩니다. 그러면 조회 시점에는 내역이 없어 이 에러가 납니다. 운영 모드에서 같은 코드로 재현되는지 확인해 보세요.
상태값도 같이 정리해 둡니다
| status | 뜻 |
|---|---|
| 1 | 결제 완료 |
| 20 | 취소 |
기준입니다. 같은 코드라도 PG 와 계약 상태에 따라 응답 문구가 달라질 수 있습니다. 응답 본문 전체를 함께 확인하세요.