클레임공통

클레임 배송비 결제 처리

post

기능 설명

• 결제대기 상태의 클레임에 대해 배송비 추가결제를 진행하고 주문내역상태를 수정합니다.

---

상세 설명

• 주문 번호(ordNo), **클레임번호(claimNo)**는 필수로 있어야합니다.

• 대상 클레임이 결제대기상태를 접수할 수 있는 상태인지 체크합니다.

  • **주문내역구분코드(OM003)**가 반품(20), **교환(30)**인지 확인

  • **주문내역상태코드(OM005)**가 **결제대기(31)**인지 확인

• 대상 클레임 반품보류이면 주문내역상태를 회수완료(36)로, 반품보류가 아닌 반품 또는 교환일 경우 주문내역상태를 접수(32)로 수정합니다.

• 대상 클레임 배송비의 결제승인정보를 저장 처리합니다.

---

수정번호

• release_231106_01 : 반품보류 주문 배송비 추가결제 후 주문내역상태 수정

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

클레임 처리 요청 DTO

systemTypestring · enumRequired

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:

claimBusinessTypestring · enumRequired

ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류

Example: 11Possible values:

ordMediaCdstring · enumRequired

주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문

Example: 20Possible values:

ordNostringRequired

주문번호

Example: 20230808O007404

mbrNostringOptional

회원번호

Example: 100001311

claimNostringRequired

클레임번호

Example: 20230808C010663

wthdFnshWaitProcCausstringRequired

회수완료 대기처리 사유

Example: 불량반품

claimBusinessstring · enumOptional

ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/claim/fee/deliveryFeePayment

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/fee/deliveryFeePayment HTTP/1.1
Host: localhost:8092/
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": "[e-mail]",
      "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": "[e-mail]",
    "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": "[e-mail]",
    "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-02-27T18:08:20.084Z",
        "trdNo": "INIMX_CARDINIpayTest20990101090000685510",
        "trdDtm": "2026-02-27T18:08:20.084Z",
        "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-02-27T18:08:20.084Z",
        "sctnCnclPsbYn": "Y",
        "bankCd": "148",
        "bankCdNm": "국민은행",
        "actnNo": "계좌번호 암호화",
        "dpmnNm": "김플래티어",
        "dptFcstDt": "2099-01-01 09:00:00.000000",
        "dptCnfmDtm": "2026-02-27T18:08:20.084Z",
        "rfdBankCd": "148",
        "rfdBankCdNm": "국민은행",
        "rfdActnNo": "계좌번호 암호화",
        "rfdActnDepositorNm": "홍길동",
        "vbankDptCnfm": true,
        "vbankPaymentPending": true
      }
    ],
    "paymentOrderInfo": {
      "ordNo": "20990101O000001",
      "claimNo": "20990101C000001",
      "goodsNm": "플래티어커피",
      "ordManNm": "김플래티어",
      "ordmnCellNo": "01012345678",
      "ordmnEmailAddr": "[e-mail]",
      "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

No content

비회원 주문 환불 계좌 정보 수정(BO)

post

기능설명

• 주문번호 기준으로 비회원 주문 환불 계좌 정보를 업데이트합니다.

---

상세설명

---

특이사항

• 예금주명은 주문자명과 일치해야합니다.

• 필수 값 목록

  • 주문번호

  • 주문자명

  • 환불은행코드

  • 환불계좌번호

  • 환불예금주

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

환불접수등록 Request DTO

ordNostringOptional

주문번호

mbrNostringRequired

회원번호

mbrNmstringRequired

회원명

loginIdstringRequired

로그인ID

rfdTypCdstringRequired

환불유형코드(OM023)

rfdPrgsStatCdstringRequired

환불진행상태코드(OM024)

rfdBankCdstringRequired

환불은행코드(OM026)

rfdActnNostringRequired

환불계좌번호

rfdActnDepositorNmstringRequired

환불예금주

rfdCausCdstringRequired

환불사유코드(OM025)

rfdActnCertiYnstringRequired

환불계좌인증여부

rfdAmtinteger · int64Required

환불금액

rfdCmsnAmtinteger · int64Required

환불수수료금액

acptmnIdstringRequired

접수자ID

rfdSmsSndYnstringRequired

환불SMS발송여부

Responses

200

성공

*/*

stringOptional

900

업무처리 오류 내용

*/*

post

/v1/claim/common/saveNonMemberRefundActn

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/saveNonMemberRefundActn HTTP/1.1
Host: localhost:8092/
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"
}

text

비회원 주문 환불 계좌 정보 수정

post

기능설명

• 주문번호 기준으로 비회원 주문 환불 계좌 정보를 업데이트합니다.

---

상세설명

---

특이사항

• 예금주명은 주문자명과 일치해야합니다.

• 필수 값 목록

  • 주문번호

  • 주문자명

  • 환불은행코드

  • 환불계좌번호

  • 환불예금주

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

환불접수등록 Request DTO

ordNostringOptional

주문번호

mbrNostringRequired

회원번호

mbrNmstringRequired

회원명

loginIdstringRequired

로그인ID

rfdTypCdstringRequired

환불유형코드(OM023)

rfdPrgsStatCdstringRequired

환불진행상태코드(OM024)

rfdBankCdstringRequired

환불은행코드(OM026)

rfdActnNostringRequired

환불계좌번호

rfdActnDepositorNmstringRequired

