결제 내역
결제 건별 승인·취소 기록과 시도 이력
셀러 콘솔 분석 › 결제 내역에서 PG에 실제로 오간 결제를 건별로 확인해요. 이 화면은 스토어 소유자(OWNER)만 볼 수 있어요.
주문 내역과 다른 점
주문 화면은 무엇을 팔았고 배송이 어디까지 갔는지를 봐요. 결제 내역은 돈이 어떻게 오갔는지를 봐요. 그래서 이런 차이가 있어요.
- 주문이 없는 결제도 나와요. 카드가 거절됐거나, 구매자가 결제창을 닫았거나, 승인 결과를 아직 확인하는 중인 결제예요.
- 한 주문에 결제 기록이 여럿일 수 있어요. 첫 결제사에서 거절돼 다른 결제사로 다시 결제하면 시도가 쌓여요. 목록에는 결제 건 하나로 보이고, 상세에서 시도를 모두 볼 수 있어요.
- 부분 취소가 금액으로 보여요. 주문 상태만으로는 얼마가 돌아갔는지 알 수 없어요.
- 거래번호로 찾을 수 있어요. 결제사 대시보드나 고객 문의가 이 번호로 들어와요.
결제 상태
| 상태 | 뜻 |
|---|---|
| 승인 | 결제가 승인됐고 환불이 없어요 |
| 부분취소 | 승인한 금액의 일부를 환불했어요 |
| 취소 | 승인한 금액을 모두 환불했어요 |
| 승인 결과 확인 중 | 결제사에 승인 여부를 다시 묻는 중이에요. 확정되면 승인이나 실패로 바뀌어요 |
| 실패 | 승인되지 않고 끝났어요. 거절·결제창 준비 실패·구매자 취소·시간 만료가 여기 들어가요 |
콘솔 화면
시작일과 종료일로 기간을 정해요. 기준은 결제를 시작한 시각이고, 기본은 최근 30일, 한 번에 92일까지 볼 수 있어요. 상태·결제사·결제수단으로 거르고, 결제 구분에서 테스트 결제를 포함할지 골라요. 검색은 주문번호·거래번호· 결제 id는 정확히 일치할 때, 구매자명은 일부만 적어도 찾아요.
합계 카드는 지금 보고 있는 페이지 기준이에요. 기간 전체 합계는 매출 리포트에서 봐요.
행을 누르면 상세로 들어가요. 상세에는 금액 내역, 시도 이력, 환불 기록, 주문 정보, 결제사 정보가 있어요.
- 시도 이력은 결제창을 연 순서대로 남아요. 실패한 시도도 남아서 구매자가 어디서 막혔는지 볼 수 있어요.
- 환불 기록은 실패한 환불 요청도 남겨요. 같은 금액이 두 번 나가지 않았는지 직접 확인할 수 있어야 하기 때문이에요.
- 결제사 정보에는 환경(샌드박스·라이브)과 가맹점 식별자가 있어요. 비밀 값은 어디에도 나오지 않아요.
환불은 결제할 때 쓴 결제사와 연결 정보로 나가요. 결제사 연결을 바꿔도 이미 받은 결제의 환불은 그대로예요.
API
curl "https://api.sayren.app/v1/payments?from=2026-09-01T00:00:00%2B09:00&status=PARTIALLY_REFUNDED" \
-H "Authorization: Bearer $STORE_TOKEN"Store SDK로는 이렇게 불러요.
const page = await store.payments.list({ status: "PARTIALLY_REFUNDED" });
const detail = await store.payments.get(page.contents[0].paymentId);- 스코프는 매출 리포트와 같은
settlement:r이에요. - 기간을 생략하면 최근 30일이에요. 92일을 넘기면
RANGE_TOO_WIDE예요. - 테스트 결제는 기본으로 빠져요.
includeTest=true면 포함해요. - 목록 응답의
provider·method·pgTransactionId는 승인한 시도의 값이에요. 승인이 없으면 마지막 시도의 값이에요. method는 실제 결제수단이에요. PG가 알려 주지 않으면 주문서에서 요청한 수단으로 대신해요.- 상세는
attempts(시도)와refunds(환불)를 함께 줘요. 자세한 필드는 Store API 레퍼런스에서 봐요.