Readonly
apiOptional
Readonly
store주어진 빌링키에 대응되는 빌링키 정보를 조회합니다.
조회할 빌링키
빌링키 정보 또는 null
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
빌링키를 삭제합니다.
삭제할 빌링키
삭제한 빌링키에 대한 정보
Errors.BillingKeyAlreadyDeletedError 빌링키가 이미 삭제된 경우
Errors.BillingKeyNotFoundError 빌링키가 존재하지 않는 경우
Errors.BillingKeyNotIssuedError
Errors.ChannelSpecificError 여러 채널을 지정한 요청에서, 채널 각각에서 오류가 발생한 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentScheduleAlreadyExistsError 결제 예약건이 이미 존재하는 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
주어진 조건에 맞는 빌링키들을 페이지 기반으로 조회합니다.
0부터 시작하는 페이지 번호
각 페이지 당 포함할 객체 수
Optional
options: { 빌링키 다건 조회를 위한 추가 정보
Optional
sort?: BillingKeySortInput빌링키 다건 조회 시 정렬 조건
Optional
filter?: Omit<BillingKeyFilterInput, "storeId">빌링키 다건 조회를 위한 입력 정보
조회된 빌링키 리스트
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
빌링키 발급을 요청합니다.
빌링키 발급 시 결제 수단 입력 양식
Optional
options: Omit<IssueBillingKeyBody, "method" | "storeId">빌링키 발급을 위한 추가 정보
빌링키 발급 정보
Errors.ChannelNotFoundError 요청된 채널이 존재하지 않는 경우
Errors.ChannelSpecificError 여러 채널을 지정한 요청에서, 채널 각각에서 오류가 발생한 경우
Errors.ForbiddenError 요청이 거절된 경우
요청된 입력 정보가 유효하지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
주어진 결제 아이디에 대응되는 현금 영수증 내역을 조회합니다.
결제 건 아이디
현금 영수증 객체 또는 null
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
현금 영수증 발급을 요청합니다.
현금 영수증 수동 발급을 위한 추가 정보
현금영수증 내역
Errors.CashReceiptAlreadyIssuedError 현금영수증이 이미 발급된 경우
Errors.ChannelNotFoundError 요청된 채널이 존재하지 않는 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
현금 영수증 취소를 요청합니다.
결제 건 아이디
현금 영수증 취소 정보
Errors.CashReceiptNotFoundError
Errors.CashReceiptNotIssuedError
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
주어진 아이디에 대응되는 본인인증 내역을 조회합니다.
조회할 본인인증 아이디
본인 인증 객체 또는 null
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
SMS 또는 APP 방식을 이용하여 본인인증 요청을 전송합니다.
본인인증 아이디
본인인증 요청을 전송하기 위한 추가 정보
Errors.ChannelNotFoundError 요청된 채널이 존재하지 않는 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.IdentityVerificationAlreadySentError 본인인증 건이 이미 API로 요청된 상태인 경우
Errors.IdentityVerificationAlreadyVerifiedError 본인인증 건이 이미 인증 완료된 상태인 경우
Errors.IdentityVerificationNotFoundError 요청된 본인인증 건이 존재하지 않는 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
요청된 본인인증에 대한 확인을 진행합니다.
본인인증 아이디
Optional
otp: stringOTP (One-Time Password) SMS 방식에서만 사용됩니다.
완료된 본인인증 내역
Errors.ForbiddenError 요청이 거절된 경우
Errors.IdentityVerificationAlreadyVerifiedError 본인인증 건이 이미 인증 완료된 상태인 경우
Errors.IdentityVerificationNotFoundError 요청된 본인인증 건이 존재하지 않는 경우
Errors.IdentityVerificationNotSentError 본인인증 건이 API로 요청된 상태가 아닌 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
SMS 본인인증 요청을 재전송합니다.
본인인증 아이디
Errors.ForbiddenError 요청이 거절된 경우
Errors.IdentityVerificationAlreadyVerifiedError 본인인증 건이 이미 인증 완료된 상태인 경우
Errors.IdentityVerificationNotFoundError 요청된 본인인증 건이 존재하지 않는 경우
Errors.IdentityVerificationNotSentError 본인인증 건이 API로 요청된 상태가 아닌 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
주어진 아이디에 대응되는 결제 예약 건을 조회합니다.
조회할 결제 예약 건 아이디
결제 예약 건 객체
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentScheduleNotFoundError 결제 예약건이 존재하지 않는 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
주어진 조건에 맞는 결제 예약 건들을 조회합니다.
filter.from
, filter.until
파라미터의 기본값이 결제 시점 기준
지난 90일에 속하는 건을 조회하도록 되어 있으니,
미래 예약 상태의 건을 조회하기 위해서는 해당 파라미터를 직접 설정해 주셔야 합니다.
0부터 시작하는 페이지 번호
각 페이지 당 포함할 객체 수
Optional
options: { 결제 예약 다건 조회를 위한 추가 정보
Optional
sort?: PaymentScheduleSortInputOptional
filter?: Omit<PaymentScheduleFilterInput, "storeId">조회된 예약 결제 건 리스트
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
결제 예약 건을 취소합니다.
Optional
options: Omit<RevokePaymentSchedulesBody, "storeId">결제 예약 건 취소를 위한 추가 정보
결제 예약 건 취소 정보
Errors.BillingKeyAlreadyDeletedError 빌링키가 이미 삭제된 경우
Errors.BillingKeyNotFoundError 빌링키가 존재하지 않는 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentScheduleAlreadyProcessedError 결제 예약건이 이미 처리된 경우
Errors.PaymentScheduleAlreadyRevokedError 결제 예약건이 이미 취소된 경우
Errors.PaymentScheduleNotFoundError 결제 예약건이 존재하지 않는 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
결제를 예약합니다.
결제 건 아이디
빌링키 결제 요청 입력 정보
결제 예정 시점
결제 예약 건
Errors.AlreadyPaidOrWaitingError 결제가 이미 완료되었거나 대기중인 경우
Errors.BillingKeyAlreadyDeletedError 빌링키가 이미 삭제된 경우
Errors.BillingKeyNotFoundError 빌링키가 존재하지 않는 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentScheduleAlreadyExistsError
Errors.SumOfPartsExceedsTotalAmountError
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
주어진 아이디에 대응되는 결제 건을 조회합니다.
조회할 결제 아이디
결제 건 객체 또는 null
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.ForbiddenError 요청이 거절된 경우
주어진 조건에 맞는 결제 건들을 페이지 기반으로 조회합니다.
0부터 시작하는 페이지 번호
각 페이지 당 포함할 객체 수
Optional
filter: Omit<PaymentFilterInput, "storeId">결제 건 다건 조회를 위한 입력 정보
조회된 결제 건 리스트
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.ForbiddenError 요청이 거절된 경우
결제 정보를 사전 등록합니다.
결제 건 아이디
Optional
options: Omit<PreRegisterPaymentBody, "storeId">등록할 사전 정보
Errors.AlreadyPaidError 결제가 이미 완료된 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
결제 취소를 요청합니다.
결제 건 아이디
결제 취소 정보
결제 취소 내역
Errors.CancelAmountExceedsCancellableAmountError 결제 취소 금액이 취소 가능 금액을 초과한 경우
Errors.CancelTaxAmountExceedsCancellableTaxAmountError 취소 과세 금액이 취소 가능한 과세 금액을 초과한 경우
Errors.CancelTaxFreeAmountExceedsCancellableTaxFreeAmountError 취소 면세 금액이 취소 가능한 면세 금액을 초과한 경우
Errors.CancellableAmountConsistencyBrokenError 취소 가능 잔액 검증에 실패한 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentAlreadyCancelledError 결제가 이미 취소된 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.SumOfPartsExceedsCancelAmountError 하위 항목들의 합이 전체 취소 금액을 초과한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.RemainedAmountLessThanPromotionMinPaymentAmountError 부분 취소 시, 취소하게 될 경우 남은 금액이 프로모션의 최소 결제 금액보다 작아지는 경우
빌링키로 결제를 진행합니다.
결제 건 아이디
빌링 키 결제 정보
빌링키 결제 완료된 결제 건 요약 정보
Errors.AlreadyPaidError 이미 결제가 완료된 건에 대하여 사전 등록을 시도할 경우
Errors.BillingKeyAlreadyDeletedError 빌링키가 이미 삭제된 경우
Errors.BillingKeyNotFoundError 빌링키가 존재하지 않는 경우
Errors.ChannelNotFoundError 요청된 채널이 존재하지 않는 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.SumOfPartsExceedsTotalAmountError 하위 항목들의 합이 전체 결제 금액을 초과한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.DiscountAmountExceedsTotalAmountError 프로모션 할인 금액이 결제 시도 금액 이상인 경우
Errors.PromotionPayMethodDoesNotMatchError 결제수단이 프로모션에 지정된 것과 일치하지 않는 경우
수기 결제를 진행합니다.
결제 건 아이디
수기 결제 정보
수기 결제가 완료된 결제 건 요약 정보
Errors.AlreadyPaidError 이미 결제가 완료된 건에 대하여 사전 등록을 시도할 경우
Errors.ChannelNotFoundError 요청된 채널이 존재하지 않는 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.SumOfPartsExceedsTotalAmountError 하위 항목들의 합이 전체 결제 금액을 초과한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.DiscountAmountExceedsTotalAmountError 프로모션 할인 금액이 결제 시도 금액 이상인 경우
Errors.PromotionPayMethodDoesNotMatchError 결제수단이 프로모션에 지정된 것과 일치하지 않는 경우
발급된 가상계좌를 말소합니다.
결제 건 아이디
가상계좌 말소 정보
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotWaitingForDepositError 결제 건이 입금 대기 상태가 아닌 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
에스크로 배송 정보를 등록합니다.
결제 건 아이디
에스크로 배송 정보
에스크로 정보 등록 정보
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
에스크로 배송 정보를 수정합니다.
결제 건 아이디
에스크로 배송 정보
에스크로 배송 정보 수정 정보
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
에스크로 결제를 구매 확정 처리합니다.
결제 건 아이디
Optional
fromStore: boolean확인 주체가 상점인지 여부
에스크로 구매 확정 정보
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
웹훅을 재발송합니다.
결제 건 아이디
Optional
webhookId: string웹훅 아이디
성공 웹훅 내역
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.WebhookNotFoundError 웹훅 내역이 존재하지 않는 경우
결제 내역 매출전표에 하위 상점의 거래를 등록할 수 있는 API입니다.
지원되는 PG사: KG이니시스 (이용 전 콘솔 -> 결제연동 탭에서 INIApi Key 등록 필요)
등록할 하위 상점 결제 건 아이디
하위 상점 거래 목록
하위 상점 거래 등록 정보
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
주어진 아이디에 대응되는 카카오페이 주문 건을 조회합니다.
해당 API 사용이 필요한 경우 포트원 기술지원팀으로 문의 주시길 바랍니다.
카카오페이 주문 번호 (tid)
채널 키
카카오페이 주문 조회 응답 객체
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
포트원 API 객체