링크페이 상세

링크 한 건의 고객·금액·상품 구성·결제 상태를 한 번에 돌려줘요.

특정 링크페이 ID를 기반으로 해당 링크페이의 상세 정보를 조회해요. 고객 정보, 결제 금액, 상품 구성, 결제 상태 등 모든 정보를 확인할 수 있어요.

API 엔드포인트

GEThttps://api.bootapi.com/v1/invoices/:invoice_idBasic Auth

요청 파라미터

파라미터	타입	필수	설명
`invoice_id`	String	필수	링크페이 ID (URL 파라미터)

코드 예제

const { BootpayCommerce } = require('@bootpay/backend-js');

const commerce = new BootpayCommerce({
    client_key: '{client_key}',
    secret_key: '{secret_key}'
});

const response = await commerce.invoice.detail('687a1b2c3d4e5f6789012345');
console.log(response);javascript

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
response = commerce.invoice_detail('687a1b2c3d4e5f6789012345')
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
$response = $commerce->invoice->detail('687a1b2c3d4e5f6789012345');
print_r($response);php

import kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;

TokenPayload tokenPayload = new TokenPayload("{client_key}", "{secret_key}");
BootpayStore commerce = new BootpayStore(tokenPayload).withToken();
var response = commerce.invoice.detail("687a1b2c3d4e5f6789012345");
System.out.println(response.getData());java

require 'bootpay'

commerce = BootpayStore::RestClient.new(client_key: '{client_key}', secret_key: '{secret_key}')
response = commerce.invoice_detail(
  invoice_id: '687a1b2c3d4e5f6789012345'
)
puts responseruby

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
response, err := commerce.Invoice.Detail("687a1b2c3d4e5f6789012345")
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
var response = await commerce.Invoice.Detail("687a1b2c3d4e5f6789012345");
Console.WriteLine(response);csharp

응답

성공 응답

주요 필드만 추린 예시예요. 이 밖에 user(고객 정보)·invoice_items(담긴 상품)·order_number(결제된 경우) 가 함께 와요.

{
  "invoice_id": "687a1b2c3d4e5f6789012345",
  "name": "프리미엄 서비스 결제",
  "price": 50000,
  "status": "invoice_available",
  "user_id": "68707c59b0eacea5cd974efd",
  "invoice_url": "https://i.bootpay.co.kr/i/{client_key}/687a1b2c3d4e5f6789012345",
  "expired_at": "2025-07-18T23:59:59+09:00"
}json

링크페이 상태 (`status`)

키	값	설명
`invoice_available`	`1`	결제 가능 (링크 생성 후 결제 대기)
`invoice_order_completed`	`2`	주문 완료 (고객이 결제를 완료)
`invoice_order_cancelled`	`3`	주문 취소
`invoice_deleted`	`-1`	판매자가 삭제
`invoice_expired`	`-2`	유효기간이 지난 링크
`invoice_product_unavailable`	`-3`	판매 불가 상품이 포함됨
`invoice_abandoned`	`-10`	고객이 결제하지 않고 이탈

에러 코드

인증·권한 관련 에러는 에러 코드표를 참고해요.

코드	메시지	대처 방법
`INVOICE_NOT_FOUND`	링크페이 정보가 없어요	invoice_id를 확인해요
`INVOICE_DENIED`	링크페이 정보에 조회권한이 없는 회원세션이에요	올바른 API 키를 사용하고 있는지 확인해요