portone_server_sdk.payment.cash_receipt#
Classes
현금 영수증 취소 성공 응답 |
|
발급 취소 |
|
현금영수증 다건 조회를 위한 입력 정보 |
|
현금영수증 다건 조회 시 정렬 조건 |
|
현금영수증 내역 |
|
현금영수증 다건 조회를 위한 입력 정보 |
|
현금영수증 다건 조회 성공 응답 정보 |
|
현금영수증 발급 요청 양식 |
|
현금영수증 발급 시 고객 관련 입력 정보 |
|
현금 영수증 발급 성공 응답 |
|
발급 실패 |
|
발급 완료 |
|
Exceptions
- exception portone_server_sdk.payment.cash_receipt.CancelCashReceiptError#
Bases:
PortOneError
- args#
- with_traceback()#
Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.
- message: str | None#
- exception portone_server_sdk.payment.cash_receipt.GetCashReceiptError#
Bases:
PortOneError
- args#
- with_traceback()#
Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.
- message: str | None#
- exception portone_server_sdk.payment.cash_receipt.GetCashReceiptsError#
Bases:
PortOneError
- args#
- with_traceback()#
Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.
- message: str | None#
- exception portone_server_sdk.payment.cash_receipt.IssueCashReceiptError#
Bases:
PortOneError
- args#
- with_traceback()#
Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.
- message: str | None#
- class portone_server_sdk.payment.cash_receipt.CancelCashReceiptResponse#
Bases:
object
현금 영수증 취소 성공 응답
- cancelled_amount: int#
취소 금액 (int64)
- cancelled_at: str#
현금 영수증 취소 완료 시점 (RFC 3339 date-time)
- class portone_server_sdk.payment.cash_receipt.CancelledCashReceipt#
Bases:
object
발급 취소
- merchant_id: str#
고객사 아이디
- store_id: str#
상점 아이디
- payment_id: str#
결제 건 아이디
- channel: SelectedChannel#
현금영수증 발급에 사용된 채널
- amount: int#
결제 금액 (int64)
- currency: Literal['KRW', 'USD', 'JPY', 'AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN', 'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BOV', 'BRL', 'BSD', 'BTN', 'BWP', 'BYN', 'BZD', 'CAD', 'CDF', 'CHE', 'CHF', 'CHW', 'CLF', 'CLP', 'CNY', 'COP', 'COU', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD', 'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GHS', 'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF', 'IDR', 'ILS', 'INR', 'IQD', 'IRR', 'ISK', 'JMD', 'JOD', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRU', 'MUR', 'MVR', 'MWK', 'MXN', 'MXV', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLE', 'SLL', 'SOS', 'SRD', 'SSP', 'STN', 'SVC', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TWD', 'TZS', 'UAH', 'UGX', 'USN', 'UYI', 'UYU', 'UYW', 'UZS', 'VED', 'VES', 'VND', 'VUV', 'WST', 'XAF', 'XAG', 'XAU', 'XBA', 'XBB', 'XBC', 'XBD', 'XCD', 'XDR', 'XOF', 'XPD', 'XPF', 'XPT', 'XSU', 'XTS', 'XUA', 'XXX', 'YER', 'ZAR', 'ZMW', 'ZWL'] | str#
통화
- order_name: str#
주문명
- is_manual: bool#
수동 발급 여부
- issue_number: str#
승인번호
- issued_at: str#
발급 시점 (RFC 3339 date-time)
- cancelled_at: str#
취소 시점 (RFC 3339 date-time)
- tax_free_amount: int | None#
면세액 (int64)
- vat_amount: int | None#
부가세액 (int64)
- type: Literal['PERSONAL', 'CORPORATE'] | str | None#
현금영수증 유형
- pg_receipt_id: str | None#
PG사 현금영수증 아이디
- url: str | None#
현금영수증 URL
- status_updated_at: str | None#
상태 업데이트 시점 (RFC 3339 date-time)
- class portone_server_sdk.payment.cash_receipt.CashReceiptFilterInput#
Bases:
object
현금영수증 다건 조회를 위한 입력 정보
- store_id: str | None#
상점 아이디
Merchant 사용자만 사용가능하며, 지정되지 않은 경우 고객사 전체 현금영수증을 조회합니다.
- time_range_field: Literal['ISSUED_AT', 'CANCELLED_AT', 'STATUS_UPDATED_AT'] | str | None#
조회 기준 시점 유형
값을 입력하지 않으면 ISSUED_AT으로 설정됩니다.
- from_: str | None#
조회 기준 시점 범위의 시작
값을 입력하지 않으면 end의 90일 전으로 설정됩니다. (RFC 3339 date-time)
- until: str | None#
조회 기준 시점 범위의 끝
값을 입력하지 않으면 현재 시점으로 설정됩니다. (RFC 3339 date-time)
- payment_id: str | None#
고객사 결제 아이디
- is_test: bool | None#
테스트 결제 필터링
- order_name: str | None#
주문명
- statuses: list[Literal['ISSUED', 'CANCELLED', 'FAILED'] | str] | None#
현금영수증 발급 상태 리스트
값을 입력하지 않으면 필터링이 적용되지 않습니다.
- is_manual: bool | None#
수동 발급 여부
- pg_receipt_id: str | None#
PG사 현금영수증 발급 번호
- pg_merchant_id: str | None#
PG 상점아이디
- pg_providers: list[Literal['HTML5_INICIS', 'PAYPAL', 'PAYPAL_V2', 'INICIS', 'DANAL', 'NICE', 'DANAL_TPAY', 'JTNET', 'UPLUS', 'NAVERPAY', 'KAKAO', 'SETTLE', 'KCP', 'MOBILIANS', 'KAKAOPAY', 'NAVERCO', 'SYRUP', 'KICC', 'EXIMBAY', 'SMILEPAY', 'PAYCO', 'KCP_BILLING', 'ALIPAY', 'PAYPLE', 'CHAI', 'BLUEWALNUT', 'SMARTRO', 'SMARTRO_V2', 'PAYMENTWALL', 'TOSSPAYMENTS', 'KCP_QUICK', 'DAOU', 'GALAXIA', 'TOSSPAY', 'KCP_DIRECT', 'SETTLE_ACC', 'SETTLE_FIRM', 'INICIS_UNIFIED', 'KSNET', 'PINPAY', 'NICE_V2', 'TOSS_BRANDPAY', 'WELCOME', 'TOSSPAY_V2', 'INICIS_V2', 'KPN', 'KCP_V2', 'HYPHEN', 'EXIMBAY_V2'] | str] | None#
PG사 결제 모듈 리스트
값을 입력하지 않으면 PG사 결제 모듈 필터링이 적용되지 않습니다.
- pg_companies: list[Literal['INICIS', 'NICE', 'KCP', 'DANAL', 'TOSSPAYMENTS', 'MOBILIANS', 'KICC', 'SMARTRO', 'DAOU', 'BLUEWALNUT', 'PAYPAL', 'ALIPAY', 'EXIMBAY', 'PAYMENTWALL', 'SETTLE', 'GALAXIA', 'NAVERPAY', 'KAKAOPAY', 'SMILEPAY', 'KAKAO', 'TOSSPAY', 'CHAI', 'PAYCO', 'PAYPLE', 'SYRUP', 'KSNET', 'WELCOME', 'JTNET', 'KPN', 'HYPHEN'] | str] | None#
PG사 리스트
값을 입력하지 않으면 PG사 필터링이 적용되지 않습니다.
- version: Literal['V1', 'V2'] | str | None#
포트원 버전
- class portone_server_sdk.payment.cash_receipt.CashReceiptSortInput#
Bases:
object
현금영수증 다건 조회 시 정렬 조건
- by: Literal['ISSUED_AT', 'CANCELLED_AT', 'STATUS_UPDATED_AT'] | str | None#
정렬 기준 필드
어떤 필드를 기준으로 정렬할 지 결정합니다. 비워서 보낼 경우, ISSUED_AT이 기본값으로 설정됩니다.
- order: Literal['DESC', 'ASC'] | str | None#
정렬 순서
어떤 순서로 정렬할 지 결정합니다. 비워서 보낼 경우, DESC(내림차순)가 기본값으로 설정됩니다.
- class portone_server_sdk.payment.cash_receipt.CashReceiptSummary#
Bases:
object
현금영수증 내역
- issue_number: str#
발행 번호
- url: str#
현금 영수증 URL
- pg_receipt_id: str#
PG사 현금영수증 아이디
- class portone_server_sdk.payment.cash_receipt.GetCashReceiptsBody#
Bases:
object
현금영수증 다건 조회를 위한 입력 정보
- sort: CashReceiptSortInput | None#
정렬 조건
미 입력 시 sortBy: ISSUED_AT, sortOrder: DESC 으로 기본값이 적용됩니다.
- filter: CashReceiptFilterInput | None#
조회할 현금영수증 조건 필터
- class portone_server_sdk.payment.cash_receipt.GetCashReceiptsResponse#
Bases:
object
현금영수증 다건 조회 성공 응답 정보
- items: list[CancelledCashReceipt | IssuedCashReceipt | IssueFailedCashReceipt | dict]#
조회된 현금영수증 리스트
- class portone_server_sdk.payment.cash_receipt.IssueCashReceiptBody#
Bases:
object
현금영수증 발급 요청 양식
- payment_id: str#
결제 건 아이디
외부 결제 건에 대한 수동 발급의 경우, 아이디를 직접 채번하여 입력합니다.
- channel_key: str#
채널 키
- type: Literal['PERSONAL', 'CORPORATE'] | str#
현금 영수증 유형
- order_name: str#
주문명
- currency: Literal['KRW', 'USD', 'JPY', 'AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN', 'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BOV', 'BRL', 'BSD', 'BTN', 'BWP', 'BYN', 'BZD', 'CAD', 'CDF', 'CHE', 'CHF', 'CHW', 'CLF', 'CLP', 'CNY', 'COP', 'COU', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD', 'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GHS', 'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF', 'IDR', 'ILS', 'INR', 'IQD', 'IRR', 'ISK', 'JMD', 'JOD', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRU', 'MUR', 'MVR', 'MWK', 'MXN', 'MXV', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLE', 'SLL', 'SOS', 'SRD', 'SSP', 'STN', 'SVC', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TWD', 'TZS', 'UAH', 'UGX', 'USN', 'UYI', 'UYU', 'UYW', 'UZS', 'VED', 'VES', 'VND', 'VUV', 'WST', 'XAF', 'XAG', 'XAU', 'XBA', 'XBB', 'XBC', 'XBD', 'XCD', 'XDR', 'XOF', 'XPD', 'XPF', 'XPT', 'XSU', 'XTS', 'XUA', 'XXX', 'YER', 'ZAR', 'ZMW', 'ZWL'] | str#
화폐
- amount: PaymentAmountInput#
금액 세부 입력 정보
- customer: IssueCashReceiptCustomerInput#
고객 정보
- store_id: str | None#
상점 아이디
접근 권한이 있는 상점 아이디만 입력 가능하며, 미입력시 토큰에 담긴 상점 아이디를 사용합니다.
- product_type: Literal['PHYSICAL', 'DIGITAL'] | str | None#
상품 유형
- paid_at: str | None#
결제 일자 (RFC 3339 date-time)
- business_registration_number: str | None#
사업자등록번호
웰컴페이먼츠의 경우에만 입력합니다.
- payment_method: Literal['TRANSFER', 'VIRTUAL_ACCOUNT'] | str | None#
결제 수단
웰컴페이먼츠의 경우에만 입력합니다.
- class portone_server_sdk.payment.cash_receipt.IssueCashReceiptCustomerInput#
Bases:
object
현금영수증 발급 시 고객 관련 입력 정보
- identity_number: str#
고객 식별값
- name: str | None#
이름
- email: str | None#
이메일
- phone_number: str | None#
전화번호
- class portone_server_sdk.payment.cash_receipt.IssueCashReceiptResponse#
Bases:
object
현금 영수증 발급 성공 응답
- cash_receipt: CashReceiptSummary#
- class portone_server_sdk.payment.cash_receipt.IssueFailedCashReceipt#
Bases:
object
발급 실패
- merchant_id: str#
고객사 아이디
- store_id: str#
상점 아이디
- payment_id: str#
결제 건 아이디
- order_name: str#
주문명
- is_manual: bool#
수동 발급 여부
- channel: SelectedChannel | None#
현금영수증 발급에 사용된 채널
- status_updated_at: str | None#
상태 업데이트 시점 (RFC 3339 date-time)
- class portone_server_sdk.payment.cash_receipt.IssuedCashReceipt#
Bases:
object
발급 완료
- merchant_id: str#
고객사 아이디
- store_id: str#
상점 아이디
- payment_id: str#
결제 건 아이디
- channel: SelectedChannel#
현금영수증 발급에 사용된 채널
- amount: int#
결제 금액 (int64)
- currency: Literal['KRW', 'USD', 'JPY', 'AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN', 'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BOV', 'BRL', 'BSD', 'BTN', 'BWP', 'BYN', 'BZD', 'CAD', 'CDF', 'CHE', 'CHF', 'CHW', 'CLF', 'CLP', 'CNY', 'COP', 'COU', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD', 'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GHS', 'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF', 'IDR', 'ILS', 'INR', 'IQD', 'IRR', 'ISK', 'JMD', 'JOD', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRU', 'MUR', 'MVR', 'MWK', 'MXN', 'MXV', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLE', 'SLL', 'SOS', 'SRD', 'SSP', 'STN', 'SVC', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TWD', 'TZS', 'UAH', 'UGX', 'USN', 'UYI', 'UYU', 'UYW', 'UZS', 'VED', 'VES', 'VND', 'VUV', 'WST', 'XAF', 'XAG', 'XAU', 'XBA', 'XBB', 'XBC', 'XBD', 'XCD', 'XDR', 'XOF', 'XPD', 'XPF', 'XPT', 'XSU', 'XTS', 'XUA', 'XXX', 'YER', 'ZAR', 'ZMW', 'ZWL'] | str#
통화
- order_name: str#
주문명
- is_manual: bool#
수동 발급 여부
- issue_number: str#
승인 번호
- issued_at: str#
발급 시점 (RFC 3339 date-time)
- tax_free_amount: int | None#
면세액 (int64)
- vat_amount: int | None#
부가세액 (int64)
- type: Literal['PERSONAL', 'CORPORATE'] | str | None#
현금영수증 유형
- pg_receipt_id: str | None#
PG사 현금영수증 아이디
- url: str | None#
현금영수증 URL
- status_updated_at: str | None#
상태 업데이트 시점 (RFC 3339 date-time)
- class portone_server_sdk.payment.cash_receipt.CashReceiptClient#
Bases:
object
- get_cash_receipt_by_payment_id(*, payment_id: str) CancelledCashReceipt | IssuedCashReceipt | IssueFailedCashReceipt | dict #
현금 영수증 단건 조회
주어진 결제 아이디에 대응되는 현금 영수증 내역을 조회합니다.
- Parameters:
payment_id (
str
) – 결제 건 아이디- Raises:
GetCashReceiptError – API 호출이 실패한 경우
ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우
- async get_cash_receipt_by_payment_id_async(*, payment_id: str) CancelledCashReceipt | IssuedCashReceipt | IssueFailedCashReceipt | dict #
현금 영수증 단건 조회
주어진 결제 아이디에 대응되는 현금 영수증 내역을 조회합니다.
- Parameters:
payment_id (
str
) – 결제 건 아이디- Raises:
GetCashReceiptError – API 호출이 실패한 경우
ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우
- get_cash_receipts(*, page: PageInput | None = None, sort: CashReceiptSortInput | None = None, filter: CashReceiptFilterInput | None = None) GetCashReceiptsResponse #
현금영수증 다건 조회
주어진 조건에 맞는 현금영수증들을 페이지 기반으로 조회합니다.
- Parameters:
page (
PageInput, optional
) –요청할 페이지 정보
미 입력 시 number: 0, size: 10 으로 기본값이 적용됩니다.
sort (
CashReceiptSortInput, optional
) –정렬 조건
미 입력 시 sortBy: ISSUED_AT, sortOrder: DESC 으로 기본값이 적용됩니다.
filter (
CashReceiptFilterInput, optional
) – 조회할 현금영수증 조건 필터
- Raises:
GetCashReceiptsError – API 호출이 실패한 경우
ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우
- async get_cash_receipts_async(*, page: PageInput | None = None, sort: CashReceiptSortInput | None = None, filter: CashReceiptFilterInput | None = None) GetCashReceiptsResponse #
현금영수증 다건 조회
주어진 조건에 맞는 현금영수증들을 페이지 기반으로 조회합니다.
- Parameters:
page (
PageInput, optional
) –요청할 페이지 정보
미 입력 시 number: 0, size: 10 으로 기본값이 적용됩니다.
sort (
CashReceiptSortInput, optional
) –정렬 조건
미 입력 시 sortBy: ISSUED_AT, sortOrder: DESC 으로 기본값이 적용됩니다.
filter (
CashReceiptFilterInput, optional
) – 조회할 현금영수증 조건 필터
- Raises:
GetCashReceiptsError – API 호출이 실패한 경우
ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우
- issue_cash_receipt(*, payment_id: str, channel_key: str, type: Literal['PERSONAL', 'CORPORATE'] | str, order_name: str, currency: Literal['KRW', 'USD', 'JPY', 'AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN', 'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BOV', 'BRL', 'BSD', 'BTN', 'BWP', 'BYN', 'BZD', 'CAD', 'CDF', 'CHE', 'CHF', 'CHW', 'CLF', 'CLP', 'CNY', 'COP', 'COU', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD', 'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GHS', 'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF', 'IDR', 'ILS', 'INR', 'IQD', 'IRR', 'ISK', 'JMD', 'JOD', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRU', 'MUR', 'MVR', 'MWK', 'MXN', 'MXV', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLE', 'SLL', 'SOS', 'SRD', 'SSP', 'STN', 'SVC', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TWD', 'TZS', 'UAH', 'UGX', 'USN', 'UYI', 'UYU', 'UYW', 'UZS', 'VED', 'VES', 'VND', 'VUV', 'WST', 'XAF', 'XAG', 'XAU', 'XBA', 'XBB', 'XBC', 'XBD', 'XCD', 'XDR', 'XOF', 'XPD', 'XPF', 'XPT', 'XSU', 'XTS', 'XUA', 'XXX', 'YER', 'ZAR', 'ZMW', 'ZWL'] | str, amount: PaymentAmountInput, product_type: Literal['PHYSICAL', 'DIGITAL'] | str | None = None, customer: IssueCashReceiptCustomerInput, paid_at: str | None = None, business_registration_number: str | None = None, payment_method: Literal['TRANSFER', 'VIRTUAL_ACCOUNT'] | str | None = None) IssueCashReceiptResponse #
현금 영수증 수동 발급
현금 영수증 발급을 요청합니다.
- Parameters:
payment_id (
str
) –결제 건 아이디
외부 결제 건에 대한 수동 발급의 경우, 아이디를 직접 채번하여 입력합니다.
channel_key (
str
) – 채널 키type (
CashReceiptType
) – 현금 영수증 유형order_name (
str
) – 주문명currency (
Currency
) – 화폐amount (
PaymentAmountInput
) – 금액 세부 입력 정보product_type (
PaymentProductType, optional
) – 상품 유형customer (
IssueCashReceiptCustomerInput
) – 고객 정보paid_at (
str, optional
) – 결제 일자business_registration_number (
str, optional
) –사업자등록번호
웰컴페이먼츠의 경우에만 입력합니다.
payment_method (
IssueCashReceiptPaymentMethodType, optional
) –결제 수단
웰컴페이먼츠의 경우에만 입력합니다.
- Raises:
IssueCashReceiptError – API 호출이 실패한 경우
ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우
- async issue_cash_receipt_async(*, payment_id: str, channel_key: str, type: Literal['PERSONAL', 'CORPORATE'] | str, order_name: str, currency: Literal['KRW', 'USD', 'JPY', 'AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN', 'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BOV', 'BRL', 'BSD', 'BTN', 'BWP', 'BYN', 'BZD', 'CAD', 'CDF', 'CHE', 'CHF', 'CHW', 'CLF', 'CLP', 'CNY', 'COP', 'COU', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD', 'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GHS', 'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF', 'IDR', 'ILS', 'INR', 'IQD', 'IRR', 'ISK', 'JMD', 'JOD', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRU', 'MUR', 'MVR', 'MWK', 'MXN', 'MXV', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLE', 'SLL', 'SOS', 'SRD', 'SSP', 'STN', 'SVC', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TWD', 'TZS', 'UAH', 'UGX', 'USN', 'UYI', 'UYU', 'UYW', 'UZS', 'VED', 'VES', 'VND', 'VUV', 'WST', 'XAF', 'XAG', 'XAU', 'XBA', 'XBB', 'XBC', 'XBD', 'XCD', 'XDR', 'XOF', 'XPD', 'XPF', 'XPT', 'XSU', 'XTS', 'XUA', 'XXX', 'YER', 'ZAR', 'ZMW', 'ZWL'] | str, amount: PaymentAmountInput, product_type: Literal['PHYSICAL', 'DIGITAL'] | str | None = None, customer: IssueCashReceiptCustomerInput, paid_at: str | None = None, business_registration_number: str | None = None, payment_method: Literal['TRANSFER', 'VIRTUAL_ACCOUNT'] | str | None = None) IssueCashReceiptResponse #
현금 영수증 수동 발급
현금 영수증 발급을 요청합니다.
- Parameters:
payment_id (
str
) –결제 건 아이디
외부 결제 건에 대한 수동 발급의 경우, 아이디를 직접 채번하여 입력합니다.
channel_key (
str
) – 채널 키type (
CashReceiptType
) – 현금 영수증 유형order_name (
str
) – 주문명currency (
Currency
) – 화폐amount (
PaymentAmountInput
) – 금액 세부 입력 정보product_type (
PaymentProductType, optional
) – 상품 유형customer (
IssueCashReceiptCustomerInput
) – 고객 정보paid_at (
str, optional
) – 결제 일자business_registration_number (
str, optional
) –사업자등록번호
웰컴페이먼츠의 경우에만 입력합니다.
payment_method (
IssueCashReceiptPaymentMethodType, optional
) –결제 수단
웰컴페이먼츠의 경우에만 입력합니다.
- Raises:
IssueCashReceiptError – API 호출이 실패한 경우
ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우
- cancel_cash_receipt_by_payment_id(*, payment_id: str) CancelCashReceiptResponse #
현금 영수증 취소
현금 영수증 취소를 요청합니다.
- Parameters:
payment_id (
str
) – 결제 건 아이디- Raises:
CancelCashReceiptError – API 호출이 실패한 경우
ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우
- async cancel_cash_receipt_by_payment_id_async(*, payment_id: str) CancelCashReceiptResponse #
현금 영수증 취소
현금 영수증 취소를 요청합니다.
- Parameters:
payment_id (
str
) – 결제 건 아이디- Raises:
CancelCashReceiptError – API 호출이 실패한 경우
ValueError – 현재 SDK 버전에서 지원하지 않는 API 응답을 받은 경우