환불예금주

rfdCausCdstringRequired

환불사유코드(OM025)

rfdActnCertiYnstringRequired

환불계좌인증여부

rfdAmtinteger · int64Required

환불금액

rfdCmsnAmtinteger · int64Required

환불수수료금액

acptmnIdstringRequired

접수자ID

rfdSmsSndYnstringRequired

환불SMS발송여부

Responses

200

성공

*/*

stringOptional

900

업무처리 오류 내용

*/*

post

/v1/claim/common/saveNonMemberRefundActnFO

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/saveNonMemberRefundActnFO HTTP/1.1
Host: localhost:8092/
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"
}

text

반품/교환 철회대상 조회(BO)

post

기능 설명

• BO에서 반품/교환 철회대상을 조회합니다.

---

상세 설명

• 주문 번호(ordNo), **시스템 유형(systemType)**은 필수로 있어야합니다.

• 다음의 조건을 모두 충족하는 대상에 대해 반품/교환 철회 처리가 가능합니다.

  • 주문내역구분(OM003) 값이 반품(20) 이거나 **교환(30)**인 경우

  • 주문내역상태(OM005) 값이 결제대기(31), 반품/교환접수(32), **회수지시(32)**인 경우

  • 반품 가능여부(rtnPsbYn) 값이 Y 인 경우

  • 일반 상품인 경우**(사은품 제외)**

  • 철회 가능 수량이 1개 이상인 경우 ( 주문수량 – 취소수량 – 반품수량 > 0 )

---

수정 번호

• Release v2.00_240729 : 회수여부(wthdYn) 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

클레임 가능 대상 조회 요청 DTO

ordNostringRequired

주문번호

Example: 20230808O007404

claimBusinessTypestring · enumOptional

ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류

Example: 11Possible values:

orgClmNostringOptional

원클레임 번호

Example: 20230808C010663

systemTypestring · enumRequired

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Default: 20Example: 10Possible values:

dlvpSeqstringOptional

배송지순번

Example: 1

claimBusinessstring · enumOptional

ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류

Example: 11Possible values:

systemstring · enumOptional

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:

systemCdNmAndButtonCodestringOptional

Responses

200

성공

*/*

클레임 처리대상 응답 DTO

ordNostringOptional

주문번호

Example: 20231231O000001

mbrNostringOptional

회원번호

Example: 100001311

mbrGradeCdstring · enumOptional

회원등급코드(ME008) 10 : GREEN , 20 : FAMILY , 30 : GOLD , 40 : VIP , 50 : VVIP

Example: 10Possible values:

ordGbCdstring · enumOptional

OM002(주문 구분 코드) 10: 일반주문 , 20: 선물하기 , 30: e-쿠폰 , 40: 제휴

Example: 10Possible values:

mbrMgrCdstring · enumOptional

ME002(회원관리코드) 10: UNION_MEMBER(통합회원) ,20: GENERAL_MEMBER(일반회원) ,30: SOCIAL_MEMBER(소셜회원) ,99: NO_MEMBER(비회원)

Example: 10Possible values:

ordManNmstringOptional

주문자명

Example: 홍길동

ordManEmailAddrstringOptional

주문자이메일주소

Example: [e-mail]

ordManCellSctNostringOptional

주문자휴대폰구분번호

Example: 010

ordManCellTxnoNostringOptional

주문자휴대폰국번번호

Example: 1234

ordManCellEndNostringOptional

주문자휴대폰끝번호

Example: 5678

ordMediaCdstring · enumOptional

주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문

Example: 20Possible values:

ordAccpDtmstring · date-timeOptional

주문접수일자

sctnCnclPsbYnstring · enumOptional

부분취소가능여부

Example: NPossible values:

allNonReturnablebooleanOptional

vbankPaymentPendingbooleanOptional

allEcouponbooleanOptional

900

업무처리 오류 내용

*/*

post

/v1/claim/common/getReturnExchangeCancelTargetInfo

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/getReturnExchangeCancelTargetInfo HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 181

{
  "ordNo": "20230808O007404",
  "claimBusinessType": "11",
  "orgClmNo": "20230808C010663",
  "systemType": "10",
  "dlvpSeq": "1",
  "claimBusiness": "11",
  "system": "10",
  "systemCdNmAndButtonCode": "text"
}

