차액정산 요청 API 에러
Request Body 필수 파라미터 누락
{
"code": "NOT_FOUND_PAYMENT",
"message": "존재하지 않는 결제 입니다."
}
JSON
복사
•
code: 에러 타입을 보여주는 에러 코드입니다.
•
message: 에러 메시지입니다. 에러 발생 이유를 알려줍니다.
Table
Request Body 필수 파라미터 내부 오류
아래 에러 코드가 failure에 포함됩니다.
{
"settlementDifferences": [
{
"settlementDifferenceKey": "QFjHQ1i4bsaI1oBpDssMX",
"status": "FAILED",
"failure": {
"code": "INVALID_PAYMENT_KEY",
"message": "잘못된 결제 키 입니다.",
},
"payment": null, // INVALID_PAYMENT_KEY
"subMall": null, // NOT_FOUND_SUBMALL
"payoutDate": null,
"payoutAmount": null
}
]
}
JSON
복사
내부 데이터 오류
에러 코드 | 에러 메시지 |
DUPLICATE_REQUEST_KEY | 해당 요청 건에 중복된 RequestKey가 존재 합니다. |
ALREADY_PROCESSED_REQUEST_KEY | 과거 요청에서 이미 처리된 RequestKey 입니다. |
차액정산 조회 API 에러
Query 파라미터 오류
{
"code": "INVALID_DATE",
"message": "날짜 데이터가 잘못 되었습니다."
}
JSON
복사
•
code: 에러 타입을 보여주는 에러 코드입니다.
•
message: 에러 메시지입니다. 에러 발생 이유를 알려줍니다.
Table
내부 데이터 오류
에러 코드 | 에러 메시지 |
INVALID_TRANSACTION_DATE | 결제일자 누락 혹은 요청 일자의 포맷이 잘못되었습니다. |
NO_CHILD_BUSINESS_NUMBER | 차액정산 대상 하위사업자번호가 누락되었습니다. |
NO_CHILD_TRANSACTION_AMOUNT | 차액정산 대상 하위사업자 거래금액이 누락되었습니다. |
FOREIGN_CARD_PAYMENT | 해외카드는 차액정산 대상이 아닙니다. |
NO_CARD_PAYMENT | 차액정산 요청에 해당하는 원거래가 존재하지 않습니다. |
MISMATCH_PAYMENT_DATE | 원거래 카드 결제 승인일자가 일치하지 않습니다. |
RELATED_REQUEST_ERROR | 해당 거래(paymentKey)의 요청 중 오류가 존재합니다.(연관 요청건 오류) |
DUPLICATE_SUMMARY_KEY | 당일 요청 건 중 중복된 요청이 존재합니다.[paymentKey + 승인/취소 + 하위사업자번호] |
DUPLICATE_FULL_KEY | 당일 요청 건 중 중복된 요청이 존재합니다.[요청일 + paymentKey + 승인/취소 + 승인/취소일자 + 하위사업자번호] |
DUPLICATE_ALREADY_REQUESTED | 과거 요청 건 중 중복된 요청이 존재합니다. |
APPROVAL_NOT_MATCHED_REQUEST_AMOUNT | 하위사업자 총 승인 금액의 합이 원거래 금액과 일치하지 않습니다. |
PARTIAL_CANCEL_NOT_MATCHED_REQUEST_AMOUNT | 하위사업자 거래 총액이 부분취소 금액과 일치하지 않습니다. |
CANCEL_NOT_MATCHED_REQUEST_AMOUNT | 하위사업자 거래 총액이 취소 금액과 일치하지 않습니다. |
EXCEED_CANCEL_REQUEST_AMOUNT | 취소(혹은 부분취소)의 합이 승인거래의 금액을 초과합니다. |
NOT_EXISTS_SUCCESS_DIFFERENCE_APPROVE | 차액정산 취소요청이지만, 정상처리된 차액정산 승인내역이 존재하지 않습니다. |
INVALID_APPROVE_PROPAGATION | 함께 업로드한 승인 건 중 검증 실패한 거래가 존재합니다. |
INVALID_MERCHANT_SALES_GRADE | 차액정산 대상 상점이 아닙니다. 영중소 등급을 다시 확인해주세요. |
REJECT_CONFIRM | 매입 반송 확정된 대상입니다. |
REJECT_CONFIRM_CANCEL | 매입 반송 확정 취소된 대상입니다. |
UNKNOWN_ERROR | 관리자의 확인이 필요합니다. |
기타 Fallback 에러
Table