장바구니/주문결제 에러코드 안내

업데이트 일자: 2023. 1.17

[FAQ] 샵바이프리미엄 1:1문의를 통해 문의가 자주 들어오는 공통질문을 모아서 답변하는 콘텐츠입니다.

❓질문

장바구니 및 주문결제 API 요청 시, 응답될 수 있는 에러코드 및 메시지가 궁금합니다.

❗답변

아래 장바구니/결제 관련 에러 코드 참고 부탁드립니다. 상황에 따라 아래 에러 코드 외에 다른 에러도 발생할 수 있으며, 모든 에러에 대한 코드 정보를 다 취합할 수 없는 부분 참고 부탁드립니다.

(1/17 업데이트) 더불어, 결제 시 발생하는 에러메시지를 커스터마이징 할 수 있도록 아래 안내드립니다.

  1. 장바구니 1-1. 에러코드

INVALID_OPTION("PPVE0001", "payProduct.payProductValidationErrorCode.invalidOption"),
UNUSABLE_CART_PRODUCT("PPVE0002", "payProduct.payProductValidationErrorCode.unusableCartProduct"),
MINOR_PURCHASE_IS_NOT_POSSIBLE(
    "PPVE0003",
    "payProduct.payProductValidationErrorCode.minorPurchaseIsNotPossible"
),
NONMEMBER_PURCHASE_IS_NOT_POSSIBLE(
    "PPVE0004",
    "payProduct.payProductValidationErrorCode.nonmemberPurchaseIsNotPossible"
),
CANNOT_BE_SOLD("PPVE0005", "payProduct.payProductValidationErrorCode.cannotBeSold"),
INVALID_PAYMENT_TYPE("PPVE0006", "payProduct.payProductValidationErrorCode.invalidPaymentType"),
MEMBER_GRADE_NOT_AVAILABLE_FOR_PURCHASE(
    "PPVE0007",
    "payProduct.payProductValidationErrorCode.memberGradeNotAvailableForPurchase"
),
MEMBER_GROUP_NOT_AVAILABLE_FOR_PURCHASE(
    "PPVE0008",
    "payProduct.payProductValidationErrorCode.memberGroupNotAvailableForPurchase"
),
PURCHASE_QUANTITY_LIMIT("PPVE0009", "payProduct.payProductValidationErrorCode.purchaseQuantityLimit"),
ERROR_ONLY_MEMBER_PURCHASE_ALLOWED_FOR_ADULT(
    "PPVE0010",
    "payProduct.payProductValidationErrorCode.onlyMemberPurchaseAllowedForAdult"
),
OUT_OF_STOCK("PPVE0011", "payProduct.payProductValidationErrorCode.outOfStock"),
OUT_OF_STOCK_NO_OPTION("PPVE0020", "payProduct.payProductValidationErrorCode.cannotBeSold"),

PRODUCT_IS_DELETED("PPVE0012", "payProduct.payProductValidationErrorCode.productIsDeleted"),
PRODUCT_SALE_STATUS_STOP("PPVE0013", "payProduct.payProductValidationErrorCode.productSaleStatusStop"),
PRODUCT_SALE_STATUS_READY("PPVE0014", "payProduct.payProductValidationErrorCode.productSaleStatusReady"),
PRODUCT_SALE_STATUS_FINISHED("PPVE0015", "payProduct.payProductValidationErrorCode.productSaleStatusFinished"),
PRODUCT_SALE_STATUS_PROHIBITION(
    "PPVE0016",
    "payProduct.payProductValidationErrorCode.productSaleStatusProhibition"
),
PRODUCT_SALE_STATUS_RESERVATION_READY(
    "PPVE0017",
    "payProduct.payProductValidationErrorCode.productSaleStatusReservationReady"
),
PRODUCT_SALE_STATUS_RESERVATION_FINISHED(
    "PPVE0018",
    "payProduct.payProductValidationErrorCode.productSaleStatusReservationFinished"
),
FRONT_DISPLAY_NONE("PPVE0019", "payProduct.payProductValidationErrorCode.frontDisplayNone"),
UNABLE_TO_DELIVER("PPVE0020", "payProduct.payProductValidationErrorCode.unableToDeliver")

1-2. 에러메시지

  1. 결제 2-1. 에러코드

2-2. 에러 메시지

  1. 결제 시 발생하는 에러메시지 커스터마이징 방법

step 1) 아래 코드 참고하여 failCallback 함수 작성

step 2) 쇼핑몰에서 결제시 NCPPay.reservation() 함수의 3번째 인자에 failCallback, 4번째 인자(disableDefaultAlert)에 true 전달

Previous쿠폰 코드 API 에러메시지 안내Next배송타입 및 택배사코드 안내

Last updated

Was this helpful?