주문반품

반품철회(BO)

post

기능설명

반품접수건을 철회합니다.

상세내용

주문내역구분(OM003) 값이 반품(20) 이고, 주문내역상태(OM005) 값이 결제대기(31), 접수(32), 회수지시(34) 상태인 경우 철회가 가능합니다.
반품 철회 전 API 호출 시점의 주문 상태를 확인, 철회 가능 여부를 확인합니다.
반품 철회 데이터 생성 및 업데이트합니다.
반품 철회 대상의 주문내역상태(OM005) 값이 회수지시(34) 상태인 경우 배송지시취소수량을 업데이트합니다.
반품 접수시 발생한 비용에 대해 결제 취소를 진행합니다.
반품 철회시 발생하는 결제 및 환불 금액에 대한 검증을 수행합니다.
반품 접수시 무료반품쿠폰을 사용한 경우, 쿠폰을 복원합니다.
반품 철회 완료 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)
반품 철회 완료 후 처리 이력을 생성합니다.

특이사항

해당 API는 BO 전용 API입니다. BO를 통한 접근만 허용됩니다.

수정번호

release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

클레임 처리 요청 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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

*/*

ordNostringOptional

주문번호

Example: 20230808O007404

claimNostringOptional

클레임번호

Example: 20230808C010663

900

업무처리 오류 내용

*/*

post

/v1/claim/return/withdrawalReturn

POST /api/order/v1/claim/return/withdrawalReturn 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": "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-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": "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

{
  "ordNo": "20230808O007404",
  "claimNo": "20230808C010663"
}

반품철회(FO)

post

기능설명

반품접수건을 철회합니다.

상세내용

주문기본 테이블의 회원정보(비회원 포함)와 로그인 정보를 비교하여 권한을 확인합니다.
주문내역구분(OM003) 값이 반품(20) 이고, 주문내역상태(OM005) 값이 결제대기(31), 접수(32), 회수지시(34) 상태인 경우 철회가 가능합니다.
반품 철회 전 API 호출 시점의 주문 상태를 확인, 철회 가능 여부를 확인합니다.
반품 철회 데이터 생성 및 업데이트합니다.
반품 철회 대상의 주문내역상태(OM005) 값이 회수지시(34) 상태인 경우 배송지시취소수량을 업데이트합니다.
반품 접수시 발생한 비용에 대해 결제 취소를 진행합니다.
반품 철회시 발생하는 결제 및 환불 금액에 대한 검증을 수행합니다.
반품 접수시 무료반품쿠폰을 사용한 경우, 쿠폰을 복원합니다.
반품 철회 완료 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)
반품 철회 완료 후 처리 이력을 생성합니다.

수정번호

release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

클레임 처리 요청 DTO

systemTypestring · enumRequired

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

Example: 10Possible values:

claimBusinessTypestring · enumRequired

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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

*/*

ordNostringOptional

주문번호

Example: 20230808O007404

claimNostringOptional

클레임번호

Example: 20230808C010663

900

업무처리 오류 내용

*/*

post

/v1/claim/return/withdrawalReturnFO

POST /api/order/v1/claim/return/withdrawalReturnFO 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": "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-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": "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

{
  "ordNo": "20230808O007404",
  "claimNo": "20230808C010663"
}

교환중 반품(BO)

post

기능설명

교환접수 진행 중 반품처리합니다.

상세내용

주문내역구분(OM003) 값이 교환(30) 이고, 주문내역상태(OM005) 값이 회수확인(35) 상태인 경우 처리 가능합니다.
API 호출 시점의 주문 상태를 재 확인, 교환반품 처리 가능 여부를 확인합니다.
교환 중 반품 처리시 대상 교환건을 철회하고, 반품 절차를 진행합니다. 단, 일반 반품 접수와 달리 교환중반품여부(exchMidRtnYn)값을 (Y)로 생성합니다.
교환 중 반품 처리는 귀책 사유가 당사에 있기 때문에, 추가 결제 배송비가 발생하지 않습니다.
교환 중 반품 처리 후 처리 이력을 생성합니다.

특이사항

해당 API는 BO 전용 API입니다. BO를 통한 접근만 허용됩니다.

수정번호

release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가
Release v2.00_240509 : 교환 취소 후 반품 접수시 배송지시일시 null에서 현재일시로 default 세팅 변경

Header parameters

AuthorizationanyOptional

Access Token

Body

클레임 처리 요청 DTO