{
  "ordNo": "20231231O000001",
  "mbrNo": "100001311",
  "mbrGradeCd": "10",
  "ordGbCd": "10",
  "mbrMgrCd": "10",
  "ordManNm": "홍길동",
  "ordManEmailAddr": "[e-mail]",
  "ordManCellSctNo": "010",
  "ordManCellTxnoNo": "1234",
  "ordManCellEndNo": "5678",
  "ordMediaCd": "20",
  "ordAccpDtm": "2026-02-27T18:08:20.084Z",
  "sctnCnclPsbYn": "N",
  "claimTargetGoodsResponseList": [
    {
      "goodsNo": "10002297",
      "deliProcTypCd": "10",
      "deliPolcNo": "10000151",
      "deliNo": "100000021",
      "entrNo": "1000002",
      "ordQty": 1,
      "salePrc": 30000,
      "dcAmt": 3000,
      "sysModDtm": "2026-02-27T18:08:20.084Z",
      "ordNo": "20231231O000001",
      "ordSeq": 1,
      "ordProcSeq": 1,
      "uprOrdProcSeq": 1,
      "maxOrdProcSeq": 1,
      "claimNo": "20231231C000001",
      "itmNo": "001",
      "ordDtlGbCd": "10",
      "ordDtlGbCdNm": "주문일반",
      "ordDtlStatCd": "10",
      "ordDtlStatCdNm": "접수",
      "deliGbCd": "10",
      "ordAccpDtm": "2026-02-27T18:08:20.084Z",
      "ordFnshDtm": "2026-02-27T18:08:20.084Z",
      "cnclQty": 0,
      "rtnQty": 0,
      "claimQty": 0,
      "claimPossibleQty": 5,
      "deliIndiDtm": "2026-02-27T18:08:20.084Z",
      "deliIndiRsvDtm": "2026-02-27T18:08:20.084Z",
      "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": "[e-mail]",
      "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": "[e-mail]",
        "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-02-27T18:08:20.084Z",
        "shipCfmDtm": "2026-02-27T18:08:20.084Z",
        "shipFnshDtm": "2026-02-27T18:08:20.084Z",
        "deliFnshDtm": "2026-02-27T18:08:20.084Z",
        "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-02-27T18:08:20.084Z",
        "ordFnshDtm": "2026-02-27T18:08:20.084Z",
        "ordDtlStatCd": "text",
        "ordQty": 1,
        "cnclQty": 1,
        "rtnQty": 1,
        "deliIndiDtm": "2026-02-27T18:08:20.084Z",
        "deliIndiRsvDtm": "2026-02-27T18:08:20.084Z",
        "deliNo": "text",
        "exchMidRtnYn": "text",
        "claimLgrpCd": "text",
        "claimMgrpCd": "text",
        "claimCausEtcCont": "text",
        "rtnPsbYn": "text",
        "exchPsbYn": "text",
        "ordCnclPsbYn": "text",
        "wthdYn": "text",
        "wthdFnshGbCd": "text",
        "shipFnshFcstDtm": "2026-02-27T18:08:20.084Z",
        "etcktNo": "text",
        "ecpnNo": "text"
      },
      "generalSalesProduct": true,
      "exchangeShipping": true,
      "ordSeqAndOrdProcSeq": "text",
      "goodsNoAndItmNo": "text",
      "withdrawShipping": true,
      "withdrawalDeliGbCd": true,
      "ordSeqAndUprOrdProcSeq": "text"
    }
  ],
  "allNonReturnable": true,
  "vbankPaymentPending": true,
  "allEcoupon": true
}

배송 번호 채번 처리

post

기능 설명

• 배송 번호 채번 목록 조회합니다.

---

상세 설명

• 요청 **배송번호 리스트(dlvpList)**는 필수로 있어야합니다.

• 요청하는 **배송번호 리스트(dlvpList)**의 수에 따라 배송번호를 채번합니다.

• 배송번호 채번 완료 후 채번한 배송번호 목록을 전달합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

클레임 배송번호 요청 DTO

dlvpListstring[]Required

배송번호 리스트

Example: shipment

Responses

200

성공

*/*

string[]Optional

900

업무처리 오류 내용

*/*

post

/v1/claim/common/getNewNumberedDeliNo

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/getNewNumberedDeliNo HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "dlvpList": "shipment"
}

[
  "text"
]

클레임 배송비 결제대기상태 대상 정보

post

기능 설명

• FO에서 클레임 배송비 결제대기상태 대상 정보를 조회합니다.

---

상세 설명

• 주문 번호(ordNo), **클레임번호(claimNo)**는 필수로 있어야합니다.

• 대상 클레임의 추가배송비를 조회합니다.

• 대상 클레임의 상품목록을 조회합니다.

  • 주문내역구분(OM003) 값이 반품(20) 이거나 **교환(30)**인 경우

  • 주문내역상태(OM005) 값이 **결제대기(31)**인 경우

  • 반품 가능여부(rtnPsbYn) 값이 Y 인 경우

  • 대상 클레임 수량이 1개 이상인 경우 ( 주문수량 – 취소수량 – 반품수량 > 0 )

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

클레임 상세 내역 조회 요청 DTO

ordNostringRequired

주문번호

Example: 20230808O007404

claimNostringRequired

클레임번호

Example: 20230801C008072

Responses

200

성공

*/*

클레임 배송비 결제대기상태 대상 응답 DTO

ordNostringOptional

주문번호

Example: 20230808O007404

ordAccpDtmstring · date-timeOptional

주문접수일자

deliAmtSuminteger · int64Optional

배송비합계

Example: 3000

totAplyAdtnAmtinteger · int64Optional

추가비용합계

Example: 3000

addtionPayAmtinteger · int64Optional

추가금액

Example: 3000

foSystemNmAndDeliveryButtonCodestringOptional

900

업무처리 오류 내용

*/*

post

/v1/claim/common/getClaimPayWaitStateInfo

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/getClaimPayWaitStateInfo HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "ordNo": "20230808O007404",
  "claimNo": "20230801C008072"
}

