결제 내역 조회

승인된 결제나 매입된 결제 내역을 조회합니다. 파라미터를 이용해 특정 트랜잭션 ID 또는 주문 번호를 가진 결제 내역을 조회할 수 있으며, 트랜잭션 정보 또는 주문 정보만 조회할 수도 있습니다.

GET /v3/payments

Read 타임아웃은 최소 20초 이상으로 설정하세요.

Request

Response

Path

None

Query

Name	Description	Required
`orderId[]`	주문 번호. 두 개 이상의 주문 번호를 쿼리 파라미터로 입력할 수 있으며, 트랙잭선 ID(`transactionId`) 또는 본 파라미터가 반드시 입력돼야 합니다.
`transactionId[]`	하나 이상의 결제 트랜잭션 ID. 자세한 설명은 트랜잭션 ID를 참고하세요.

Body

None

Headers

Content-Type
X-LINE-Authorization
X-LINE-Authorization-Nonce
X-LINE-ChannelId
X-LINE-MerchantDeviceProfileId

자세한 내용은 요청 헤더를 참고하세요.

Request examples

bash

curl -X GET \
     -H "Content-Type: application/json" \
     -H "X-LINE-ChannelId: YOUR_CHANNEL_ID" \
     -H "X-LINE-Authorization-Nonce: GENERATED_NONCE" \
     -H "X-LINE-Authorization: PROCESSED_SIGNATURE" \
     -H "X-LINE-MerchantDeviceProfileId: YOUR_DEVICE_PROFILE_ID" \
     https://sandbox-api-pay.line.me/v3/payments?transactionId=20140101123123123&orderId=1002045572

Name	Type	Description
`info[]`	Object array	결과 정보
`returnCode`	String	결과 코드. API 호출 성공 시 `0000` 값이 반환됩니다. 그 외 결과 코드는 오류 코드이며, 자세한 내용은 결과 코드를 참고하세요.
`returnMessage`	String	결과 메시지. 결과 메시지는 결과 코드를 참고하세요.