클레임공통
Access Token
클레임 처리 요청 DTO
SYSTEM(시스템유형) * 10 : FO * 20 : BO
10Possible values: ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류
11Possible values: 주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 주문번호
20230808O007404회원번호
100001311클레임번호
20230808C010663회수완료 대기처리 사유
불량반품ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류
11Possible values: 성공
No content
업무처리 오류 내용
POST /api/order/v1/claim/fee/deliveryFeePayment HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 5010
{
"systemType": "10",
"claimBusinessType": "11",
"ordMediaCd": "20",
"ordNo": "20230808O007404",
"mbrNo": "100001311",
"claimNo": "20230808C010663",
"claimGoodsList": [
{
"ordSeq": 1,
"ordProcSeq": 1,
"goodsNo": "10002297",
"itmNo": "001",
"exchangeGoodsNo": "10002297",
"exchangeItmNo": "001",
"exchangeItmNm": "001",
"claimQty": 1,
"claimLgrpCd": "10",
"claimMgrpCd": "100",
"claimCausEtcCont": "배송이 늦어짐",
"withdrawalDeliNo": "100013106",
"shipmentDeliNo": "100013105",
"prOrdDtlAtchFileInfoList": [
{
"ordNo": "20230808O007404",
"ordSeq": 1,
"ordProcSeq": 1,
"fileSeq": "1",
"filePathNm": "files/order/2023/08/03/",
"fileNm": "d732ec3b-e044-43ca-8ecb-80051b2b36f8_10.png"
}
],
"ordSeqAndOrdProcSeq": "text"
}
],
"paymentRequest": {
"siteNo": "1",
"orderInfo": {
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"goodsNm": "플래티어커피",
"ordManNm": "김플래티어",
"ordmnCellNo": "01012345678",
"ordmnEmailAddr": "kim@plateer.com",
"crcUnitCd": "KRW",
"ordMediaCd": "30",
"mbrNo": "100000001",
"ordDtlGbCd": "10",
"clientIp": "127.0.0.1",
"taxFreeAmt": 1
},
"payInfoList": [
{
"payNo": "1",
"payWayCd": "11",
"payAmt": 1000,
"mersNo": "1",
"pgGbCd": "10",
"trdNo": "INIMX_DBNKINIpayTest20990101090000685510",
"selectCardCd": "01",
"termlId": "INIBillTst",
"billKey": "text",
"authResultMap": "{P_STATUS:결과코드, P_RMESG1:결과메시지, P_TID:인증거래번호, P_AMT:거래금액, idc_name:IDC센터코드P_REQ_URL:승인요청 URL, P_NOTI:가맹점 임의 데이터}"
}
]
},
"claimCpnInfoList": [
{
"cpnNo": "104224"
}
],
"claimReturnDlvp": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"claimDlvp": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"claimFinalAmtInfo": {
"ordNo": "20230913O058186",
"totAplyAdtnAmt": 6000,
"totCnclAdtnAmt": 0,
"totFvrAdtnAmt": 0,
"totOrdPrc": 46000,
"totDcAmt": 2200,
"expectedRefundAmt": 37800,
"addtionPayAmt": 0,
"returnAcceptAmt": 37800,
"refundAdditionAmtInfoList": [
{
"adtnOcurGbCd": "10",
"adtnOcurGbNm": "발생",
"type": "10",
"typeNm": "회수배송비",
"goodsNoItmNo": "10002762001",
"goodsNm": "상품명",
"ordAmt": 6000,
"discountMethod": "11",
"discountMethodNm": "상품할인쿠폰",
"cnclDcAmt": 2000,
"rtnDlvBenefitInfoList": [
{
"promoNo": "C1003841",
"promoNm": "무료반품쿠폰",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "4364872",
"aplyYn": "Y"
}
],
"reCalAdtnOcurGbCdAdtnAmt": 1
}
],
"refundPaymentMethodList": [
{
"payNo": "2",
"mbrNo": "100000001",
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"uprPayNo": "1",
"payGbCd": "10",
"payGbCdNm": "결제",
"payWayCd": "11",
"payWayCdNm": "신용카드",
"payStatCd": "12",
"payStatCdNm": "결제완료",
"payAmt": 10000,
"taxFreeAmt": 10000,
"rfdPsbAmt": 10000,
"rfdAmt": 1000,
"payFnshDtm": "2026-01-01T00:00:00.000Z",
"trdNo": "INIMX_CARDINIpayTest20990101090000685510",
"trdDtm": "2026-01-01T00:00:00.000Z",
"iscmCd": "202",
"iscmCdNm": "KB국민카드",
"payReqCardcoCd": "06",
"payReqCardcoCdNm": "국민카드",
"cardNo": "카드번호 암호화",
"cardNm": "국민카드",
"cardValiTerm": "text",
"nintDivYn": "N",
"divMonCnt": 0,
"cardPointUseYn": "N",
"mersNo": "1",
"acqrCd": "121",
"acqrCdNm": "국민카드",
"aprvNo": "12345678",
"aprvDtm": "2026-01-01T00:00:00.000Z",
"sctnCnclPsbYn": "Y",
"bankCd": "148",
"bankCdNm": "국민은행",
"actnNo": "계좌번호 암호화",
"dpmnNm": "김플래티어",
"dptFcstDt": "2099-01-01 09:00:00.000000",
"dptCnfmDtm": "2026-01-01T00:00:00.000Z",
"rfdBankCd": "148",
"rfdBankCdNm": "국민은행",
"rfdActnNo": "계좌번호 암호화",
"rfdActnDepositorNm": "홍길동",
"vbankPaymentPending": true,
"vbankDptCnfm": true
}
],
"paymentOrderInfo": {
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"goodsNm": "플래티어커피",
"ordManNm": "김플래티어",
"ordmnCellNo": "01012345678",
"ordmnEmailAddr": "kim@plateer.com",
"crcUnitCd": "KRW",
"ordMediaCd": "30",
"mbrNo": "100000001",
"ordDtlGbCd": "10",
"clientIp": "127.0.0.1",
"taxFreeAmt": 1
},
"rfdInfoResponse": {
"rfdBankCd": "203",
"rfdBankNm": "KB국민은행",
"rfdActnNo": "33330********",
"rfdActnDepositorNm": "임성현",
"rfdActnCertiYn": "Y"
}
},
"wthdFnshWaitProcCaus": "불량반품",
"occurPayment": true,
"existAddtionPayAmt": true,
"claimBusiness": "11"
}No content
Access Token
환불접수등록 Request DTO
주문번호
회원번호
회원명
로그인ID
환불유형코드(OM023)
환불진행상태코드(OM024)
환불은행코드(OM026)
환불계좌번호
환불예금주
환불사유코드(OM025)
환불계좌인증여부
환불금액
환불수수료금액
접수자ID
환불SMS발송여부
성공
업무처리 오류 내용
POST /api/order/v1/claim/common/saveNonMemberRefundActn HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 278
{
"ordNo": "text",
"mbrNo": "text",
"mbrNm": "text",
"loginId": "text",
"rfdTypCd": "text",
"rfdPrgsStatCd": "text",
"rfdBankCd": "text",
"rfdActnNo": "text",
"rfdActnDepositorNm": "text",
"rfdCausCd": "text",
"rfdActnCertiYn": "text",
"rfdAmt": 1,
"rfdCmsnAmt": 1,
"acptmnId": "text",
"rfdSmsSndYn": "text"
}textAccess Token
환불접수등록 Request DTO
주문번호
회원번호
회원명
로그인ID
환불유형코드(OM023)
환불진행상태코드(OM024)
환불은행코드(OM026)
환불계좌번호
환불예금주
환불사유코드(OM025)
환불계좌인증여부
환불금액
환불수수료금액
접수자ID
환불SMS발송여부
성공
업무처리 오류 내용
POST /api/order/v1/claim/common/saveNonMemberRefundActnFO HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 278
{
"ordNo": "text",
"mbrNo": "text",
"mbrNm": "text",
"loginId": "text",
"rfdTypCd": "text",
"rfdPrgsStatCd": "text",
"rfdBankCd": "text",
"rfdActnNo": "text",
"rfdActnDepositorNm": "text",
"rfdCausCd": "text",
"rfdActnCertiYn": "text",
"rfdAmt": 1,
"rfdCmsnAmt": 1,
"acptmnId": "text",
"rfdSmsSndYn": "text"
}textAccess Token
클레임 가능 대상 조회 요청 DTO
주문번호
20230808O007404ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류
11Possible values: 원클레임 번호
20230808C010663SYSTEM(시스템유형) * 10 : FO * 20 : BO
20Example: 10Possible values: 배송지순번
1ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류
11Possible values: SYSTEM(시스템유형) * 10 : FO * 20 : BO
10Possible values: 성공
클레임 처리대상 응답 DTO
주문번호
20231231O000001회원번호
100001311회원등급코드(ME008) 10 : GREEN , 20 : FAMILY , 30 : GOLD , 40 : VIP , 50 : VVIP
10Possible values: OM002(주문 구분 코드) 10: 일반주문 , 20: 선물하기 , 30: e-쿠폰 , 40: 제휴
10Possible values: ME002(회원관리코드) 10: UNION_MEMBER(통합회원) ,20: GENERAL_MEMBER(일반회원) ,30: SOCIAL_MEMBER(소셜회원) ,99: NO_MEMBER(비회원)
10Possible values: 주문자명
홍길동주문자이메일주소
test@plateer.com주문자휴대폰구분번호
010주문자휴대폰국번번호
1234주문자휴대폰끝번호
5678주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 주문접수일자
부분취소가능여부
NPossible values: 업무처리 오류 내용
POST /api/order/v1/claim/common/getReturnExchangeCancelTargetInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 181
{
"ordNo": "20230808O007404",
"claimBusinessType": "11",
"orgClmNo": "20230808C010663",
"systemType": "10",
"dlvpSeq": "1",
"systemCdNmAndButtonCode": "text",
"claimBusiness": "11",
"system": "10"
}{
"ordNo": "20231231O000001",
"mbrNo": "100001311",
"mbrGradeCd": "10",
"ordGbCd": "10",
"mbrMgrCd": "10",
"ordManNm": "홍길동",
"ordManEmailAddr": "test@plateer.com",
"ordManCellSctNo": "010",
"ordManCellTxnoNo": "1234",
"ordManCellEndNo": "5678",
"ordMediaCd": "20",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"sctnCnclPsbYn": "N",
"claimTargetGoodsResponseList": [
{
"goodsNo": "10002297",
"deliProcTypCd": "10",
"deliPolcNo": "10000151",
"deliNo": "100000021",
"entrNo": "1000002",
"ordQty": 1,
"salePrc": 30000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"ordNo": "20231231O000001",
"ordSeq": 1,
"ordProcSeq": 1,
"uprOrdProcSeq": 1,
"maxOrdProcSeq": 1,
"claimNo": "20231231C000001",
"itmNo": "001",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문일반",
"ordDtlStatCd": "10",
"ordDtlStatCdNm": "접수",
"deliGbCd": "10",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"cnclQty": 0,
"rtnQty": 0,
"claimQty": 0,
"claimPossibleQty": 5,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"exchMidRtnYn": "N",
"rtnPsbYn": "N",
"exchPsbYn": "N",
"ordCnclPsbYn": "N",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"claimLgrpCd": "10",
"claimLgrpCdNm": "단순변심",
"claimMgrpCd": "100",
"claimMgrpCdNm": "사이즈가 큼",
"claimCausEtcCont": "사이즈가 생각보다 큽니다.",
"ordSaleTypCd": "10",
"chlNo": "1000001",
"chlDtlNo": "1000001",
"stdCtgNo": "HT01020000",
"infDispCtgNoGbCd": "10",
"infDispCtgNo": "213",
"repDispCtgNo": "213",
"conrNo": "10050",
"brandNo": "100002",
"brandNm": "플래티어",
"goodsNm": "폴로티셔츠",
"goodsImg": "files/goods/2023/12/31/goodsImg.jpg",
"itmNm": "화이트>95",
"prestNm": "우산 증정",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"taxGbCd": "01",
"buyTypCd": "10",
"supPcost": 14400,
"norPrc": 25000,
"mrgnRate": 4,
"deliDday": 1,
"deliGoodsGbCd": "10",
"deliWayCd": "10",
"bpckPsbYn": "Y",
"hsCd": "0101",
"goodsRevWrtYn": "N",
"bnfAmt": 2000,
"ordPrc": 25000,
"aeGoodsYn": "N",
"withdrawalDeliNo": "100000001",
"shipmentDeliNo": "100000001",
"deliTypCd": "10",
"deliKindCd": "10",
"deliMethodCd": "10",
"deliProcTypCdNm": "업체배송",
"puTypCd": "20",
"wthdFnshGbCd": "10",
"dlvpNm": "자택",
"rcvmnNm": "홍길동",
"dlvpSeq": "1",
"maxDlvpSeq": "1",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "sample@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1122",
"rcvmnCellEndNo": "3546",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "112",
"rcvmnTelEndNo": "3546",
"deliMsg": "부재시 문앞에 두고 가주세요",
"deliMsgCd": "70",
"shopTrafMsg": "없음",
"comnFrdrCogoMethodCd": "10",
"comnFrdrEtcMethod": "없음",
"comnFrdrPwd": "1234",
"orgDlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"orgDeliNo": "100000021",
"lastDeliResponse": {
"ordNo": "text",
"deliNo": "text",
"ordSeq": "text",
"ordProcSeq": "text",
"shipIndiDtm": "2026-01-01T00:00:00.000Z",
"shipCfmDtm": "2026-01-01T00:00:00.000Z",
"shipFnshDtm": "2026-01-01T00:00:00.000Z",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"hdcCd": "text",
"invNo": "text",
"deliDtlStatCd": "text"
},
"shippingDeliGbCd": true,
"opOrdDtlUpdateKey": {
"ordNo": "text",
"ordSeq": 1,
"ordProcSeq": 1,
"uprOrdProcSeq": 1,
"claimNo": "text",
"goodsNo": "text",
"itmNo": "text",
"ordDtlGbCd": "text",
"deliGbCd": "text",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"ordDtlStatCd": "text",
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"deliNo": "text",
"exchMidRtnYn": "text",
"claimLgrpCd": "text",
"claimMgrpCd": "text",
"claimCausEtcCont": "text",
"rtnPsbYn": "text",
"exchPsbYn": "text",
"ordCnclPsbYn": "text",
"wthdYn": "text",
"wthdFnshGbCd": "text",
"shipFnshFcstDtm": "2026-01-01T00:00:00.000Z",
"etcktNo": "text",
"ecpnNo": "text"
},
"generalSalesProduct": true,
"exchangeShipping": true,
"withdrawalDeliGbCd": true,
"withdrawShipping": true,
"ordSeqAndUprOrdProcSeq": "text",
"goodsNoAndItmNo": "text",
"ordSeqAndOrdProcSeq": "text"
}
],
"allNonReturnable": true,
"vbankPaymentPending": true,
"allEcoupon": true
}Access Token
클레임 배송번호 요청 DTO
배송번호 리스트
shipment성공
업무처리 오류 내용
POST /api/order/v1/claim/common/getNewNumberedDeliNo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 23
{
"dlvpList": "shipment"
}[
"text"
]Access Token
클레임 상세 내역 조회 요청 DTO
주문번호
20230808O007404클레임번호
20230801C008072성공
클레임 배송비 결제대기상태 대상 응답 DTO
주문번호
20230808O007404주문접수일자
배송비합계
3000추가비용합계
3000추가금액
3000업무처리 오류 내용
POST /api/order/v1/claim/common/getClaimPayWaitStateInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 55
{
"ordNo": "20230808O007404",
"claimNo": "20230801C008072"
}{
"ordNo": "20230808O007404",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"deliAmtSum": 3000,
"totAplyAdtnAmt": 3000,
"addtionPayAmt": 3000,
"claimTargetResponse": {
"ordNo": "20231231O000001",
"mbrNo": "100001311",
"mbrGradeCd": "10",
"ordGbCd": "10",
"mbrMgrCd": "10",
"ordManNm": "홍길동",
"ordManEmailAddr": "test@plateer.com",
"ordManCellSctNo": "010",
"ordManCellTxnoNo": "1234",
"ordManCellEndNo": "5678",
"ordMediaCd": "20",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"sctnCnclPsbYn": "N",
"claimTargetGoodsResponseList": [
{
"goodsNo": "10002297",
"deliProcTypCd": "10",
"deliPolcNo": "10000151",
"deliNo": "100000021",
"entrNo": "1000002",
"ordQty": 1,
"salePrc": 30000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"ordNo": "20231231O000001",
"ordSeq": 1,
"ordProcSeq": 1,
"uprOrdProcSeq": 1,
"maxOrdProcSeq": 1,
"claimNo": "20231231C000001",
"itmNo": "001",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문일반",
"ordDtlStatCd": "10",
"ordDtlStatCdNm": "접수",
"deliGbCd": "10",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"cnclQty": 0,
"rtnQty": 0,
"claimQty": 0,
"claimPossibleQty": 5,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"exchMidRtnYn": "N",
"rtnPsbYn": "N",
"exchPsbYn": "N",
"ordCnclPsbYn": "N",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"claimLgrpCd": "10",
"claimLgrpCdNm": "단순변심",
"claimMgrpCd": "100",
"claimMgrpCdNm": "사이즈가 큼",
"claimCausEtcCont": "사이즈가 생각보다 큽니다.",
"ordSaleTypCd": "10",
"chlNo": "1000001",
"chlDtlNo": "1000001",
"stdCtgNo": "HT01020000",
"infDispCtgNoGbCd": "10",
"infDispCtgNo": "213",
"repDispCtgNo": "213",
"conrNo": "10050",
"brandNo": "100002",
"brandNm": "플래티어",
"goodsNm": "폴로티셔츠",
"goodsImg": "files/goods/2023/12/31/goodsImg.jpg",
"itmNm": "화이트>95",
"prestNm": "우산 증정",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"taxGbCd": "01",
"buyTypCd": "10",
"supPcost": 14400,
"norPrc": 25000,
"mrgnRate": 4,
"deliDday": 1,
"deliGoodsGbCd": "10",
"deliWayCd": "10",
"bpckPsbYn": "Y",
"hsCd": "0101",
"goodsRevWrtYn": "N",
"bnfAmt": 2000,
"ordPrc": 25000,
"aeGoodsYn": "N",
"withdrawalDeliNo": "100000001",
"shipmentDeliNo": "100000001",
"deliTypCd": "10",
"deliKindCd": "10",
"deliMethodCd": "10",
"deliProcTypCdNm": "업체배송",
"puTypCd": "20",
"wthdFnshGbCd": "10",
"dlvpNm": "자택",
"rcvmnNm": "홍길동",
"dlvpSeq": "1",
"maxDlvpSeq": "1",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "sample@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1122",
"rcvmnCellEndNo": "3546",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "112",
"rcvmnTelEndNo": "3546",
"deliMsg": "부재시 문앞에 두고 가주세요",
"deliMsgCd": "70",
"shopTrafMsg": "없음",
"comnFrdrCogoMethodCd": "10",
"comnFrdrEtcMethod": "없음",
"comnFrdrPwd": "1234",
"orgDlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"orgDeliNo": "100000021",
"lastDeliResponse": {
"ordNo": "text",
"deliNo": "text",
"ordSeq": "text",
"ordProcSeq": "text",
"shipIndiDtm": "2026-01-01T00:00:00.000Z",
"shipCfmDtm": "2026-01-01T00:00:00.000Z",
"shipFnshDtm": "2026-01-01T00:00:00.000Z",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"hdcCd": "text",
"invNo": "text",
"deliDtlStatCd": "text"
},
"shippingDeliGbCd": true,
"opOrdDtlUpdateKey": {
"ordNo": "text",
"ordSeq": 1,
"ordProcSeq": 1,
"uprOrdProcSeq": 1,
"claimNo": "text",
"goodsNo": "text",
"itmNo": "text",
"ordDtlGbCd": "text",
"deliGbCd": "text",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"ordDtlStatCd": "text",
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"deliNo": "text",
"exchMidRtnYn": "text",
"claimLgrpCd": "text",
"claimMgrpCd": "text",
"claimCausEtcCont": "text",
"rtnPsbYn": "text",
"exchPsbYn": "text",
"ordCnclPsbYn": "text",
"wthdYn": "text",
"wthdFnshGbCd": "text",
"shipFnshFcstDtm": "2026-01-01T00:00:00.000Z",
"etcktNo": "text",
"ecpnNo": "text"
},
"generalSalesProduct": true,
"exchangeShipping": true,
"withdrawalDeliGbCd": true,
"withdrawShipping": true,
"ordSeqAndUprOrdProcSeq": "text",
"goodsNoAndItmNo": "text",
"ordSeqAndOrdProcSeq": "text"
}
],
"allNonReturnable": true,
"vbankPaymentPending": true,
"allEcoupon": true
},
"opOrdAdtnCostList": [
{
"ordAdtnSn": "100001315",
"ordNo": "20231231O000001",
"claimNo": "20231231C000001",
"deliNo": "100000001",
"uprOrdAdtnSn": "100000842",
"entrNo": "1000002",
"adtnOcurGbCd": "10",
"ordCostGbCd": "10",
"stdAdtnAmt": 100000,
"aplyAdtnAmt": 0,
"cnclAdtnAmt": 0,
"fvrAdtnAmt": 0,
"deliPolcNo": "10000431",
"dlexTypCd": "30",
"dlexCnclCausCd": "10",
"dlexAmt": 3000,
"adtnBassNo": "C1001182",
"adtnDtlBassNo": "105962",
"fvrPolcTypCd": "00",
"fvrPolcAplyVal": 0,
"fvrMinBuyAmt": 0,
"fvrMaxDcAmt": 0,
"entrChrgRate": 0,
"entrChrgAmt": 0,
"ourChrgRate": 100,
"ourChrgAmt": 0,
"promoNm": "무료배송쿠폰"
}
],
"payWayInfoMap": [
{
"payWayCd": "11",
"useYn": "Y",
"langCd": "ko",
"cdNm": "text",
"cdDesc": "text",
"pgGbCd": "text",
"memberSubPaymethodAmount": 1,
"cardCompanyList": [
{
"cd": "302",
"cdNm": "색상변경",
"cdDesc": "[단순변심]",
"sortSeq": "22",
"ref1Val": "30",
"ref2Val": "10",
"ref3Val": "10",
"ref4Val": "10",
"ref5Val": "Y",
"ref6Val": "null",
"ref7Val": "null"
}
],
"mainPaymethod": true
}
],
"foSystemNmAndDeliveryButtonCode": "text"
}Access Token
성공
주문상세첨부파일정보 DTO
주문번호
20230808O007404주문순번
1주문처리순번
1파일순번
1파일경로
files/order/2023/08/03/파일명
d732ec3b-e044-43ca-8ecb-80051b2b36f8_10.png업무처리 오류 내용
POST /api/order/v1/claim/common/claimImgUpload?claimImgRequest=[object+Object]&userDetail=[object+Object] HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*
[
{
"ordNo": "20230808O007404",
"ordSeq": 1,
"ordProcSeq": 1,
"fileSeq": "1",
"filePathNm": "files/order/2023/08/03/",
"fileNm": "d732ec3b-e044-43ca-8ecb-80051b2b36f8_10.png"
}
]Access Token
클레임 상세 내역 조회 요청 DTO
주문번호
20230808O007404클레임번호
20230801C008072성공
클레임 상세 내역 조회 응답 DTO
주문번호
20230809O000001주문구분코드
10회원번호
100001311주문자명
홍길동주문자휴대폰구분번호
010주문자휴대폰국번번호
1234주문자휴대폰끝번호
5678주문자이메일주소
test@plateer.com클레임번호
20231231C000001주문접수일시
주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 전체회수불필요 여부
업무처리 오류 내용
POST /api/order/v1/claim/common/claimDetailsInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 55
{
"ordNo": "20230808O007404",
"claimNo": "20230801C008072"
}{
"ordNo": "20230809O000001",
"ordGbCd": "10",
"mbrNo": "100001311",
"ordManNm": "홍길동",
"ordManCellSctNo": "010",
"ordManCellTxnoNo": "1234",
"ordManCellEndNo": "5678",
"ordManEmailAddr": "test@plateer.com",
"claimNo": "20231231C000001",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordMediaCd": "20",
"claimGoodsDetailsList": [
{
"ordNo": "20231231O000001",
"ordSeq": 1,
"aeOrdSeq": "1",
"ordProcSeq": 1,
"ordProcAccpDtm": "2026-01-01T00:00:00.000Z",
"goodsNo": "10002297",
"itmNo": "001",
"goodsImg": "files/goods/2023/12/31/goodsImg.jpg",
"brandNm": "플래티어",
"goodsNm": "폴로티셔츠",
"itmNm": "화이트>95",
"norPrc": 25000,
"salePrc": 30000,
"goodsTypCd": "10",
"ordQty": 1,
"cnclQty": 0,
"rtnQty": 0,
"claimQty": 0,
"deliNo": "100000001",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문일반",
"ordDtlStatCd": "10",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"deliGbCd": "10",
"claimLgrpCd": "10",
"claimLgrpCdNm": "단순변심",
"claimMgrpCd": "100",
"claimMgrpCdNm": "사이즈가 큼",
"claimCausEtcCont": "사이즈가 생각보다 큽니다.",
"ordSaleTypCd": "10",
"exchangeItemNm": "블랙>95",
"exchangeItemNo": "001",
"dlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"atchFileInfoList": [
{
"ordNo": "20230808O007404",
"ordSeq": 1,
"ordProcSeq": 1,
"fileSeq": "1",
"filePathNm": "files/order/2023/08/03/",
"fileNm": "d732ec3b-e044-43ca-8ecb-80051b2b36f8_10.png"
}
],
"prestNm": "text",
"wthdYn": "Y",
"ecpnNo": "ORD0001"
}
],
"isAllNonReturnable": true,
"dlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"withdrawDlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"restoreCpnInfo": {
"mbrNo": "100000000",
"ordNo": "20230101O000001",
"restoreGbCd": "10",
"cpnInfo": [
{
"cpnIsuNo": "0000001"
}
],
"cpnIsuNoList": [
"text"
]
},
"firstExchangeItmNm": "text",
"claimGoodsDetailsListClaimQtySum": 1,
"firstGoodsNm": "text",
"firstItmNm": "text",
"expectedRefundAmt": 1,
"firstOrdDtlStatCd": "text",
"simpleChange": true
}Access Token
클레임 상세 내역 조회 요청 DTO
주문번호
20230808O007404클레임번호
20230801C008072성공
클레임 상세 내역 조회 응답 DTO
주문번호
20230809O000001주문구분코드
10회원번호
100001311주문자명
홍길동주문자휴대폰구분번호
010주문자휴대폰국번번호
1234주문자휴대폰끝번호
5678주문자이메일주소
test@plateer.com클레임번호
20231231C000001주문접수일시
주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: 전체회수불필요 여부
업무처리 오류 내용
POST /api/order/v1/claim/common/claimDetailsInfoFO HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 55
{
"ordNo": "20230808O007404",
"claimNo": "20230801C008072"
}{
"ordNo": "20230809O000001",
"ordGbCd": "10",
"mbrNo": "100001311",
"ordManNm": "홍길동",
"ordManCellSctNo": "010",
"ordManCellTxnoNo": "1234",
"ordManCellEndNo": "5678",
"ordManEmailAddr": "test@plateer.com",
"claimNo": "20231231C000001",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordMediaCd": "20",
"claimGoodsDetailsList": [
{
"ordNo": "20231231O000001",
"ordSeq": 1,
"aeOrdSeq": "1",
"ordProcSeq": 1,
"ordProcAccpDtm": "2026-01-01T00:00:00.000Z",
"goodsNo": "10002297",
"itmNo": "001",
"goodsImg": "files/goods/2023/12/31/goodsImg.jpg",
"brandNm": "플래티어",
"goodsNm": "폴로티셔츠",
"itmNm": "화이트>95",
"norPrc": 25000,
"salePrc": 30000,
"goodsTypCd": "10",
"ordQty": 1,
"cnclQty": 0,
"rtnQty": 0,
"claimQty": 0,
"deliNo": "100000001",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문일반",
"ordDtlStatCd": "10",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"deliGbCd": "10",
"claimLgrpCd": "10",
"claimLgrpCdNm": "단순변심",
"claimMgrpCd": "100",
"claimMgrpCdNm": "사이즈가 큼",
"claimCausEtcCont": "사이즈가 생각보다 큽니다.",
"ordSaleTypCd": "10",
"exchangeItemNm": "블랙>95",
"exchangeItemNo": "001",
"dlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"atchFileInfoList": [
{
"ordNo": "20230808O007404",
"ordSeq": 1,
"ordProcSeq": 1,
"fileSeq": "1",
"filePathNm": "files/order/2023/08/03/",
"fileNm": "d732ec3b-e044-43ca-8ecb-80051b2b36f8_10.png"
}
],
"prestNm": "text",
"wthdYn": "Y",
"ecpnNo": "ORD0001"
}
],
"isAllNonReturnable": true,
"dlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"withdrawDlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"restoreCpnInfo": {
"mbrNo": "100000000",
"ordNo": "20230101O000001",
"restoreGbCd": "10",
"cpnInfo": [
{
"cpnIsuNo": "0000001"
}
],
"cpnIsuNoList": [
"text"
]
},
"firstExchangeItmNm": "text",
"claimGoodsDetailsListClaimQtySum": 1,
"firstGoodsNm": "text",
"firstItmNm": "text",
"expectedRefundAmt": 1,
"firstOrdDtlStatCd": "text",
"simpleChange": true
}Access Token
클레임 비용 계산 조회 요청 DTO
주문번호
20230912O058151주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류
11Possible values: SYSTEM(시스템유형) * 10 : FO * 20 : BO
10Possible values: ClaimCalculateWorkType(클레임 혜택/비용처리 업무유형) * 10 : 클레임처리 화면조회 * 20 : 클레임처리 * 30 : 클레임상세내역 화면조회
10Possible values: LO010(배송방법코드) * 10 : 택배배송 * 30 : 매장수령 * 40 : 퀵배송 * 50 : 해외배송 * 60 : 무배송
10Possible values: 현재 클레임 번호
20230912C018562새로 채번된 클레임 번호
20230912C018563반품무료쿠폰 화면선택여부
NPossible values: BO 클레임 비용 계산 조회 성공
클레임 비용 계산 조회 응답 DTO
주문번호
업무처리 오류 내용
POST /api/order/v1/claim/common/claimCalculateCost HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 5684
{
"ordNo": "20230912O058151",
"ordMediaCd": "20",
"claimBusinessType": "11",
"systemType": "10",
"claimCalculateWorkType": "10",
"deliMethodCd": "10",
"orgClmNo": "20230912C018562",
"newNumberedClmNo": "20230912C018563",
"selectedRtnDlvBenefitYn": "N",
"dlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"withdrawalInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"rtnDlvBenefitInfo": {
"promoNo": "C1003841",
"promoNm": "무료반품쿠폰",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "4364872",
"aplyYn": "Y"
},
"claimGoodsList": [
{
"goodsNo": "10002297",
"deliProcTypCd": "10",
"deliPolcNo": "10000151",
"deliNo": "100000021",
"entrNo": "1000002",
"ordQty": 1,
"salePrc": 30000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"ordNo": "20231231O000001",
"ordSeq": 1,
"ordProcSeq": 1,
"uprOrdProcSeq": 1,
"maxOrdProcSeq": 1,
"claimNo": "20231231C000001",
"itmNo": "001",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문일반",
"ordDtlStatCd": "10",
"ordDtlStatCdNm": "접수",
"deliGbCd": "10",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"cnclQty": 0,
"rtnQty": 0,
"claimQty": 0,
"claimPossibleQty": 5,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"exchMidRtnYn": "N",
"rtnPsbYn": "N",
"exchPsbYn": "N",
"ordCnclPsbYn": "N",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"claimLgrpCd": "10",
"claimLgrpCdNm": "단순변심",
"claimMgrpCd": "100",
"claimMgrpCdNm": "사이즈가 큼",
"claimCausEtcCont": "사이즈가 생각보다 큽니다.",
"ordSaleTypCd": "10",
"chlNo": "1000001",
"chlDtlNo": "1000001",
"stdCtgNo": "HT01020000",
"infDispCtgNoGbCd": "10",
"infDispCtgNo": "213",
"repDispCtgNo": "213",
"conrNo": "10050",
"brandNo": "100002",
"brandNm": "플래티어",
"goodsNm": "폴로티셔츠",
"goodsImg": "files/goods/2023/12/31/goodsImg.jpg",
"itmNm": "화이트>95",
"prestNm": "우산 증정",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"taxGbCd": "01",
"buyTypCd": "10",
"supPcost": 14400,
"norPrc": 25000,
"mrgnRate": 4,
"deliDday": 1,
"deliGoodsGbCd": "10",
"deliWayCd": "10",
"bpckPsbYn": "Y",
"hsCd": "0101",
"goodsRevWrtYn": "N",
"bnfAmt": 2000,
"ordPrc": 25000,
"aeGoodsYn": "N",
"withdrawalDeliNo": "100000001",
"shipmentDeliNo": "100000001",
"deliTypCd": "10",
"deliKindCd": "10",
"deliMethodCd": "10",
"deliProcTypCdNm": "업체배송",
"puTypCd": "20",
"wthdFnshGbCd": "10",
"dlvpNm": "자택",
"rcvmnNm": "홍길동",
"dlvpSeq": "1",
"maxDlvpSeq": "1",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "sample@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1122",
"rcvmnCellEndNo": "3546",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "112",
"rcvmnTelEndNo": "3546",
"deliMsg": "부재시 문앞에 두고 가주세요",
"deliMsgCd": "70",
"shopTrafMsg": "없음",
"comnFrdrCogoMethodCd": "10",
"comnFrdrEtcMethod": "없음",
"comnFrdrPwd": "1234",
"orgDlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"orgDeliNo": "100000021",
"lastDeliResponse": {
"ordNo": "text",
"deliNo": "text",
"ordSeq": "text",
"ordProcSeq": "text",
"shipIndiDtm": "2026-01-01T00:00:00.000Z",
"shipCfmDtm": "2026-01-01T00:00:00.000Z",
"shipFnshDtm": "2026-01-01T00:00:00.000Z",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"hdcCd": "text",
"invNo": "text",
"deliDtlStatCd": "text"
},
"shippingDeliGbCd": true,
"opOrdDtlUpdateKey": {
"ordNo": "text",
"ordSeq": 1,
"ordProcSeq": 1,
"uprOrdProcSeq": 1,
"claimNo": "text",
"goodsNo": "text",
"itmNo": "text",
"ordDtlGbCd": "text",
"deliGbCd": "text",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"ordDtlStatCd": "text",
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"deliNo": "text",
"exchMidRtnYn": "text",
"claimLgrpCd": "text",
"claimMgrpCd": "text",
"claimCausEtcCont": "text",
"rtnPsbYn": "text",
"exchPsbYn": "text",
"ordCnclPsbYn": "text",
"wthdYn": "text",
"wthdFnshGbCd": "text",
"shipFnshFcstDtm": "2026-01-01T00:00:00.000Z",
"etcktNo": "text",
"ecpnNo": "text"
},
"generalSalesProduct": true,
"exchangeShipping": true,
"withdrawalDeliGbCd": true,
"withdrawShipping": true,
"ordSeqAndUprOrdProcSeq": "text",
"goodsNoAndItmNo": "text",
"ordSeqAndOrdProcSeq": "text"
}
],
"customerCauseFault": true
}{
"ordNo": "text",
"claimFinalAmtInfo": {
"ordNo": "20230913O058186",
"totAplyAdtnAmt": 6000,
"totCnclAdtnAmt": 0,
"totFvrAdtnAmt": 0,
"totOrdPrc": 46000,
"totDcAmt": 2200,
"expectedRefundAmt": 37800,
"addtionPayAmt": 0,
"returnAcceptAmt": 37800,
"refundAdditionAmtInfoList": [
{
"adtnOcurGbCd": "10",
"adtnOcurGbNm": "발생",
"type": "10",
"typeNm": "회수배송비",
"goodsNoItmNo": "10002762001",
"goodsNm": "상품명",
"ordAmt": 6000,
"discountMethod": "11",
"discountMethodNm": "상품할인쿠폰",
"cnclDcAmt": 2000,
"rtnDlvBenefitInfoList": [
{
"promoNo": "C1003841",
"promoNm": "무료반품쿠폰",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "4364872",
"aplyYn": "Y"
}
],
"reCalAdtnOcurGbCdAdtnAmt": 1
}
],
"refundPaymentMethodList": [
{
"payNo": "2",
"mbrNo": "100000001",
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"uprPayNo": "1",
"payGbCd": "10",
"payGbCdNm": "결제",
"payWayCd": "11",
"payWayCdNm": "신용카드",
"payStatCd": "12",
"payStatCdNm": "결제완료",
"payAmt": 10000,
"taxFreeAmt": 10000,
"rfdPsbAmt": 10000,
"rfdAmt": 1000,
"payFnshDtm": "2026-01-01T00:00:00.000Z",
"trdNo": "INIMX_CARDINIpayTest20990101090000685510",
"trdDtm": "2026-01-01T00:00:00.000Z",
"iscmCd": "202",
"iscmCdNm": "KB국민카드",
"payReqCardcoCd": "06",
"payReqCardcoCdNm": "국민카드",
"cardNo": "카드번호 암호화",
"cardNm": "국민카드",
"cardValiTerm": "text",
"nintDivYn": "N",
"divMonCnt": 0,
"cardPointUseYn": "N",
"mersNo": "1",
"acqrCd": "121",
"acqrCdNm": "국민카드",
"aprvNo": "12345678",
"aprvDtm": "2026-01-01T00:00:00.000Z",
"sctnCnclPsbYn": "Y",
"bankCd": "148",
"bankCdNm": "국민은행",
"actnNo": "계좌번호 암호화",
"dpmnNm": "김플래티어",
"dptFcstDt": "2099-01-01 09:00:00.000000",
"dptCnfmDtm": "2026-01-01T00:00:00.000Z",
"rfdBankCd": "148",
"rfdBankCdNm": "국민은행",
"rfdActnNo": "계좌번호 암호화",
"rfdActnDepositorNm": "홍길동",
"vbankPaymentPending": true,
"vbankDptCnfm": true
}
],
"paymentOrderInfo": {
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"goodsNm": "플래티어커피",
"ordManNm": "김플래티어",
"ordmnCellNo": "01012345678",
"ordmnEmailAddr": "kim@plateer.com",
"crcUnitCd": "KRW",
"ordMediaCd": "30",
"mbrNo": "100000001",
"ordDtlGbCd": "10",
"clientIp": "127.0.0.1",
"taxFreeAmt": 1
},
"rfdInfoResponse": {
"rfdBankCd": "203",
"rfdBankNm": "KB국민은행",
"rfdActnNo": "33330********",
"rfdActnDepositorNm": "임성현",
"rfdActnCertiYn": "Y"
}
},
"restoreCouponInfo": {
"mbrNo": "100000000",
"ordNo": "20230101O000001",
"restoreGbCd": "10",
"cpnInfo": [
{
"cpnIsuNo": "0000001"
}
],
"cpnIsuNoList": [
"text"
]
},
"useCouponInfo": {
"mbrNo": "100000000",
"ordNo": "20230101O000001",
"cpnInfo": [
{
"cpnIsuNo": "0000001"
}
],
"cpnIsuNoList": [
"text"
]
}
}Access Token
클레임 비용 계산 조회 요청 DTO
주문번호
20230912O058151주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문
20Possible values: ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류
11Possible values: SYSTEM(시스템유형) * 10 : FO * 20 : BO
10Possible values: ClaimCalculateWorkType(클레임 혜택/비용처리 업무유형) * 10 : 클레임처리 화면조회 * 20 : 클레임처리 * 30 : 클레임상세내역 화면조회
10Possible values: LO010(배송방법코드) * 10 : 택배배송 * 30 : 매장수령 * 40 : 퀵배송 * 50 : 해외배송 * 60 : 무배송
10Possible values: 현재 클레임 번호
20230912C018562새로 채번된 클레임 번호
20230912C018563반품무료쿠폰 화면선택여부
NPossible values: FO 클레임 비용 계산 조회 성공
클레임 비용 계산 조회 응답 DTO
주문번호
업무처리 오류 내용
POST /api/order/v1/claim/common/claimCalculateCostFO HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 5684
{
"ordNo": "20230912O058151",
"ordMediaCd": "20",
"claimBusinessType": "11",
"systemType": "10",
"claimCalculateWorkType": "10",
"deliMethodCd": "10",
"orgClmNo": "20230912C018562",
"newNumberedClmNo": "20230912C018563",
"selectedRtnDlvBenefitYn": "N",
"dlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"withdrawalInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"rtnDlvBenefitInfo": {
"promoNo": "C1003841",
"promoNm": "무료반품쿠폰",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "4364872",
"aplyYn": "Y"
},
"claimGoodsList": [
{
"goodsNo": "10002297",
"deliProcTypCd": "10",
"deliPolcNo": "10000151",
"deliNo": "100000021",
"entrNo": "1000002",
"ordQty": 1,
"salePrc": 30000,
"dcAmt": 3000,
"sysModDtm": "2026-01-01T00:00:00.000Z",
"ordNo": "20231231O000001",
"ordSeq": 1,
"ordProcSeq": 1,
"uprOrdProcSeq": 1,
"maxOrdProcSeq": 1,
"claimNo": "20231231C000001",
"itmNo": "001",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문일반",
"ordDtlStatCd": "10",
"ordDtlStatCdNm": "접수",
"deliGbCd": "10",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"cnclQty": 0,
"rtnQty": 0,
"claimQty": 0,
"claimPossibleQty": 5,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"exchMidRtnYn": "N",
"rtnPsbYn": "N",
"exchPsbYn": "N",
"ordCnclPsbYn": "N",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"claimLgrpCd": "10",
"claimLgrpCdNm": "단순변심",
"claimMgrpCd": "100",
"claimMgrpCdNm": "사이즈가 큼",
"claimCausEtcCont": "사이즈가 생각보다 큽니다.",
"ordSaleTypCd": "10",
"chlNo": "1000001",
"chlDtlNo": "1000001",
"stdCtgNo": "HT01020000",
"infDispCtgNoGbCd": "10",
"infDispCtgNo": "213",
"repDispCtgNo": "213",
"conrNo": "10050",
"brandNo": "100002",
"brandNm": "플래티어",
"goodsNm": "폴로티셔츠",
"goodsImg": "files/goods/2023/12/31/goodsImg.jpg",
"itmNm": "화이트>95",
"prestNm": "우산 증정",
"goodsCompCd": "10",
"goodsTypCd": "10",
"saleMethCd": "10",
"taxGbCd": "01",
"buyTypCd": "10",
"supPcost": 14400,
"norPrc": 25000,
"mrgnRate": 4,
"deliDday": 1,
"deliGoodsGbCd": "10",
"deliWayCd": "10",
"bpckPsbYn": "Y",
"hsCd": "0101",
"goodsRevWrtYn": "N",
"bnfAmt": 2000,
"ordPrc": 25000,
"aeGoodsYn": "N",
"withdrawalDeliNo": "100000001",
"shipmentDeliNo": "100000001",
"deliTypCd": "10",
"deliKindCd": "10",
"deliMethodCd": "10",
"deliProcTypCdNm": "업체배송",
"puTypCd": "20",
"wthdFnshGbCd": "10",
"dlvpNm": "자택",
"rcvmnNm": "홍길동",
"dlvpSeq": "1",
"maxDlvpSeq": "1",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "sample@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1122",
"rcvmnCellEndNo": "3546",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "112",
"rcvmnTelEndNo": "3546",
"deliMsg": "부재시 문앞에 두고 가주세요",
"deliMsgCd": "70",
"shopTrafMsg": "없음",
"comnFrdrCogoMethodCd": "10",
"comnFrdrEtcMethod": "없음",
"comnFrdrPwd": "1234",
"orgDlvpInfo": {
"mbrOrdDlvpGb": "10",
"dlvpSeq": "1",
"zipNoSeq": 1,
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNo": "05836",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnEmailAddr": "x2bee@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "123",
"rcvmnTelEndNo": "4567",
"deliMsg": "부재 시 문 앞에 놓아주세요.",
"deliMsgCd": "30",
"shopTrafMsg": "문 앞에 놓아주세요.",
"comnFrdrCogoMethodCd": "20",
"comnFrdrEtcMethod": "자유 출입 가능",
"comnFrdrPwd": "1234"
},
"orgDeliNo": "100000021",
"lastDeliResponse": {
"ordNo": "text",
"deliNo": "text",
"ordSeq": "text",
"ordProcSeq": "text",
"shipIndiDtm": "2026-01-01T00:00:00.000Z",
"shipCfmDtm": "2026-01-01T00:00:00.000Z",
"shipFnshDtm": "2026-01-01T00:00:00.000Z",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"hdcCd": "text",
"invNo": "text",
"deliDtlStatCd": "text"
},
"shippingDeliGbCd": true,
"opOrdDtlUpdateKey": {
"ordNo": "text",
"ordSeq": 1,
"ordProcSeq": 1,
"uprOrdProcSeq": 1,
"claimNo": "text",
"goodsNo": "text",
"itmNo": "text",
"ordDtlGbCd": "text",
"deliGbCd": "text",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"ordDtlStatCd": "text",
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"deliNo": "text",
"exchMidRtnYn": "text",
"claimLgrpCd": "text",
"claimMgrpCd": "text",
"claimCausEtcCont": "text",
"rtnPsbYn": "text",
"exchPsbYn": "text",
"ordCnclPsbYn": "text",
"wthdYn": "text",
"wthdFnshGbCd": "text",
"shipFnshFcstDtm": "2026-01-01T00:00:00.000Z",
"etcktNo": "text",
"ecpnNo": "text"
},
"generalSalesProduct": true,
"exchangeShipping": true,
"withdrawalDeliGbCd": true,
"withdrawShipping": true,
"ordSeqAndUprOrdProcSeq": "text",
"goodsNoAndItmNo": "text",
"ordSeqAndOrdProcSeq": "text"
}
],
"customerCauseFault": true
}{
"ordNo": "text",
"claimFinalAmtInfo": {
"ordNo": "20230913O058186",
"totAplyAdtnAmt": 6000,
"totCnclAdtnAmt": 0,
"totFvrAdtnAmt": 0,
"totOrdPrc": 46000,
"totDcAmt": 2200,
"expectedRefundAmt": 37800,
"addtionPayAmt": 0,
"returnAcceptAmt": 37800,
"refundAdditionAmtInfoList": [
{
"adtnOcurGbCd": "10",
"adtnOcurGbNm": "발생",
"type": "10",
"typeNm": "회수배송비",
"goodsNoItmNo": "10002762001",
"goodsNm": "상품명",
"ordAmt": 6000,
"discountMethod": "11",
"discountMethodNm": "상품할인쿠폰",
"cnclDcAmt": 2000,
"rtnDlvBenefitInfoList": [
{
"promoNo": "C1003841",
"promoNm": "무료반품쿠폰",
"promoTypCd": "11",
"ourChrgRate": 100,
"entrChrgRate": 0,
"cpnIsuNo": "4364872",
"aplyYn": "Y"
}
],
"reCalAdtnOcurGbCdAdtnAmt": 1
}
],
"refundPaymentMethodList": [
{
"payNo": "2",
"mbrNo": "100000001",
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"uprPayNo": "1",
"payGbCd": "10",
"payGbCdNm": "결제",
"payWayCd": "11",
"payWayCdNm": "신용카드",
"payStatCd": "12",
"payStatCdNm": "결제완료",
"payAmt": 10000,
"taxFreeAmt": 10000,
"rfdPsbAmt": 10000,
"rfdAmt": 1000,
"payFnshDtm": "2026-01-01T00:00:00.000Z",
"trdNo": "INIMX_CARDINIpayTest20990101090000685510",
"trdDtm": "2026-01-01T00:00:00.000Z",
"iscmCd": "202",
"iscmCdNm": "KB국민카드",
"payReqCardcoCd": "06",
"payReqCardcoCdNm": "국민카드",
"cardNo": "카드번호 암호화",
"cardNm": "국민카드",
"cardValiTerm": "text",
"nintDivYn": "N",
"divMonCnt": 0,
"cardPointUseYn": "N",
"mersNo": "1",
"acqrCd": "121",
"acqrCdNm": "국민카드",
"aprvNo": "12345678",
"aprvDtm": "2026-01-01T00:00:00.000Z",
"sctnCnclPsbYn": "Y",
"bankCd": "148",
"bankCdNm": "국민은행",
"actnNo": "계좌번호 암호화",
"dpmnNm": "김플래티어",
"dptFcstDt": "2099-01-01 09:00:00.000000",
"dptCnfmDtm": "2026-01-01T00:00:00.000Z",
"rfdBankCd": "148",
"rfdBankCdNm": "국민은행",
"rfdActnNo": "계좌번호 암호화",
"rfdActnDepositorNm": "홍길동",
"vbankPaymentPending": true,
"vbankDptCnfm": true
}
],
"paymentOrderInfo": {
"ordNo": "20990101O000001",
"claimNo": "20990101C000001",
"goodsNm": "플래티어커피",
"ordManNm": "김플래티어",
"ordmnCellNo": "01012345678",
"ordmnEmailAddr": "kim@plateer.com",
"crcUnitCd": "KRW",
"ordMediaCd": "30",
"mbrNo": "100000001",
"ordDtlGbCd": "10",
"clientIp": "127.0.0.1",
"taxFreeAmt": 1
},
"rfdInfoResponse": {
"rfdBankCd": "203",
"rfdBankNm": "KB국민은행",
"rfdActnNo": "33330********",
"rfdActnDepositorNm": "임성현",
"rfdActnCertiYn": "Y"
}
},
"restoreCouponInfo": {
"mbrNo": "100000000",
"ordNo": "20230101O000001",
"restoreGbCd": "10",
"cpnInfo": [
{
"cpnIsuNo": "0000001"
}
],
"cpnIsuNoList": [
"text"
]
},
"useCouponInfo": {
"mbrNo": "100000000",
"ordNo": "20230101O000001",
"cpnInfo": [
{
"cpnIsuNo": "0000001"
}
],
"cpnIsuNoList": [
"text"
]
}
}Access Token
성공
추가결제정보 DTO
업무처리 오류 내용
POST /api/order/v1/claim/common/additionalFeePaymentInfo HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*
{
"mainPayMethodInfoList": [
{
"payWayCd": "11",
"useYn": "Y",
"langCd": "ko",
"cdNm": "text",
"cdDesc": "text",
"pgGbCd": "text",
"memberSubPaymethodAmount": 1,
"cardCompanyList": [
{
"cd": "302",
"cdNm": "색상변경",
"cdDesc": "[단순변심]",
"sortSeq": "22",
"ref1Val": "30",
"ref2Val": "10",
"ref3Val": "10",
"ref4Val": "10",
"ref5Val": "Y",
"ref6Val": "null",
"ref7Val": "null"
}
],
"mainPaymethod": true
}
],
"subPayMethodInfoList": [
{
"payWayCd": "11",
"useYn": "Y",
"langCd": "ko",
"cdNm": "text",
"cdDesc": "text",
"pgGbCd": "text",
"memberSubPaymethodAmount": 1,
"cardCompanyList": [
{
"cd": "302",
"cdNm": "색상변경",
"cdDesc": "[단순변심]",
"sortSeq": "22",
"ref1Val": "30",
"ref2Val": "10",
"ref3Val": "10",
"ref4Val": "10",
"ref5Val": "Y",
"ref6Val": "null",
"ref7Val": "null"
}
],
"mainPaymethod": true
}
]
}Access Token
성공
환불 계좌정보 조회 Response
은행코드 (OM026)
203은행명
KB국민은행환불계좌번호
33330********환불 계좌 예금주명
임성현환불 계좌 인증여부
Y업무처리 오류 내용
GET /api/order/v1/claim/common/getNonMemberRefundActnInfo?request=[object+Object] HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*
{
"rfdBankCd": "203",
"rfdBankNm": "KB국민은행",
"rfdActnNo": "33330********",
"rfdActnDepositorNm": "임성현",
"rfdActnCertiYn": "Y"
}마지막 업데이트