{
  "ordNo": "20230808O007404",
  "ordAccpDtm": "2026-02-27T18:08:20.084Z",
  "deliAmtSum": 3000,
  "totAplyAdtnAmt": 3000,
  "addtionPayAmt": 3000,
  "claimTargetResponse": {
    "ordNo": "20231231O000001",
    "mbrNo": "100001311",
    "mbrGradeCd": "10",
    "ordGbCd": "10",
    "mbrMgrCd": "10",
    "ordManNm": "홍길동",
    "ordManEmailAddr": "[e-mail]",
    "ordManCellSctNo": "010",
    "ordManCellTxnoNo": "1234",
    "ordManCellEndNo": "5678",
    "ordMediaCd": "20",
    "ordAccpDtm": "2026-02-27T18:08:20.084Z",
    "sctnCnclPsbYn": "N",
    "claimTargetGoodsResponseList": [
      {
        "goodsNo": "10002297",
        "deliProcTypCd": "10",
        "deliPolcNo": "10000151",
        "deliNo": "100000021",
        "entrNo": "1000002",
        "ordQty": 1,
        "salePrc": 30000,
        "dcAmt": 3000,
        "sysModDtm": "2026-02-27T18:08:20.084Z",
        "ordNo": "20231231O000001",
        "ordSeq": 1,
        "ordProcSeq": 1,
        "uprOrdProcSeq": 1,
        "maxOrdProcSeq": 1,
        "claimNo": "20231231C000001",
        "itmNo": "001",
        "ordDtlGbCd": "10",
        "ordDtlGbCdNm": "주문일반",
        "ordDtlStatCd": "10",
        "ordDtlStatCdNm": "접수",
        "deliGbCd": "10",
        "ordAccpDtm": "2026-02-27T18:08:20.084Z",
        "ordFnshDtm": "2026-02-27T18:08:20.084Z",
        "cnclQty": 0,
        "rtnQty": 0,
        "claimQty": 0,
        "claimPossibleQty": 5,
        "deliIndiDtm": "2026-02-27T18:08:20.084Z",
        "deliIndiRsvDtm": "2026-02-27T18:08:20.084Z",
        "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": "[e-mail]",
        "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": "[e-mail]",
          "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-02-27T18:08:20.084Z",
          "shipCfmDtm": "2026-02-27T18:08:20.084Z",
          "shipFnshDtm": "2026-02-27T18:08:20.084Z",
          "deliFnshDtm": "2026-02-27T18:08:20.084Z",
          "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-02-27T18:08:20.084Z",
          "ordFnshDtm": "2026-02-27T18:08:20.084Z",
          "ordDtlStatCd": "text",
          "ordQty": 1,
          "cnclQty": 1,
          "rtnQty": 1,
          "deliIndiDtm": "2026-02-27T18:08:20.084Z",
          "deliIndiRsvDtm": "2026-02-27T18:08:20.084Z",
          "deliNo": "text",
          "exchMidRtnYn": "text",
          "claimLgrpCd": "text",
          "claimMgrpCd": "text",
          "claimCausEtcCont": "text",
          "rtnPsbYn": "text",
          "exchPsbYn": "text",
          "ordCnclPsbYn": "text",
          "wthdYn": "text",
          "wthdFnshGbCd": "text",
          "shipFnshFcstDtm": "2026-02-27T18:08:20.084Z",
          "etcktNo": "text",
          "ecpnNo": "text"
        },
        "generalSalesProduct": true,
        "exchangeShipping": true,
        "ordSeqAndOrdProcSeq": "text",
        "goodsNoAndItmNo": "text",
        "withdrawShipping": true,
        "withdrawalDeliGbCd": true,
        "ordSeqAndUprOrdProcSeq": "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"
}

이미지 업로드 처리

post

기능 설명

• 이미지 S3 업로드 처리합니다.

---

상세 설명

• 시스템 유형(systemType), 주문 번호(ordNo), **업로드 파일(MultipartHttpServletRequest)**은 필수로 있어야합니다.

• 클레임 중분류가 상품불량일 경우에만 처리합니다.

• **첨부파일업로드모듈(AttacheFileKind)**에 따라 업로드 경로 설정됩니다.

• 업로드 완료 시 주문번호, 주문순번, 주문처리순번, 파일URL, 파일명이 포함된 **주문상세첨부파일정보(PrOrdDtlAtchFileInfo)**를 전달합니다.

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

주문상세첨부파일정보 DTO

ordNostringOptional

주문번호

Example: 20230808O007404

ordSeqinteger · int32Optional

주문순번

Example: 1

ordProcSeqinteger · int32Optional

주문처리순번

Example: 1

fileSeqstringOptional

파일순번

Example: 1

filePathNmstringOptional

파일경로

Example: files/order/2023/08/03/

fileNmstringOptional

파일명

Example: d732ec3b-e044-43ca-8ecb-80051b2b36f8_10.png

900

업무처리 오류 내용

*/*

post

/v1/claim/common/claimImgUpload

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/claimImgUpload?claimImgRequest=[object+Object]&userDetail=[object+Object] HTTP/1.1
Host: localhost:8092/
Accept: */*

[
  {
    "ordNo": "20230808O007404",
    "ordSeq": 1,
    "ordProcSeq": 1,
    "fileSeq": "1",
    "filePathNm": "files/order/2023/08/03/",
    "fileNm": "d732ec3b-e044-43ca-8ecb-80051b2b36f8_10.png"
  }
]

클레임 상세 내역 조회(B0)

post

기능설명

• 클레임 상세 내역을 조회합니다.

---

상세설명

• **주문번호(ordNo), 클레임번호(claimNo)**는 필수 파라미터입니다.

• 요청 주문번호, 클레임번호에 해당하는 클레임 상세 내역을 제공합니다.

• 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지정보를 제공합니다.

---

수정번호

• Release v2.00_240711 : 배송 지역그룹 별 추가 배송비 적용

• Release v2.00_240729 : 회수여부(wthdYn), 상품유형코드(goodsTypCd), 쿠폰번호(ecpnNo) 추가

• Release v2.00_250818 : 교환 완료 후 반품 시 상위 결제 정보 메핑 변경

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

클레임 상세 내역 조회 요청 DTO

ordNostringRequired

주문번호

Example: 20230808O007404

claimNostringRequired

클레임번호

Example: 20230801C008072

Responses

200

성공

*/*

클레임 상세 내역 조회 응답 DTO

ordNostringOptional

주문번호

Example: 20230809O000001

ordGbCdstringOptional

주문구분코드

Example: 10

mbrNostringOptional

회원번호

Example: 100001311

ordManNmstringOptional

주문자명

Example: 홍길동

ordManCellSctNostringOptional

주문자휴대폰구분번호

Example: 010

ordManCellTxnoNostringOptional

주문자휴대폰국번번호

Example: 1234

ordManCellEndNostringOptional

주문자휴대폰끝번호

Example: 5678

ordManEmailAddrstringOptional

주문자이메일주소

Example: [e-mail]

claimNostringOptional

클레임번호

Example: 20231231C000001

ordAccpDtmstring · date-timeOptional

주문접수일시

ordMediaCdstring · enumOptional

주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문

Example: 20Possible values:

isAllNonReturnablebooleanOptional

전체회수불필요 여부

claimGoodsDetailsListClaimQtySuminteger · int32Optional

firstItmNmstringOptional

firstGoodsNmstringOptional

firstExchangeItmNmstringOptional

expectedRefundAmtinteger · int64Optional

firstOrdDtlStatCdstringOptional

simpleChangebooleanOptional

900

업무처리 오류 내용

*/*

post

/v1/claim/common/claimDetailsInfo

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/claimDetailsInfo HTTP/1.1
Host: localhost:8092/
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": "[e-mail]",
  "claimNo": "20231231C000001",
  "ordAccpDtm": "2026-02-27T18:08:20.084Z",
  "ordMediaCd": "20",
  "claimGoodsDetailsList": [
    {
      "ordNo": "20231231O000001",
      "ordSeq": 1,
      "aeOrdSeq": "1",
      "ordProcSeq": 1,
      "ordProcAccpDtm": "2026-02-27T18:08:20.084Z",
      "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-02-27T18:08:20.084Z",
      "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": "[e-mail]",
        "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": "[e-mail]",
    "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": "[e-mail]",
    "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"
    ]
  },
  "claimGoodsDetailsListClaimQtySum": 1,
  "firstItmNm": "text",
  "firstGoodsNm": "text",
  "firstExchangeItmNm": "text",
  "expectedRefundAmt": 1,
  "firstOrdDtlStatCd": "text",
  "simpleChange": true
}

클레임 상세 내역 조회(FO)

post

기능설명

• 클레임 상세 내역을 조회합니다.

---

상세설명

• **주문번호(ordNo), 클레임번호(claimNo)**는 필수 파라미터입니다.

• 요청 주문번호, 클레임번호에 해당하는 클레임 상세 내역을 제공합니다.

• 주문 내역 정보, 클레임 상품 정보, 환불/결제 내역, 환불예정쿠폰, 배송지정보를 제공합니다.

---

수정번호

• Release 2.00_240401: 주문구분코드 추가, 증정품명 추가

• Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가

• Release v2.00_240711 : 배송 지역그룹 별 추가 배송비 적용

• Release v2.00_240729 : 회수여부(wthdYn), 상품유형코드(goodsTypCd), 쿠폰번호(ecpnNo) 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

클레임 상세 내역 조회 요청 DTO

ordNostringRequired

주문번호

Example: 20230808O007404

claimNostringRequired

클레임번호

Example: 20230801C008072

Responses

200

성공

*/*

클레임 상세 내역 조회 응답 DTO

ordNostringOptional

주문번호

Example: 20230809O000001

ordGbCdstringOptional

주문구분코드

Example: 10

mbrNostringOptional

회원번호

Example: 100001311

ordManNmstringOptional

주문자명

Example: 홍길동

ordManCellSctNostringOptional

주문자휴대폰구분번호

Example: 010

ordManCellTxnoNostringOptional

주문자휴대폰국번번호

Example: 1234

ordManCellEndNostringOptional

주문자휴대폰끝번호

Example: 5678

ordManEmailAddrstringOptional

주문자이메일주소

Example: [e-mail]

claimNostringOptional

클레임번호

Example: 20231231C000001

ordAccpDtmstring · date-timeOptional

주문접수일시

ordMediaCdstring · enumOptional

주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문

Example: 20Possible values:

isAllNonReturnablebooleanOptional

전체회수불필요 여부

claimGoodsDetailsListClaimQtySuminteger · int32Optional

firstItmNmstringOptional

firstGoodsNmstringOptional

firstExchangeItmNmstringOptional

expectedRefundAmtinteger · int64Optional

firstOrdDtlStatCdstringOptional

simpleChangebooleanOptional

900

업무처리 오류 내용

*/*

post

/v1/claim/common/claimDetailsInfoFO

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/claimDetailsInfoFO HTTP/1.1
Host: localhost:8092/
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": "[e-mail]",
  "claimNo": "20231231C000001",
  "ordAccpDtm": "2026-02-27T18:08:20.084Z",
  "ordMediaCd": "20",
  "claimGoodsDetailsList": [
    {
      "ordNo": "20231231O000001",
      "ordSeq": 1,
      "aeOrdSeq": "1",
      "ordProcSeq": 1,
      "ordProcAccpDtm": "2026-02-27T18:08:20.084Z",
      "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-02-27T18:08:20.084Z",
      "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": "[e-mail]",
        "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": "[e-mail]",
    "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": "[e-mail]",
    "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"
    ]
  },
  "claimGoodsDetailsListClaimQtySum": 1,
  "firstItmNm": "text",
  "firstGoodsNm": "text",
  "firstExchangeItmNm": "text",
  "expectedRefundAmt": 1,
  "firstOrdDtlStatCd": "text",
  "simpleChange": true
}

