에러 코드
RC_CONFIRM_FAILED 로 결제 승인이 실패합니다. 어디부터 봐야 하나요?
RC_CONFIRM_FAILED 는 부트페이가 PG에 승인을 넘겼는데 PG가 승인을 돌려주지 않았다는 뜻입니다. 부트페이 코드나 파라미터 문제가 아니라 PG쪽 가맹점 설정이 원인인 경우가 가장 많습니다. 응답에 같이 오는 PG 에러 메시지를 먼저 읽고, 그 문구가 가리키는 곳(PG 관리자 또는 PG 고객센터)으로 가야 합니다.
이 코드로 들어온 상담 34건을 읽고 정리했습니다.
이 에러는 부트페이가 아니라 PG를 가리킵니다
승인 단계까지 왔다는 것은 결제창이 뜨고 사용자가 결제를 마쳤다는 뜻입니다. 그 다음 부트페이가 PG에 승인을 요청했는데 PG가 실패를 돌려준 상태가 RC_CONFIRM_FAILED 입니다. 그래서 연동 코드를 아무리 들여다봐도 원인이 안 나옵니다.
응답 본문에는 PG가 준 에러 코드와 메시지가 같이 실립니다. 그 문구가 실제 원인이고, RC_CONFIRM_FAILED 는 "PG가 거절했다"는 껍데기입니다.
실제 상담에서 확인된 원인
| 같이 온 메시지 | 실제 원인 | 어디로 |
|---|---|---|
| 미등록PG업체 (나이스페이) | PG쪽 MID가 사용 가능 상태가 아님 | PG 고객센터. 부트페이를 통해 재가맹이 필요할 수 있습니다 |
| 승인 데이터 미수신 (키움페이) | PG 관리자에 결제수단별 연동키가 안 만들어져 있거나 통지 URL 경로에 오타 | PG 관리자에서 연동키 생성 + 웹훅 URL 확인 |
| 가맹점 미설정 계열 | 결제수단은 계약했는데 그 MID에 해당 수단이 안 열림 | PG 관리자 또는 PG 담당자 |
응답에서 PG 코드부터 꺼냅니다
- 응답 JSON에서 PG 에러 코드와 메시지를 먼저 꺼냅니다. 여기에 답이 있습니다.
- 같은 결제수단이 테스트(샌드박스)에서는 되는데 실결제에서만 실패하면 PG 가맹 설정 문제입니다.
- PG 관리자에서 그 MID에 해당 결제수단이 사용 가능으로 열려 있는지 봅니다.
- 웹훅까지 안 온다면 PG 관리자의 통지 URL이 부트페이 주소로 정확히 등록됐는지 확인합니다.
기준입니다. 같은 코드라도 PG 와 계약 상태에 따라 응답 문구가 달라질 수 있습니다. 응답 본문 전체를 함께 확인하세요.