systemTypestring · enumRequired

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

Example: 10Possible values:

claimBusinessTypestring · enumRequired

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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

*/*

ordNostringOptional

주문번호

Example: 20230808O007404

claimNostringOptional

클레임번호

Example: 20230808C010663

900

업무처리 오류 내용

*/*

post

/v1/claim/return/transformReturn

POST /api/order/v1/claim/return/transformReturn 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": "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-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": "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

{
  "ordNo": "20230808O007404",
  "claimNo": "20230808C010663"
}

반품접수 대상 조회(BO)

post

기능설명

주문 내역과 반품 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.

상세내용

**주문번호(ordNo), 클레임업무유형(claimBusinessType), 시스템유형(systemType)**은 필수 파라미터 입니다.
다음의 조건을 모두 충족하는 대상에 대해 반품 처리가 가능합니다.
1. 주문내역구분(OM003) 값이 주문일반(10) 이거나 교환(30) 인 경우
2. 주문내역상태(OM005) 값이 출고완료(26) 이거나 **배송완료(27)**인 경우
3. 반품 가능여부 값이 “Y” 인 경우
4. 일반상품인 경우(사은품 제외)
5. 반품 가능 수량이 1개 이상인 경우 ( 주문수량 – 취소수량 – 반품수량 > 0 )
기타 정보에 포함된 공통 코드 목록은 아래와 같습니다.
1. 클레임대분류코드(OM047)
2. 클레임중분류코드(OM006)
3. 배송메시지코드(ME039)
4. 공동현관출입방법코드(ME040)
5. 귀책구분코드(CS020)
6. 부가비용상세구분코드(OM019)
7. 주문비용구분코드(OM043)
8. 결제수단코드(OM013)

특이사항

해당 API는 BO 전용 API입니다. BO를 통한 접근만 허용됩니다.

수정번호

release_231204_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행
Release v2.00_240729 : e-쿠폰 사용 여부 체크 추가, 상품 유형에 따라 클레임 사유 필터링 회수여부(wthdYn)/e쿠폰번호(ecpnNo)/e티켓번호(etcktNo)/회수불필요주문여부(isAllNonReturnable)/e쿠폰주문여부(isAllEcoupon) 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

반품처리대상조회 요청 DTO

ordNostringRequired

주문번호

Example: 20230809O000001

claimBusinessTypestring · enumRequired

Example: 11Possible values:

systemTypestring · enumRequired

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

Example: 10Possible values:

dlvpSeqstringOptional

배송지순번

Example: 1

Responses

200

성공

*/*

반품처리대상조회 응답 DTO

claimBusinessTypestring · enumOptional

Example: 11Possible values:

900

업무처리 오류 내용

*/*

post

/v1/claim/return/returnTargetInfo

POST /api/order/v1/claim/return/returnTargetInfo HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "ordNo": "20230809O000001",
  "claimBusinessType": "11",
  "systemType": "10",
  "dlvpSeq": "1"
}

{
  "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-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": "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-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
  },
  "codeMap": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "cd": "302",
        "cdNm": "색상변경",
        "cdDesc": "[단순변심]",
        "sortSeq": "22",
        "ref1Val": "30",
        "ref2Val": "10",
        "ref3Val": "10",
        "ref4Val": "10",
        "ref5Val": "Y",
        "ref6Val": "null",
        "ref7Val": "null"
      }
    ]
  },
  "claimBusinessType": "11"
}

반품접수 대상 조회(FO)

post

기능설명

주문 내역과 반품 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.

상세내용

반품 처리 대상 조회 시 주문 회원정보(비회원 포함)와 로그인 정보를 비교하여 권한을 확인합니다.
**주문번호(ordNo), 클레임업무유형(claimBusinessType), 시스템유형(systemType)**은 필수 파라미터 입니다.
다음의 조건을 모두 충족하는 대상에 대해 반품 처리가 가능합니다.
1. 주문내역구분(OM003) 값이 주문일반(10) 이거나 교환(30) 인 경우
2. 주문내역상태(OM005) 값이 출고완료(26) 이거나 **배송완료(27)**인 경우
3. 반품 가능여부 값이 “Y” 인 경우
4. 일반상품인 경우(사은품 제외)
5. 반품 가능 수량이 1개 이상인 경우 ( 주문수량 – 취소수량 – 반품수량 > 0 )
기타 정보에 포함된 공통 코드 목록은 아래와 같습니다.
1. 클레임대분류코드(OM047)
2. 클레임중분류코드(OM006)
3. 배송메시지코드(ME039)
4. 공동현관출입방법코드(ME040)
5. 귀책구분코드(CS020)
6. 부가비용상세구분코드(OM019)
7. 주문비용구분코드(OM043)
8. 결제수단코드(OM013)