클레임 비용 계산 조회(BO)

post

기능설명

• 클레임 비용 계산 조회

---

상세내용

• 클레임 업무 별 화면 추가 결제/환불 금액 정보 및 환불수단 정보 제공

• 클레임 업무 처리 시 DB 기준 부가비용, 혜택정보 추가결제/환불 예정 데이터 생성 정보 및 쿠폰 사용/복원 정보 제공

---

수정번호

• Release v2.00_240627 : 주문 취소시 복수 개의 배송 그룹에 대해 접수가 가능하도록 비용 계산 로직 수정 (전체 취소 기능 추가)

• Release v2.00_240711 : 배송 지역그룹 별 추가 배송비 적용

• Release v2.00_240729 : 접수 대상이 모두 '회수여부'가 'N'인 경우, 회수 배송비 0원 부과

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

클레임 비용 계산 조회 요청 DTO

ordNostringRequired

주문번호

Example: 20230912O058151

ordMediaCdstring · enumRequired

주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문

Example: 20Possible values:

claimBusinessTypestring · enumRequired

ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류

Example: 11Possible values:

systemTypestring · enumRequired

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:

claimCalculateWorkTypestring · enumRequired

ClaimCalculateWorkType(클레임 혜택/비용처리 업무유형) * 10 : 클레임처리 화면조회 * 20 : 클레임처리 * 30 : 클레임상세내역 화면조회

