pay_ ID는 수금 시 결제 ID이기도 합니다.
Invoices API를 사용하여 초안을 생성하고 편집한 다음, 발행하거나 발송할 수 있습니다. 미결 인보이스를 저장된 결제 수단으로 청구하거나, 구매자가 지불하지 않을 인보이스를 무효화할 수 있습니다.
초안 생성은 접근 권한을 생성하거나 구매자에게 청구하지 않습니다. 수신자의 연락처 정보는 계정의 회원 정보에 있습니다. 금융 필드와 호출자 메타데이터는 초안 상태에서만 편집할 수 있습니다.
엔드포인트
속성
속성
속성
속성
속성
구매자가 결제할 수 있도록 이 인보이스를 체크아웃 세션에서 여는 서명된 링크입니다.
POST /checkout_sessions에 link로 전달하세요. 인보이스가 미결 상태인 동안 포함됩니다. 그 외 상태, 기업 구매자에게 청구된 인보이스, 멤버십이 취소된 인보이스에서는 null입니다. 또한 payment:charge 권한이 없거나, payment_method_id가 없는 인보이스에 대해 invoice:create 또는 invoice:update 권한이 없으면 null입니다.DELETE /invoices/\{id}로 이 인보이스를 삭제할 수 있으면 true입니다. 초안은 예약되었거나 구독을 청구하는 경우가 아니면 해당됩니다. 무효화된 인보이스는 금액을 수금했거나 아직 은행 송금을 기다리는 경우가 아니면 해당됩니다.속성
속성
인보이스, 이메일, PDF에서 항목 아래에 표시되는 텍스트이며, 변형의
description에서 읽습니다. 사용자 지정 청구는 항목의 description으로 설정합니다. 상품 변형은 자체 값을 유지합니다. 변형에 설명이 없거나 이후 삭제된 경우 Null입니다.이 항목에 적용된 프로모션 할인이며, 결제의
currency 기준입니다. 기록된 할인이 없으면 Null입니다.속성
속성
unit_amount 중 반복 변형의 일회성 선불 수수료(변형의 initial_price)에 해당하는 부분으로, 이 인보이스에서만 청구됩니다. unit_amount의 나머지는 첫 번째 청구 기간입니다. 체험판에는 첫 기간 청구가 없습니다. 일회성 항목, 갱신 인보이스, 선불 수수료가 없는 항목, 인보이스 가격 책정 후 변형 가격이 변경된 항목에서는 Null입니다.속성
속성
할인 및 세금 적용 전
unit_amount × quantity 값이며, 결제의 currency 기준입니다.속성
속성
이 항목에서 징수된 세금이며, 결제의
currency 기준입니다. 기록된 세금이 없으면 Null입니다.속성
속성
이 반복 항목의 첫 갱신 청구 전 무료 체험 일수이며, 변형의
trial_period_days에서 가져옵니다. 이후 인보이스는 해당 항목에 대해 변형의 initial_price만 청구합니다. 일회성 항목과 갱신 인보이스, 그리고 고객이 이미 해당 변형을 구독 중인 경우 null입니다.할인 전 1단위의 저장된 가격이며, 결제의
currency 기준입니다. 반복 항목을 생성하거나 교체할 때는 선불 수수료와, 항목이 체험판으로 시작하지 않는 한 첫 번째 청구 기간이 포함됩니다. 갱신 인보이스는 선불 수수료를 제외합니다. 그 외 편집은 저장된 가격을 유지합니다. 결제에 기록된 가격이 없으면 Null입니다.속성
속성
이 인보이스가 청구하는 멤버십이며,
mem_ 접두사로 시작합니다. 갱신 인보이스의 경우 갱신되는 구독입니다. 반복 항목이 있는 인보이스의 경우 인보이스 발행 시 생성되는 멤버십입니다. 일회성 인보이스, 아직 발행되지 않은 초안, member:basic:read 권한이 없는 경우 Null입니다.인보이스에 저장된 결제 수단이 청구될 시각이며, ISO 8601 타임스탬프입니다. 인보이스를 발송하거나 발행할 때 지정한
charge_at입니다. 지정하지 않은 경우, payment_method_id가 있는 인보이스를 만기 전에 발송하거나 발행하면 due_at입니다. 초안에서는 예약된 발송의 charge_at입니다. 그 외의 경우, 청구가 시작된 후, 그리고 인보이스가 결제, 무효화 또는 회수 불가 처리된 후에는 null입니다.초안의 예약된 발송이 실행될 때 적용되는
collection_method입니다. 초안에 예약된 발송이 없거나 이 값 없이 예약된 경우, 그리고 인보이스가 발행된 후에는 null입니다.사용 가능한 옵션: charge_automatically, send_invoicedue_at이 도래하면 이 초안이 자동으로 발행되는지 여부입니다. 발행 시 payment_method_id로 청구하거나 recipient_emails로 결제 링크를 이메일로 보냅니다. 초안이 아닌 인보이스와 예약된 발송이 있는 초안에서는 false입니다. 수신자가 없거나 결제 링크를 사용할 수 없어 초안 발송이 실패하는 동안에는 false입니다. 마지막 저장 시 향후 due_at이 없던 초안에서는 false입니다. 2026-11-12T22:00:00Z 이전에 생성된 초안에서는 false입니다.인보이스 반복 항목의 첫 번째 청구 기간이 시작되는 시각이며, ISO 8601 타임스탬프입니다. 갱신은 이 시점부터 계산됩니다.
null이면 인보이스가 결제될 때 기간이 시작되며, 결제 시점에 이미 지난 시각도 마찬가지입니다. 시작일이 지정된 인보이스는 변형의 무료 체험을 건너뜁니다.속성
속성
속성
속성
속성
속성
Invoice