수정번호

release_231023 : 회원인 경우, 보조 결제수단 및 마일리지 정보 조회 프로세스 제거 (별도의 API로 분리)
release_231204_01 : Request DTO 배송지순번(dlvpSeq) 추가, 대상 조회시 배송지 순번 값이 있는경우 필터링 추가 실행
Release v2.00_240729 : e-쿠폰 사용 여부 체크 추가, 상품 유형에 따라 클레임 사유 필터링 회수여부(wthdYn)/e쿠폰번호(ecpnNo)/e티켓번호(etcktNo)/회수불필요주문여부(isAllNonReturnable)/e쿠폰주문여부(isAllEcoupon) 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

반품처리대상조회 요청 DTO

ordNostringRequired

주문번호

Example: 20230809O000001

claimBusinessTypestring · enumRequired

Example: 11Possible values:

systemTypestring · enumRequired

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

Example: 10Possible values:

dlvpSeqstringOptional

배송지순번

Example: 1

Responses

200

성공

*/*

반품처리대상조회 응답 DTO

claimBusinessTypestring · enumOptional

Example: 11Possible values:

900

업무처리 오류 내용

*/*

post

/v1/claim/return/returnTargetInfoFO

POST /api/order/v1/claim/return/returnTargetInfoFO HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "ordNo": "20230809O000001",
  "claimBusinessType": "11",
  "systemType": "10",
  "dlvpSeq": "1"
}

{
  "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-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": "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-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
  },
  "codeMap": {
    "ANY_ADDITIONAL_PROPERTY": [
      {
        "cd": "302",
        "cdNm": "색상변경",
        "cdDesc": "[단순변심]",
        "sortSeq": "22",
        "ref1Val": "30",
        "ref2Val": "10",
        "ref3Val": "10",
        "ref4Val": "10",
        "ref5Val": "Y",
        "ref6Val": "null",
        "ref7Val": "null"
      }
    ]
  },
  "claimBusinessType": "11"
}

반품보류(BO)

post

기능설명

반품보류 처리합니다.

상세내용

주문내역구분(OM003) 값이 반품(20) 이고, 주문내역상태(OM005) 값이 회수확인(35), 회수완료(36) 상태인 경우 처리 가능합니다.
API 호출 시점의 주문 상태를 재 확인, 불가 처리 가능 여부를 확인합니다.
반품 보류 처리시 배송비 발생한 경우 주문 상태를 결제대기 상태로 변경합니다.
반품 불가 처리시 회수완료 대기처리 사유(wthdFnshWaitProcCaus)는 필수값입니다.

특이사항

해당 API는 BO 전용 API입니다. BO를 통한 접근만 허용됩니다.

수정번호

Release v2.00_240729 : 반품 접수 대상이 모두 '회수여부'가 'N'인 경우, 반품 배송비 부과 제외

Header parameters

AuthorizationanyOptional

Access Token

Body

클레임 처리 요청 DTO

systemTypestring · enumRequired

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

Example: 10Possible values:

claimBusinessTypestring · enumRequired

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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

*/*

ordNostringOptional

주문번호

Example: 20230808O007404

claimNostringOptional

클레임번호

Example: 20230808C010663

900

업무처리 오류 내용

*/*

post

/v1/claim/return/returnPending

POST /api/order/v1/claim/return/returnPending 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": "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-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": "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

{
  "ordNo": "20230808O007404",
  "claimNo": "20230808C010663"
}

반품불가(BO)

post

기능설명

반품접수 불가처리합니다.

상세내용

주문내역구분(OM003) 값이 반품(20) 이고, 주문내역상태(OM005) 값이 회수확인(35), 회수완료(36) 상태인 경우 처리 가능합니다.
API 호출 시점의 주문 상태를 재 확인, 불가 처리 가능 여부를 확인합니다.
반품 불가 처리시 대상 반품건을 철회하고, 주문상세 테이블의 반품가능여부(rtnPsbYn) 속성값이 (N)으로 변경됩니다.
반품 불가 처리시 회수완료 대기처리 사유(wthdFnshWaitProcCaus)는 필수값입니다.
주문배송정보(OP_ORD_DELI_INFO) 테이블의 회수완료구분코드값은 불량반품(20)으로 자동 저장됩니다.
반품 불가 후 처리 이력을 생성합니다.