Example: 10Possible values:

deliMethodCdstring · enumRequired

LO010(배송방법코드) * 10 : 택배배송 * 30 : 매장수령 * 40 : 퀵배송 * 50 : 해외배송 * 60 : 무배송

Example: 10Possible values:

orgClmNostringOptional

현재 클레임 번호

Example: 20230912C018562

newNumberedClmNostringOptional

새로 채번된 클레임 번호

Example: 20230912C018563

selectedRtnDlvBenefitYnstring · enumOptional

반품무료쿠폰 화면선택여부

Example: NPossible values:

customerCauseFaultbooleanOptional

Responses

200

BO 클레임 비용 계산 조회 성공

*/*

클레임 비용 계산 조회 응답 DTO

ordNostringOptional

주문번호

900

업무처리 오류 내용

*/*

post

/v1/claim/common/claimCalculateCost

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/claimCalculateCost HTTP/1.1
Host: localhost:8092/
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": "[e-mail]",
    "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": "[e-mail]",
    "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-02-27T18:08:20.084Z",
      "ordNo": "20231231O000001",
      "ordSeq": 1,
      "ordProcSeq": 1,
      "uprOrdProcSeq": 1,
      "maxOrdProcSeq": 1,
      "claimNo": "20231231C000001",
      "itmNo": "001",
      "ordDtlGbCd": "10",
      "ordDtlGbCdNm": "주문일반",
      "ordDtlStatCd": "10",
      "ordDtlStatCdNm": "접수",
      "deliGbCd": "10",
      "ordAccpDtm": "2026-02-27T18:08:20.084Z",
      "ordFnshDtm": "2026-02-27T18:08:20.084Z",
      "cnclQty": 0,
      "rtnQty": 0,
      "claimQty": 0,
      "claimPossibleQty": 5,
      "deliIndiDtm": "2026-02-27T18:08:20.084Z",
      "deliIndiRsvDtm": "2026-02-27T18:08:20.084Z",
      "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": "[e-mail]",
      "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": "[e-mail]",
        "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-02-27T18:08:20.084Z",
        "shipCfmDtm": "2026-02-27T18:08:20.084Z",
        "shipFnshDtm": "2026-02-27T18:08:20.084Z",
        "deliFnshDtm": "2026-02-27T18:08:20.084Z",
        "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-02-27T18:08:20.084Z",
        "ordFnshDtm": "2026-02-27T18:08:20.084Z",
        "ordDtlStatCd": "text",
        "ordQty": 1,
        "cnclQty": 1,
        "rtnQty": 1,
        "deliIndiDtm": "2026-02-27T18:08:20.084Z",
        "deliIndiRsvDtm": "2026-02-27T18:08:20.084Z",
        "deliNo": "text",
        "exchMidRtnYn": "text",
        "claimLgrpCd": "text",
        "claimMgrpCd": "text",
        "claimCausEtcCont": "text",
        "rtnPsbYn": "text",
        "exchPsbYn": "text",
        "ordCnclPsbYn": "text",
        "wthdYn": "text",
        "wthdFnshGbCd": "text",
        "shipFnshFcstDtm": "2026-02-27T18:08:20.084Z",
        "etcktNo": "text",
        "ecpnNo": "text"
      },
      "generalSalesProduct": true,
      "exchangeShipping": true,
      "ordSeqAndOrdProcSeq": "text",
      "goodsNoAndItmNo": "text",
      "withdrawShipping": true,
      "withdrawalDeliGbCd": true,
      "ordSeqAndUprOrdProcSeq": "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-02-27T18:08:20.084Z",
        "trdNo": "INIMX_CARDINIpayTest20990101090000685510",
        "trdDtm": "2026-02-27T18:08:20.084Z",
        "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-02-27T18:08:20.084Z",
        "sctnCnclPsbYn": "Y",
        "bankCd": "148",
        "bankCdNm": "국민은행",
        "actnNo": "계좌번호 암호화",
        "dpmnNm": "김플래티어",
        "dptFcstDt": "2099-01-01 09:00:00.000000",
        "dptCnfmDtm": "2026-02-27T18:08:20.084Z",
        "rfdBankCd": "148",
        "rfdBankCdNm": "국민은행",
        "rfdActnNo": "계좌번호 암호화",
        "rfdActnDepositorNm": "홍길동",
        "vbankDptCnfm": true,
        "vbankPaymentPending": true
      }
    ],
    "paymentOrderInfo": {
      "ordNo": "20990101O000001",
      "claimNo": "20990101C000001",
      "goodsNm": "플래티어커피",
      "ordManNm": "김플래티어",
      "ordmnCellNo": "01012345678",
      "ordmnEmailAddr": "[e-mail]",
      "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"
    ]
  }
}

