---
title: "결제 단건조회(고유 고객사 주문번호 조회) API"
method: GET
path: "/payments/find/{merchant_uid}/{payment_status}"
tags: ["payments"]
---

# 결제 단건조회(고유 고객사 주문번호 조회) API

`GET /payments/find/{merchant_uid}/{payment_status}`

고객사지정 고유번호로 결제내역을 확인합니다 <br>
     동일한 merchant_uid가 여러 건 존재하는 경우, 정렬 기준에 따라 가장 첫 번째 해당되는 건을 반환합니다.
     (모든 내역에 대한 조회가 필요하시면 GET 결제 복수조회(고객사 주문번호 중복 포함) API를 사용해주세요.)<br><br>
     payment_status를 추가로 지정하시면, 해당 status에 해당하는 가장 최신 데이터를 반환합니다.

## Path parameters

- `merchant_uid` string, required
- `payment_status` string, required

## Query parameters

- `sorting` '-started' | 'started' | '-paid' | 'paid' | '-updated' | 'updated'

## Response `200`

정상 조회

- PaymentResponse — unresolved $ref

## Other responses

- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404` — 거래건이 존재하지 않는 경우

---

[API](https://skmtc.net/iamport/apis/rest-api.md) · [All operations](https://skmtc.net/iamport/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iamport/rest-api/revisions/006dfffdec43/schema)