결제 내역
결제 건별 승인·취소 기록과 시도 이력
PG에 실제로 오간 결제를 건별로 봅니다. 주문이 없는 결제(거절·결제창 닫음), 한 결제의 여러 시도, 부분 취소 금액, PG 거래번호가 주문 화면과 다른 점입니다.
결제 상태
| 상태 | 뜻 |
|---|---|
| 승인 | 승인됐고 환불 없음 |
| 부분취소 | 승인 금액 일부 환불 |
| 취소 | 승인 금액 전부 환불 |
| 승인 결과 확인 중 | 결제사에 승인 여부를 다시 묻는 중. 확정되면 승인이나 실패로 바뀜 |
| 실패 | 승인되지 않고 끝남(거절·결제창 준비 실패·구매자 취소·시간 만료) |
상점 플랫폼 화면
상점 플랫폼에서 상점 관리 › 분석 › 결제 내역으로 이동합니다(소유자만).
| 필터 | 내용 |
|---|---|
| 시작일·종료일 | 결제 시작 시각 기준. 기본 최근 30일, 최대 92일 |
| 상태·결제사·결제수단 | 목록 거르기 |
| 결제 구분 | 실결제 또는 테스트 결제 포함 |
| 검색어 | 주문번호·거래번호·결제 id·시도 id는 정확히 일치, 구매자명은 일부 일치 |
합계 카드는 지금 페이지 기준입니다. 기간 전체 합계는 매출 리포트에서 봅니다.
행을 누르면 상세가 열립니다.
- 시도 이력: 결제창을 연 순서대로, 실패한 시도도 남습니다.
- 환불 기록: 실패한 환불 요청도 남습니다.
- 결제사 정보: 환경(샌드박스·라이브)과 가맹점. 비밀 값은 나오지 않습니다.
환불은 결제할 때 쓴 결제사와 연결 정보로 나가므로, 연결을 바꿔도 이미 받은 결제의 환불은 그대로입니다.
현금영수증
구매자가 계좌이체·가상계좌 결제에서 신청하면 승인 뒤 그 결제사로 발급합니다. 환불하면 환불 금액만큼, 전액 환불이면 전부 취소합니다.
| 상태 | 뜻 |
|---|---|
| 신청 | 결제 승인 전 |
| 발급 대기 | 발급·취소 대기. 결제사 응답이 늦으면 자동 재시도 |
| 발급 완료 | 발급됨. 부분 환불이 있으면 남은 금액으로 발급 |
| 발급 취소 | 전액 환불로 취소 |
| 발급 실패 | 결제사가 거절했거나 재시도도 실패 |
| 발급 대상 아님 | 최종 결제수단이 계좌이체·가상계좌가 아님 |
상점 플랫폼에서 상점 관리 › 판매 › 주문으로 이동합니다(재발급은 소유자·관리자).
- 목록에서 주문을 선택합니다.
- 현금영수증 카드에서 상태·승인번호·가린 식별 번호를 봅니다.
- 발급 실패·발급 대기면 **[재발급]**을 누릅니다. 식별 번호가 틀려 거절됐다면 다시 거절될 수 있습니다.
API는 주문의 payment.cashReceipt·결제 상세의 cashReceipt이고, 재발급은 POST /v1/orders/{orderId}/cash-receipt/reissue(상점 플랫폼 전용)입니다.
API
const page = await api.payments.list({ status: "PARTIALLY_REFUNDED" });
const detail = await api.payments.get(page.contents[0].paymentId);HTTP는 GET /v1/payments와 GET /v1/payments/{paymentId}입니다.
- 스코프는
settlement:r입니다. 기간 생략 시 최근 30일, 92일 초과는RANGE_TOO_WIDE, 테스트 결제는includeTest=true로 포함합니다. - 목록의
provider·method·pgTransactionId는 승인한 시도의 값이고, 승인이 없으면 마지막 시도의 값입니다. method는 실제 결제수단이고, PG가 알려 주지 않으면 요청한 수단입니다.- 상세는
attempts(시도)와refunds(환불)를 함께 줍니다. 필드는 관리 API 레퍼런스를 참고하십시오.