클레임 비용 계산 조회(FO)

post

기능 설명

• 클레임 비용 계산 조회

---

상세 내용

• 클레임 업무 별 화면 추가 결제/환불 금액 정보 및 환불수단 정보 제공

• 클레임 업무 처리 시 DB 기준 부가비용, 혜택정보 추가결제/환불 예정 데이터 생성 정보 및 쿠폰 사용/복원 정보 제공

수정번호

• Release v2.00_240401 : 배송비용 발생으로 인한 추가결제 연관 비용 체크 수정

• Release v2.00_240509 : 쿠폰 적용대상에 기획전 정보 저장 추가

• Release v2.00_240627 : 주문 취소시 복수 개의 배송 그룹에 대해 접수가 가능하도록 비용 계산 로직 수정 (전체 취소 기능 추가)

• Release v2.00_240711 : 배송 지역그룹 별 추가 배송비 적용

• Release v2.00_240729 : 접수 대상이 모두 '회수여부'가 'N'인 경우, 회수 배송비 0원 부과

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

클레임 비용 계산 조회 요청 DTO

ordNostringRequired

주문번호

Example: 20230912O058151

ordMediaCdstring · enumRequired

주문매체 코드(OM007) 10 : 전화상담(CC) , 20 : PC , 30 : 모바일웹 , 40 : 안드로이드앱 , 50 : IOS앱 , 60 : 정기주문

Example: 20Possible values:

claimBusinessTypestring · enumRequired

ClaimBusiness(클레임업무유형) * 11 : 주문취소 * 20 : 반품접수 * 21 : 반품취소 * 30 : 교환접수 * 31 : 교환취소 * 22 : 반품완료 * 23 : 반품불가 * 24 : 교환반품 * 25 : 반품보류

Example: 11Possible values:

systemTypestring · enumRequired

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Example: 10Possible values:

claimCalculateWorkTypestring · enumRequired

ClaimCalculateWorkType(클레임 혜택/비용처리 업무유형) * 10 : 클레임처리 화면조회 * 20 : 클레임처리 * 30 : 클레임상세내역 화면조회

Example: 10Possible values:

deliMethodCdstring · enumRequired

LO010(배송방법코드) * 10 : 택배배송 * 30 : 매장수령 * 40 : 퀵배송 * 50 : 해외배송 * 60 : 무배송

Example: 10Possible values:

orgClmNostringOptional

현재 클레임 번호

Example: 20230912C018562

newNumberedClmNostringOptional

새로 채번된 클레임 번호

Example: 20230912C018563

selectedRtnDlvBenefitYnstring · enumOptional

반품무료쿠폰 화면선택여부

Example: NPossible values:

customerCauseFaultbooleanOptional

Responses

200

FO 클레임 비용 계산 조회 성공

*/*

클레임 비용 계산 조회 응답 DTO

ordNostringOptional

주문번호

900

업무처리 오류 내용

*/*

post

