Errors.AlreadyPaidError 결제가 이미 완료된 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 단건 조회
주어진 아이디에 대응되는 결제 건을 조회합니다.
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 다건 조회(페이지 기반)
주어진 조건에 맞는 결제 건들을 페이지 기반으로 조회합니다.
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
Optional
options: { Optional
page?: PageInput요청할 페이지 정보
미 입력 시 number: 0, size: 10 으로 기본값이 적용됩니다.
Optional
filter?: PaymentFilterInput조회할 결제 건 조건 필터
V1 결제 건의 경우 일부 필드에 대해 필터가 적용되지 않을 수 있습니다.
결제 대용량 다건 조회(커서 기반)
기간 내 모든 결제 건을 커서 기반으로 조회합니다. 결제 건의 생성일시를 기준으로 주어진 기간 내 존재하는 모든 결제 건이 조회됩니다.
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
Optional
options: { Optional
from?: string결제 건 생성시점 범위 조건의 시작
값을 입력하지 않으면 end의 90일 전으로 설정됩니다. (RFC 3339 date-time)
Optional
until?: string결제 건 생성시점 범위 조건의 끝
값을 입력하지 않으면 현재 시점으로 설정됩니다. (RFC 3339 date-time)
Optional
cursor?: string커서
결제 건 리스트 중 어디서부터 읽어야 할지 가리키는 값입니다. 최초 요청일 경우 값을 입력하지 마시되, 두번째 요청 부터는 이전 요청 응답값의 cursor를 입력해주시면 됩니다.
Optional
size?: number페이지 크기
미입력 시 기본값은 10 이며 최대 1000까지 허용 (int32)
결제 취소
결제 취소를 요청합니다.
Errors.CancellableAmountConsistencyBrokenError 취소 가능 잔액 검증에 실패한 경우
Errors.CancelAmountExceedsCancellableAmountError 결제 취소 금액이 취소 가능 금액을 초과한 경우
Errors.CancelTaxAmountExceedsCancellableTaxAmountError 취소 과세 금액이 취소 가능한 과세 금액을 초과한 경우
Errors.CancelTaxFreeAmountExceedsCancellableTaxFreeAmountError 취소 면세 금액이 취소 가능한 면세 금액을 초과한 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentAlreadyCancelledError 결제가 이미 취소된 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.RemainedAmountLessThanPromotionMinPaymentAmountError 부분 취소 시, 취소하게 될 경우 남은 금액이 프로모션의 최소 결제 금액보다 작아지는 경우
Errors.SumOfPartsExceedsCancelAmountError 면세 금액 등 하위 항목들의 합이 전체 취소 금액을 초과한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 건 아이디
Optional
amount?: number취소 총 금액
값을 입력하지 않으면 전액 취소됩니다. (int64)
Optional
tax취소 금액 중 면세 금액
값을 입력하지 않으면 전액 과세 취소됩니다. (int64)
Optional
vat취소 금액 중 부가세액
값을 입력하지 않으면 자동 계산됩니다. (int64)
취소 사유
Optional
requester?: CancelRequester취소 요청자
고객에 의한 취소일 경우 Customer, 관리자에 의한 취소일 경우 Admin으로 입력합니다.
Optional
current결제 건의 취소 가능 잔액
본 취소 요청 이전의 취소 가능 잔액으로써, 값을 입력하면 잔액이 일치하는 경우에만 취소가 진행됩니다. 값을 입력하지 않으면 별도의 검증 처리를 수행하지 않습니다. (int64)
Optional
refund환불 계좌
계좌 환불일 경우 입력합니다. 계좌 환불이 필요한 경우는 가상계좌 환불, 휴대폰 익월 환불 등이 있습니다.
빌링키 결제
빌링키로 결제를 진행합니다.
Errors.AlreadyPaidError 결제가 이미 완료된 경우
Errors.BillingKeyAlreadyDeletedError 빌링키가 이미 삭제된 경우
Errors.BillingKeyNotFoundError 빌링키가 존재하지 않는 경우
Errors.ChannelNotFoundError 요청된 채널이 존재하지 않는 경우
Errors.DiscountAmountExceedsTotalAmountError 프로모션 할인 금액이 결제 시도 금액 이상인 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.MaxTransactionCountReachedError 결제 혹은 본인인증 시도 횟수가 최대에 도달한 경우
Errors.PaymentScheduleAlreadyExistsError 결제 예약건이 이미 존재하는 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.PromotionPayMethodDoesNotMatchError 결제수단이 프로모션에 지정된 것과 일치하지 않는 경우
Errors.SumOfPartsExceedsTotalAmountError 면세 금액 등 하위 항목들의 합이 전체 결제 금액을 초과한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 건 아이디
빌링키 결제에 사용할 빌링키
Optional
channel채널 키
다수 채널에 대해 발급된 빌링키에 대해, 결제 채널을 특정하고 싶을 때 명시
주문명
Optional
customer?: CustomerInput고객 정보
Optional
custom사용자 지정 데이터
결제 금액 세부 입력 정보
통화
Optional
installment할부 개월 수 (int32)
Optional
use무이자 할부 이자를 고객사가 부담할지 여부
Optional
use카드 포인트 사용 여부
Optional
cash현금영수증 정보
Optional
country?: Country결제 국가
Optional
notice웹훅 주소
결제 승인/실패 시 요청을 받을 웹훅 주소입니다. 상점에 설정되어 있는 값보다 우선적으로 적용됩니다. 입력된 값이 없을 경우에는 빈 배열로 해석됩니다.
Optional
products?: PaymentProduct[]상품 정보
입력된 값이 없을 경우에는 빈 배열로 해석됩니다.
Optional
product상품 개수 (int32)
Optional
product상품 유형
Optional
shipping배송지 주소
Optional
promotion해당 결제에 적용할 프로모션 아이디
Optional
bypass?: objectPG사별 추가 파라미터 ("PG사별 연동 가이드" 참고)
수기 결제
수기 결제를 진행합니다.
Errors.AlreadyPaidError 결제가 이미 완료된 경우
Errors.ChannelNotFoundError 요청된 채널이 존재하지 않는 경우
Errors.DiscountAmountExceedsTotalAmountError 프로모션 할인 금액이 결제 시도 금액 이상인 경우
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.MaxTransactionCountReachedError 결제 혹은 본인인증 시도 횟수가 최대에 도달한 경우
Errors.PaymentScheduleAlreadyExistsError 결제 예약건이 이미 존재하는 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.PromotionPayMethodDoesNotMatchError 결제수단이 프로모션에 지정된 것과 일치하지 않는 경우
Errors.SumOfPartsExceedsTotalAmountError 면세 금액 등 하위 항목들의 합이 전체 결제 금액을 초과한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 건 아이디
Optional
channel채널 키
채널 키 또는 채널 그룹 ID 필수
Optional
channel채널 그룹 ID
채널 키 또는 채널 그룹 ID 필수
결제수단 정보
주문명
Optional
is문화비 지출 여부
기본값은 false 입니다.
Optional
is에스크로 결제 여부
기본값은 false 입니다.
Optional
customer?: CustomerInput고객 정보
Optional
custom사용자 지정 데이터
결제 금액 세부 입력 정보
통화
Optional
country?: Country결제 국가
Optional
notice웹훅 주소
결제 승인/실패 시 요청을 받을 웹훅 주소입니다. 상점에 설정되어 있는 값보다 우선적으로 적용됩니다. 입력된 값이 없을 경우에는 빈 배열로 해석됩니다.
Optional
products?: PaymentProduct[]상품 정보
입력된 값이 없을 경우에는 빈 배열로 해석됩니다.
Optional
product상품 개수 (int32)
Optional
product상품 유형
Optional
shipping배송지 주소
Optional
promotion해당 결제에 적용할 프로모션 아이디
가상계좌 말소
발급된 가상계좌를 말소합니다.
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotWaitingForDepositError 결제 건이 입금 대기 상태가 아닌 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 건 아이디
에스크로 배송 정보 등록
에스크로 배송 정보를 등록합니다.
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 건 아이디
Optional
sender?: PaymentEscrowSenderInput에스크로 발송자 정보
Optional
receiver?: PaymentEscrowReceiverInput에스크로 수취인 정보
에스크로 물류 정보
Optional
send이메일 알림 전송 여부
에스크로 구매 확정 시 이메일로 알림을 보낼지 여부입니다.
Optional
products?: PaymentProduct[]상품 정보
에스크로 배송 정보 수정
에스크로 배송 정보를 수정합니다.
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 건 아이디
Optional
sender?: PaymentEscrowSenderInput에스크로 발송자 정보
Optional
receiver?: PaymentEscrowReceiverInput에스크로 수취인 정보
에스크로 물류 정보
Optional
send이메일 알림 전송 여부
에스크로 구매 확정 시 이메일로 알림을 보낼지 여부입니다.
Optional
products?: PaymentProduct[]상품 정보
에스크로 구매 확정
에스크로 결제를 구매 확정 처리합니다
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 건 아이디
Optional
fromStore: boolean확인 주체가 상점인지 여부
구매확정요청 주체가 고객사 관리자인지 구매자인지 구분하기 위한 필드입니다. 네이버페이 전용 파라미터이며, 구분이 모호한 경우 고객사 관리자(true)로 입력합니다.
웹훅 재발송
웹훅을 재발송합니다.
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.MaxWebhookRetryCountReachedError 동일한 webhook id에 대한 수동 재시도 횟수가 최대에 도달한 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.WebhookNotFoundError 웹훅 내역이 존재하지 않는 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
결제 건 아이디
Optional
webhookId: string웹훅 아이디
입력하지 않으면 결제 건의 가장 최근 웹훅 아이디가 기본 적용됩니다
영수증 내 하위 상점 거래 등록
결제 내역 매출전표에 하위 상점의 거래를 등록합니다. 지원되는 PG사: KG이니시스(이용 전 콘솔 -> 결제연동 탭에서 INIApi Key 등록 필요)
Errors.ForbiddenError 요청이 거절된 경우
Errors.InvalidRequestError 요청된 입력 정보가 유효하지 않은 경우
Errors.PaymentNotFoundError 결제 건이 존재하지 않는 경우
Errors.PaymentNotPaidError 결제가 완료되지 않은 경우
Errors.PgProviderError PG사에서 오류를 전달한 경우
Errors.UnauthorizedError 인증 정보가 올바르지 않은 경우
Errors.UnknownError API 응답이 알 수 없는 형식인 경우
등록할 하위 상점 결제 건 아이디
하위 상점 거래 목록
결제 정보 사전 등록
결제 정보를 사전 등록합니다.