본문으로 건너뛰기

결제 요청 상태 조회

요청된 결제의 상태를 조회합니다. 주로 리다이렉션 URL 정보 없이 결제를 구현할 때, 이 API를 일정 주기로 호출해 고객이 LINE Pay 인증을 했는지 확인할 수 있습니다. 응답(returnCode)에 따라 LINE Pay 인증 여부 또는 성패 여부를 확인할 수 있습니다. 1초 이상의 간격으로 API를 호출할 것을 권장합니다.

GET /v3/payments/requests/{transactionId}/check

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

Path

Name
Description
Required
transactionId

결제 트랜잭션 ID. 자세한 설명은 트랜잭션 ID를 참고하세요.

Query

None

Body

None

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

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

Request examples

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/requests/2018110112345678910/check