/v1/claim/common/claimCalculateCostFO

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/claimCalculateCostFO HTTP/1.1
Host: localhost:8092/
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": "[e-mail]",
    "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": "[e-mail]",
    "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-02-27T18:08:20.084Z",
      "ordNo": "20231231O000001",
      "ordSeq": 1,
      "ordProcSeq": 1,
      "uprOrdProcSeq": 1,
      "maxOrdProcSeq": 1,
      "claimNo": "20231231C000001",
      "itmNo": "001",
      "ordDtlGbCd": "10",
      "ordDtlGbCdNm": "주문일반",
      "ordDtlStatCd": "10",
      "ordDtlStatCdNm": "접수",
      "deliGbCd": "10",
      "ordAccpDtm": "2026-02-27T18:08:20.084Z",
      "ordFnshDtm": "2026-02-27T18:08:20.084Z",
      "cnclQty": 0,
      "rtnQty": 0,
      "claimQty": 0,
      "claimPossibleQty": 5,
      "deliIndiDtm": "2026-02-27T18:08:20.084Z",
      "deliIndiRsvDtm": "2026-02-27T18:08:20.084Z",
      "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": "[e-mail]",
      "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": "[e-mail]",
        "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-02-27T18:08:20.084Z",
        "shipCfmDtm": "2026-02-27T18:08:20.084Z",
        "shipFnshDtm": "2026-02-27T18:08:20.084Z",
        "deliFnshDtm": "2026-02-27T18:08:20.084Z",
        "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-02-27T18:08:20.084Z",
        "ordFnshDtm": "2026-02-27T18:08:20.084Z",
        "ordDtlStatCd": "text",
        "ordQty": 1,
        "cnclQty": 1,
        "rtnQty": 1,
        "deliIndiDtm": "2026-02-27T18:08:20.084Z",
        "deliIndiRsvDtm": "2026-02-27T18:08:20.084Z",
        "deliNo": "text",
        "exchMidRtnYn": "text",
        "claimLgrpCd": "text",
        "claimMgrpCd": "text",
        "claimCausEtcCont": "text",
        "rtnPsbYn": "text",
        "exchPsbYn": "text",
        "ordCnclPsbYn": "text",
        "wthdYn": "text",
        "wthdFnshGbCd": "text",
        "shipFnshFcstDtm": "2026-02-27T18:08:20.084Z",
        "etcktNo": "text",
        "ecpnNo": "text"
      },
      "generalSalesProduct": true,
      "exchangeShipping": true,
      "ordSeqAndOrdProcSeq": "text",
      "goodsNoAndItmNo": "text",
      "withdrawShipping": true,
      "withdrawalDeliGbCd": true,
      "ordSeqAndUprOrdProcSeq": "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-02-27T18:08:20.084Z",
        "trdNo": "INIMX_CARDINIpayTest20990101090000685510",
        "trdDtm": "2026-02-27T18:08:20.084Z",
        "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-02-27T18:08:20.084Z",
        "sctnCnclPsbYn": "Y",
        "bankCd": "148",
        "bankCdNm": "국민은행",
        "actnNo": "계좌번호 암호화",
        "dpmnNm": "김플래티어",
        "dptFcstDt": "2099-01-01 09:00:00.000000",
        "dptCnfmDtm": "2026-02-27T18:08:20.084Z",
        "rfdBankCd": "148",
        "rfdBankCdNm": "국민은행",
        "rfdActnNo": "계좌번호 암호화",
        "rfdActnDepositorNm": "홍길동",
        "vbankDptCnfm": true,
        "vbankPaymentPending": true
      }
    ],
    "paymentOrderInfo": {
      "ordNo": "20990101O000001",
      "claimNo": "20990101C000001",
      "goodsNm": "플래티어커피",
      "ordManNm": "김플래티어",
      "ordmnCellNo": "01012345678",
      "ordmnEmailAddr": "[e-mail]",
      "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"
    ]
  }
}

클레임 추가 결제정보 조회

post

기능 설명

• 클레임 추가결제에 필요한 정보를 조회합니다.

---

상세 설명

• 사용가능한 주결제수단, 보조결제수단 목록을 조회합니다.

• 로그인된 회원 정보가 있을 경우, 사용가능 마일리지 정보도 보조결제수단목록에 포함되어 조회됩니다.

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

추가결제정보 DTO

900

업무처리 오류 내용

*/*

post

/v1/claim/common/additionalFeePaymentInfo

HTTPcURLJavaScriptPython

POST /api/order/v1/claim/common/additionalFeePaymentInfo HTTP/1.1
Host: localhost:8092/
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
    }
  ]
}

비회원 주문 환불 계좌 정보 조회

get

기능설명

• 주문번호 기준으로 비회원 주문 환불 계좌 정보를 조회합니다.

---

상세설명

• op_ord_base 테이블에서 환불 계좌 정보를 조회합니다.

• 주문번호는 필수 파라미터입니다.

---

특이사항

• 전달하는 데이터 중 계좌번호는 마스킹 처리되어 출력됩니다.

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

환불 계좌정보 조회 Response

rfdBankCdstringOptional

은행코드 (OM026)

Example: 203

rfdBankNmstringOptional

은행명

Example: KB국민은행

rfdActnNostringOptional

환불계좌번호

Example: 33330********

rfdActnDepositorNmstringOptional

환불 계좌 예금주명

Example: 임성현

rfdActnCertiYnstringOptional

환불 계좌 인증여부

Example: Y

900

업무처리 오류 내용

*/*

get

/v1/claim/common/getNonMemberRefundActnInfo

HTTPcURLJavaScriptPython

GET /api/order/v1/claim/common/getNonMemberRefundActnInfo?request=[object+Object] HTTP/1.1
Host: localhost:8092/
Accept: */*

{
  "rfdBankCd": "203",
  "rfdBankNm": "KB국민은행",
  "rfdActnNo": "33330********",
  "rfdActnDepositorNm": "임성현",
  "rfdActnCertiYn": "Y"
}