결제 거래 내역
결제 거래 내역 페이지는 관리자가 결제 기록을 검색하고, 상태를 확인하고, 주문별 거래 내역과 상세 결제 정보를 검토할 수 있는 화면입니다.
이 페이지는 결제 성공 여부 확인, 실패한 거래 확인, 주문별 결제 기록 검토, 결제 제공업체 응답 정보 확인이 필요할 때 사용합니다.
화면 개요
결제 거래 내역 기능은 크게 거래 목록 화면과 거래 상세 화면으로 구성됩니다.
| 화면 | 설명 |
|---|---|
| 거래 목록 | 검색 조건, 주문별 그룹 합계, 거래 목록, 상세 보기 버튼을 제공합니다. |
| 거래 상세 | 선택한 거래의 기본 정보, 실패 정보, 처리 타임라인을 보여줍니다. |
거래 목록
거래 목록 화면에서는 선택한 검색 조건에 해당하는 결제 거래 기록을 확인할 수 있습니다. 화면 상단에는 검색된 행 수와 전체 거래 금액이 표시됩니다.
요약 영역
| 항목 | 설명 |
|---|---|
| Rows | 현재 검색 조건으로 조회된 거래 기록 수입니다. |
| Total | 현재 검색된 거래들의 전체 금액입니다. |
| Reset | 검색 조건을 초기화하고 기본 거래 목록을 다시 불러옵니다. |
검색 조건
검색 영역에서는 결제 설정, 상태, 주문 번호, 날짜 범위, 조회 개수를 기준으로 거래를 검색할 수 있습니다.
| 검색 항목 | 설명 |
|---|---|
| ConfigId | 결제 설정 ID로 거래를 검색합니다. 예: 12. |
| Status | 승인, 실패, 캡처, 토큰 생성 등 결제 상태로 검색합니다. |
| OrderId | 특정 주문 번호와 연결된 거래를 검색합니다. |
| From | 거래 검색 시작일입니다. |
| To | 거래 검색 종료일입니다. |
| Take | 조회할 거래 기록 수를 제한합니다. |
| Search | 입력한 조건으로 거래를 검색합니다. |
거래 테이블
거래 테이블은 결제 기록을 보여주며, 주문 번호 기준으로 거래를 그룹화합니다. 각 그룹에는 주문 번호, 거래 개수, 그룹 총액이 표시됩니다.
| 컬럼 | 설명 |
|---|---|
| ID | 내부 거래 ID입니다. |
| TransactionId | 결제 처리 과정에서 저장되거나 결제 제공업체가 반환한 거래 ID입니다. 값이 없으면 대시로 표시될 수 있습니다. |
| Amount | 거래 금액입니다. |
| Status | 현재 거래 상태입니다. |
| Risk | 결제 제공업체가 제공한 위험 점수 또는 위험 정보입니다. |
| Created | 거래 기록이 생성된 날짜와 시간입니다. |
| Action | View 버튼을 통해 거래 상세 화면으로 이동합니다. |
주문별 그룹 정보
거래는 OrderId 기준으로 그룹화됩니다. 각 그룹에는 다음 정보가 표시됩니다.
- OrderId: 거래와 연결된 주문 번호입니다.
- Count: 해당 주문에 연결된 거래 기록 수입니다.
- Group Total: 해당 주문 그룹의 총 거래 금액입니다.
하나의 주문에는 여러 개의 결제 거래 기록이 있을 수 있습니다. 예를 들어 토큰 생성 기록, 캡처 기록, 실패 기록, 결제 제공업체 응답 기록이 함께 남을 수 있습니다.
자주 보는 거래 상태
| 상태 | 의미 |
|---|---|
| CAPTURED | 결제가 정상적으로 캡처되었습니다. |
| HOSTED_TOKEN_CREATED | 호스티드 결제 토큰이 생성되었습니다. 일반적으로 결제 폼 또는 토큰 처리 과정이 진행되었음을 의미합니다. |
| ORDER_NOT_FOUND | 거래와 연결된 주문을 시스템에서 찾지 못했습니다. |
| APPROVED | 결제 제공업체에서 거래를 승인했습니다. |
| FAILED | 거래가 실패했거나 거절되었습니다. |
| REFUNDED | 거래가 환불되었습니다. |
거래 상세
거래 목록에서 View 버튼을 클릭하면 거래 상세 화면으로 이동합니다. 상세 화면에서는 하나의 결제 거래에 대한 전체 정보를 확인할 수 있습니다.
상단 요약 정보
화면 상단에는 거래의 핵심 값이 작은 라벨 형태로 표시됩니다.
- TXID: 내부 거래 ID입니다.
- ConfigId: 결제 설정 ID입니다.
- OrderId: 연결된 주문 번호입니다.
- Amount: 거래 금액입니다.
- Status: 현재 거래 상태입니다.
- Risk: 위험 정보가 있을 경우 표시됩니다.
Core 정보
Core 영역은 거래의 기본 정보를 보여주는 핵심 영역입니다. 결제 기록을 점검할 때 가장 먼저 확인해야 하는 정보입니다.
| 항목 | 설명 |
|---|---|
| TXID | 내부 거래 ID입니다. |
| ConfigId | 이 거래에 사용된 결제 설정입니다. |
| OrderId | 이 거래와 연결된 주문 번호입니다. |
| CustomerId | 고객 정보와 연결된 경우 고객 ID가 표시됩니다. |
| Amount | 결제 금액입니다. |
| Status | 현재 결제 상태입니다. |
| ProviderTxId | 결제 제공업체가 반환한 거래 ID입니다. |
| ProviderChargeId | 결제 제공업체의 Charge ID가 있는 경우 표시됩니다. |
| RiskScore | 결제 제공업체가 위험 점수를 제공하는 경우 표시됩니다. |
| Failure | 거래 실패 여부를 표시합니다. |
타임라인
타임라인 영역은 거래 처리 과정에서 중요한 시간 정보를 보여줍니다.
| 타임라인 항목 | 설명 |
|---|---|
| Created | 거래 기록이 생성된 날짜와 시간입니다. |
| Authorized | 거래가 승인 처리된 날짜와 시간입니다. 값이 없을 수도 있습니다. |
| Captured | 결제가 캡처된 날짜와 시간입니다. |
| Refunded | 환불된 거래인 경우 환불 날짜와 시간이 표시됩니다. |
| Updated | 거래 기록이 마지막으로 수정된 날짜와 시간입니다. |
실패 상세 정보
거래가 실패했거나 오류 상태인 경우 Failure Detail 영역에 실패 코드와 실패 메시지가 표시됩니다.
| 항목 | 설명 |
|---|---|
| FailureCode | 시스템 또는 결제 제공업체가 반환한 실패 코드입니다. |
| FailureMessage | 거래가 실패한 이유를 설명하는 메시지입니다. |
권장 작업 순서
- Admin > Payment > Transactions 메뉴로 이동합니다.
- From과 To로 날짜 범위를 설정합니다.
- 필요하면 OrderId, ConfigId, Status를 입력합니다.
- Search 버튼을 클릭합니다.
- 주문별로 그룹화된 거래 기록을 확인합니다.
- 특정 거래를 자세히 보려면 View 버튼을 클릭합니다.
- Core 정보, 타임라인, 실패 상세 정보를 확인합니다.
- Back to list 또는 Back 버튼으로 목록으로 돌아갑니다.
자주 사용하는 작업
| 상황 | 권장 작업 |
|---|---|
| 주문 결제 여부 확인 | OrderId로 검색한 뒤 거래 상태를 확인합니다. |
| 실패한 결제 확인 | 실패 상태로 검색하거나 실패 메시지가 있는 거래를 상세 확인합니다. |
| 캡처된 결제 확인 | CAPTURED 상태의 거래를 검색하고 금액과 캡처 시간을 확인합니다. |
| 주문 누락 문제 조사 | ORDER_NOT_FOUND 상태의 거래를 열어 실패 메시지를 확인합니다. |
| 결제 제공업체 정보 확인 | ProviderTxId, ProviderChargeId, 상태, 타임라인 값을 확인합니다. |
문제 해결
| 문제 | 가능한 원인 | 해결 방법 |
|---|---|---|
| 거래가 표시되지 않음 | 날짜 범위에 기록이 없거나 검색 조건이 너무 제한적일 수 있습니다. | 검색 조건을 초기화하거나 날짜 범위를 넓혀서 다시 검색합니다. |
| 주문을 찾을 수 없음 | 거래가 존재하지 않는 주문 번호를 참조하고 있을 수 있습니다. | OrderId를 확인하고 실제 주문이 존재하는지 확인합니다. |
| 금액이 $0.00으로 표시됨 | 토큰 생성, 실패, 테스트, 비결제성 거래일 수 있습니다. | 상세 화면에서 상태와 결제 제공업체 정보를 확인합니다. |
| Provider Transaction ID가 없음 | 결제 제공업체가 거래 ID를 반환하지 않았거나, 제공업체 확인 전에 실패했을 수 있습니다. | 상태, 실패 메시지, 결제 제공업체 로그를 함께 확인합니다. |
| 타임라인 값이 비어 있음 | 거래가 해당 처리 단계까지 진행되지 않았을 수 있습니다. | 거래 상태와 제공업체 응답 정보를 확인합니다. |
관리 권장 사항
- 거래 기록이 많을 경우 먼저 날짜 범위를 설정한 후 검색하세요.
- 특정 고객 결제 문제를 조사할 때는 OrderId로 검색하는 것이 가장 빠릅니다.
- 주문별 그룹 합계를 확인하여 하나의 주문에 연결된 모든 결제 활동을 파악하세요.
- 상태가 실패, 누락, 불명확한 경우 반드시 상세 화면을 확인하세요.
- 목록 화면만 보지 말고 상세 화면에서 제공업체 ID, 상태, 타임라인을 함께 확인하세요.
- 중요한 결제 문제를 조사할 때는 결제 제공업체 로그도 함께 확인하는 것이 좋습니다.
결제 거래 기록은 중요한 금융 기록입니다. 관련 주문, 환불, 고객 청구 정보, 결제 제공업체 설정을 변경하기 전에 거래 내역을 신중하게 확인하세요.