API 변경 이력

이 페이지는 LINE Pay API 최근 변경 이력부터 순서대로 제공합니다.

2025년 11월

대만에서 결제 거래에 대한 대금 수급 및 지급, 자금 수령 그리고 국내 또는 해외 소액 송금과 같은 사업을 수행하도록 관할 당국의 허가를 받은 운영자를 전자 지급 기관(EPI, Electronic Payment Institutions)라고 부릅니다. 이러한 기관은 모두 전자지급결제기관관리법(Act Governing Electronic Payment Institutions)의 법적 제도적 규제를 받습니다. 이에 따라, 기존 온라인 API v3와 오프라인 API v2 외 아래 API를 추가합니다.

• 온라인 API v4
• 오프라인 API v4
• 오프라인 API v2.4

오프라인 API v2에서 EPI 관련된 변경 사항만 적용하고 싶다면 오프라인 API v2.4를 사용하세요. 오프라인 API v2에서 오프라인 API v4을 사용하려면 인증 방식도 변경해야 합니다. 자세한 설명은 사전 준비하기를 참고하세요.

거래가 완료될 때, 아래와 같이 두 종류로 구분하여, 어떤 유형의 회사가 결제 및 정산을 처리할지 가맹점이 알 수 있도록 API를 업데이트했습니다.

• "TSP": 써드 파티 서비스 제공자(Third-party Service Provider), 기존 결제 방식 제공자.
• "EPI": 전자 지급 결제 기관(Electronic Payment Institutions)

거래될 때 결제 방식 제공자가 어떤 유형인지 알 필요 없다면, 기존 API를 그대로 사용하면 됩니다.

새로운 버전의 API를 샌드박스 환경에서 테스트할 수 있습니다.

EPI 유형 거래를 테스트하려면 아래 URL에서 내 코드(My code) 생성기를 사용하세요. 단, EPI 유형 거래는 온라인 결제 시나리오에서는 유효하지 않으므로, API 응답의 paymentProvider 필드는 온라인 API의 경우 항상 "TSP"를 나타냅니다.

• EPI 신용카드 거래
  • https://sandbox-web-pay.line.me/web/sandbox/payment/oneTimeKey?countryCode=TW&paymentMethod=card&preset=18
• EPI 잔액 거래
  • https://sandbox-web-pay.line.me/web/sandbox/payment/oneTimeKey?countryCode=TW&paymentMethod=balance&preset=3

여기서부터 각 API별 변경 사항을 요약하여 제공합니다.

• 온라인 API v4 변경 사항
• 오프라인 API v4 변경 사항
• 오프라인 API v2.4 변경 사항

온라인 API v4 변경 사항

• EPI 정보 제공을 위해 다음 API 응답에 info.paymentProvider 필드가 추가됨.
  • 결제 승인(POST /v4/payments/{transactionId}/confirm)
  • 매입(POST /v4/payments/authorizations/{transactionId}/capture)
  • 결제 내역 조회(GET /v4/payments)
  • 자동 결제 요청(POST /v4/payments/preapprovedPay/{regKey}/payment)
• 결제 요청 (POST /v4/payments/request) API의 요청 파라미터에 자동 결제 설정 관련 options.regPayRequest 필드를 추가함

오프라인 API v4 변경 사항

• 새로운 인증 방식(HMAC)을 HTTP 요청 헤더에 적용 (온라인 API v3, v4와 동일)
• 서버 허용 목록(IP allowlist) 설정을 제거
• 결제 요청(POST /v4/payments/oneTimeKeys/pay) API의 요청 파라미터가 변경됨.
• EPI 정보 제공을 위해 다음 API 응답에 info.paymentProvider 필드가 추가됨.
  • 결제 요청(POST /v4/payments/oneTimeKeys/pay)
  • 결제 상태 조회(GET /v4/payments/orders/{orderId}/check)
  • 승인 정보 조회(GET /v4/payments/authorizations)
  • 매입(POST /v4/payments/orders/{orderId}/capture)
  • 결제 내역 조회(GET /v4/payments)

오프라인 API v2.4 변경 사항

• EPI 정보 제공을 위해 다음 API 응답에 info.paymentProvider 필드가 추가됨.
  • 결제 요청(POST /v2.4/payments/oneTimeKeys/pay)
  • 결제 상태 조회(GET /v2.4/payments/orders/{orderId}/check)
  • 승인 정보 조회(GET /v2.4/payments/authorizations)
  • 매입(POST /v2.4/payments/orders/{orderId}/capture)
  • 결제 내역 조회(GET /v2.4/payments)

2025년 5월

LINE Pay 일본 서비스를 종료함에 따라 다음 콘텐츠가 제거되었습니다.

• 일본 전용 API였던 Deposit API를 더 이상 제공하지 않습니다.
• 온라인 API와 오프라인 API에서 일부 일본 전용 필드 관련 설명을 더 이상 제공하지 않습니다.