특이사항

해당 API는 BO 전용 API입니다. BO를 통한 접근만 허용됩니다.

수정번호

release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

클레임 처리 요청 DTO

systemTypestring · enumRequired

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

Example: 10Possible values:

claimBusinessTypestring · enumRequired

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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

*/*

ordNostringOptional

주문번호

Example: 20230808O007404

claimNostringOptional

클레임번호

Example: 20230808C010663

900

업무처리 오류 내용

*/*

post

/v1/claim/return/rejectReturn

POST /api/order/v1/claim/return/rejectReturn 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": "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-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": "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

{
  "ordNo": "20230808O007404",
  "claimNo": "20230808C010663"
}

반품완료(BO)

post

기능설명

반품접수 완료처리합니다.

상세내용

주문내역구분(OM003) 값이 반품(20) 이고, 주문내역상태(OM005) 값이 회수완료(36) 상태인 경우 처리 가능합니다.
API 호출 시점의 주문 상태를 재 확인, 완료 처리 가능 여부를 확인합니다.
주문상세 테이블의 주문내역상태코드(OM005) 값이 반품완료(37) 상태로 변경되며(사은품 포함), 주문완료일시(ordFnshDtm)를 업데이트합니다.
주문배송정보 테이블의 배송완료일시(deliFnshDtm)를 업데이트합니다.
주문시 사용되었던 쿠폰과 주문상품(사은품 포함)의 재고가 복원됩니다. 단, 주문상세의 교환중반품여부(exchMidRtnYn)값이 (Y)이고 주문내역상태값이 회수완료(36)인 경우 재고 복원대상에서 제외됩니다.
환불 절차를 진행합니다.
반품 완료 처리 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)
반품 완료 처리 후 처리 이력을 생성합니다.

특이사항

해당 API는 BO 전용 API입니다. BO를 통한 접근만 허용됩니다.

수정번호

Release v2.00_240729 : 반품 접수 대상의 '회수여부'가 'N'인 경우, 재고 복원 제외
Release v2.00_250801 : 추가 결제 발생한 교환 신청 후 반품 완료 시 교환 상품 배송비 환불되는 현상 개선

Header parameters

AuthorizationanyOptional

Access Token

Body

클레임 처리 요청 DTO

systemTypestring · enumRequired

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

Example: 10Possible values:

claimBusinessTypestring · enumRequired

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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

*/*

ordNostringOptional

주문번호

Example: 20230808O007404

claimNostringOptional

클레임번호

Example: 20230808C010663

900

업무처리 오류 내용

*/*

post

/v1/claim/return/completeReturn

POST /api/order/v1/claim/return/completeReturn 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": "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-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": "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

{
  "ordNo": "20230808O007404",
  "claimNo": "20230808C010663"
}

반품완료 배치

post

기능설명

반품접수 완료처리합니다.

상세내용

주문내역구분(OM003) 값이 반품(20) 이고, 주문내역상태(OM005) 값이 회수완료(36) 상태인 경우 처리 가능합니다.
API 호출 시점의 주문 상태를 재 확인, 완료 처리 가능 여부를 확인합니다.
주문상세 테이블의 주문내역상태코드(OM005) 값이 반품완료(37) 상태로 변경되며(사은품 포함), 주문완료일시(ordFnshDtm)를 업데이트합니다.
주문배송정보 테이블의 배송완료일시(deliFnshDtm)를 업데이트합니다.
주문시 사용되었던 쿠폰과 주문상품(사은품 포함)의 재고가 복원됩니다. 단, 주문상세의 교환중반품여부(exchMidRtnYn)값이 (Y)이고 주문내역상태값이 회수완료(36)인 경우 재고 복원대상에서 제외됩니다.
환불 절차를 진행합니다.
반품 완료 처리 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)
반품 완료 처리 후 처리 이력을 생성합니다.

특이사항

해당 API는 BATCH 전용 API입니다.

수정번호

Release v2.00_240729 : 반품 접수 대상의 '회수여부'가 'N'인 경우, 재고 복원 제외

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject[]

클레임 처리 요청 DTO

systemTypestring · enumRequired

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

Example: 10Possible values:

claimBusinessTypestring · enumRequired

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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/claim/return/completeReturnBatch

POST /api/order/v1/claim/return/completeReturnBatch HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 5012

[
  {
    "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-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": "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": "불량반품",
    "claimBusiness": "11",
    "existAddtionPayAmt": true,
    "occurPayment": true
  }
]

No content

반품접수(BO)

post

기능설명

반품대상을 접수처리합니다.

상세내용

반품 접수 전 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.
반품 접수 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.
1. 접수 상품 배송번호 일치 여부 체크(→ 클레임 불가)
2. 접수 상품 사은품 유무 체크(→ 부분 수량 클레임 불가)
3. 부분취소불가 결제수단 사용 여부 체크(→ 부분 클레임 불가)
4. 주문번호 기준, 기 접수된 반품 건 중 초도 배송비 발생 및 반품 취소 가능 상태(결제대기, 접수, 회수지)인 클레임 유무 체크(→ 추가 반품 접수 불가)
5. 현 반품 접수 건에 초도 배송비가 발생한 경우, 기 접수된 반품 건 중 반품 취소 가능 상태(결제대기, 접수, 회수지)인 클레임 유무 체크(→ 추가 반품 접수 불가)
반품 접수 데이터 생성 및 업데이트합니다.
추가 결제 금액이 발생한 경우,
1. 환불 예정금액보다 추가 결제 금액이 큰 경우, 주문내역상태(OM005) 값은 결제대기(31)로 저장되며, 고객의 추가 배송비 결제가 필요합니다.
2. 환불 예정금액보다 추가 결제 금액이 작거나 같은 경우, 추가 결제 금액이 차감된 금액이 환불됩니다.
반품 접수시 발생하는 결제 및 환불 금액에 대해 검증을 수행합니다.
반품 접수시 무료반품쿠폰을 사용한 경우, 쿠폰을 사용처리합니다.
반품 접수 완료 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)
반품 접수 완료 후 처리 이력을 생성합니다.

특이사항

해당 API는 BO 전용 API입니다. BO를 통한 접근만 허용됩니다.

수정번호

release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가
Release v2.00_240729 : 반품 접수 대상이 모두 '회수여부'가 'N'인 경우, 반품 배송비 부과 제외 e-쿠폰 상품 반품의 경우, e-쿠폰 사용 불가 처리

Header parameters

AuthorizationanyOptional

Access Token

Body

클레임 처리 요청 DTO

systemTypestring · enumRequired

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

Example: 10Possible values:

claimBusinessTypestring · enumRequired

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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

*/*

ordNostringOptional

주문번호

Example: 20230808O007404

claimNostringOptional

클레임번호

Example: 20230808C010663

900

업무처리 오류 내용

*/*

post

/v1/claim/return/acceptReturn

POST /api/order/v1/claim/return/acceptReturn 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": "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-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": "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

{
  "ordNo": "20230808O007404",
  "claimNo": "20230808C010663"
}

반품접수(FO)

post

기능설명

반품대상을 접수처리합니다.

상세내용

주문기본 테이블의 회원정보(비회원 포함)와 로그인 정보를 비교하여 권한을 확인합니다.
반품 접수 전 API 호출 시점의 주문 상태를 확인, 접수 가능 여부를 확인합니다.
반품 접수 요청 데이터의 유효성 검증은 다음의 항목에 대해 진행합니다.
1. 접수 상품 배송번호 일치 여부 체크(→ 클레임 불가)
2. 접수 상품 사은품 유무 체크(→ 부분 수량 클레임 불가)
3. 부분취소불가 결제수단 사용 여부 체크(→ 부분 클레임 불가)
4. 주문번호 기준, 기 접수된 반품 건 중 초도 배송비 발생 및 반품 취소 가능 상태(결제대기, 접수, 회수지)인 클레임 유무 체크(→ 추가 반품 접수 불가)
5. 현 반품 접수 건에 초도 배송비가 발생한 경우, 기 접수된 반품 건 중 반품 취소 가능 상태(결제대기, 접수, 회수지)인 클레임 유무 체크(→ 추가 반품 접수 불가)
반품 접수 데이터 생성 및 업데이트합니다.
추가 결제 금액이 발생한 경우, 결제를 진행합니다.
반품 접수시 발생하는 결제 및 환불 금액에 대해 검증을 수행합니다.
반품 접수시 무료반품쿠폰을 사용한 경우, 쿠폰을 사용처리합니다.
반품 접수 완료 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)
반품 접수 완료 후 처리 이력을 생성합니다.

수정번호

release_231009_01 : 주문혜택관계테이블 주문수량, 취소수량 컬럼 추가
Release v2.00_240700 : 반품 접수 대상이 모두 '회수여부'가 'N'인 경우, 반품 배송비 부과 제외 e-쿠폰 상품 반품의 경우, e-쿠폰 사용 불가 처리

Header parameters

AuthorizationanyOptional

Access Token

Body

클레임 처리 요청 DTO

systemTypestring · enumRequired

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

Example: 10Possible values:

claimBusinessTypestring · enumRequired

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

Example: 11Possible values:

existAddtionPayAmtbooleanOptional

occurPaymentbooleanOptional

Responses

200

성공

*/*

ordNostringOptional

주문번호

Example: 20230808O007404

claimNostringOptional

클레임번호

Example: 20230808C010663

900

업무처리 오류 내용

*/*

post

/v1/claim/return/acceptReturnFO

POST /api/order/v1/claim/return/acceptReturnFO 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": "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-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": "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": "불량반품",
  "claimBusiness": "11",
  "existAddtionPayAmt": true,
  "occurPayment": true
}

{
  "ordNo": "20230808O007404",
  "claimNo": "20230808C010663"
}

Previous고객 센터 제공 Next주문변경

Last updated 1 day ago

hashtag반품철회(BO)

hashtag기능설명

hashtag반품접수건을 철회합니다.

hashtag상세내용

hashtag특이사항

hashtag수정번호

hashtag반품철회(FO)

hashtag기능설명

hashtag반품접수건을 철회합니다.

hashtag상세내용

hashtag수정번호

hashtag교환중 반품(BO)

hashtag기능설명

hashtag교환접수 진행 중 반품처리합니다.

hashtag상세내용

hashtag특이사항

hashtag수정번호

hashtag반품접수 대상 조회(BO)

hashtag기능설명

hashtag주문 내역과 반품 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.

hashtag상세내용

hashtag특이사항

hashtag수정번호

hashtag반품접수 대상 조회(FO)

hashtag기능설명

hashtag주문 내역과 반품 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.

hashtag상세내용

hashtag수정번호

hashtag반품보류(BO)

hashtag기능설명

hashtag반품보류 처리합니다.

hashtag상세내용

hashtag특이사항

hashtag수정번호

hashtag반품불가(BO)

hashtag기능설명

hashtag반품접수 불가처리합니다.

hashtag상세내용

hashtag특이사항

hashtag수정번호

hashtag반품완료(BO)

hashtag기능설명

hashtag반품접수 완료처리합니다.

hashtag상세내용

hashtag특이사항

hashtag수정번호

hashtag반품완료 배치

hashtag기능설명

hashtag반품접수 완료처리합니다.

hashtag상세내용

hashtag특이사항

hashtag수정번호

hashtag반품접수(BO)

hashtag기능설명

hashtag반품대상을 접수처리합니다.

hashtag상세내용

hashtag특이사항

hashtag수정번호

hashtag반품접수(FO)

hashtag기능설명

hashtag반품대상을 접수처리합니다.

hashtag상세내용

hashtag수정번호

반품철회(BO)

기능설명

반품접수건을 철회합니다.

상세내용

특이사항

수정번호

반품철회(FO)

기능설명

반품접수건을 철회합니다.

상세내용

수정번호

교환중 반품(BO)

기능설명

교환접수 진행 중 반품처리합니다.

상세내용

특이사항

수정번호

반품접수 대상 조회(BO)

기능설명

주문 내역과 반품 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.

상세내용

특이사항

수정번호

반품접수 대상 조회(FO)

기능설명

주문 내역과 반품 가능 상품 목록, 화면 처리 시 필요한 기타 정보를 조회합니다.

상세내용

수정번호

반품보류(BO)

기능설명

반품보류 처리합니다.

상세내용

특이사항

수정번호

반품불가(BO)

기능설명

반품접수 불가처리합니다.

상세내용

특이사항

수정번호

반품완료(BO)

기능설명

반품접수 완료처리합니다.

상세내용

특이사항

수정번호

반품완료 배치

기능설명

반품접수 완료처리합니다.

상세내용

특이사항

수정번호

반품접수(BO)

기능설명

반품대상을 접수처리합니다.

상세내용

특이사항

수정번호

반품접수(FO)

기능설명

반품대상을 접수처리합니다.

상세내용

수정번호