고객보상관리

고객보상 상세 정보 수정

post

기능설명

• 고객보상 상세 정보를 수정 합니다.

---

상세설명

• 고객보상수단(쿠폰): 승인상태가 접수 일 때 수정 가능 합니다.

• 고객보상수단(현금): 승인상태가 접수 일 때 수정 가능 합니다.

• 고객보상수단(마일리지): 승인상태 접수 일 때 수정 가능 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

custCpnsAplyNoStringOptional

고객보상신청번호

cpnsAmtNoStringOptional

보상금액번호

promoNmStringOptional

쿠폰명

accpContStringOptional

접수내용

payReqMemoStringOptional

지급요청메모

payBankCdStringOptional

지급은행코드

payActnNoStringOptional

지급계좌번호

payDepositorNmStringOptional

지급예금주명

Body

application/json

고객보상 상세정보 수정 요청 DTO

cpnsMeanCdstringOptional

20

Example: 보상수단코드(CS019)

mbrNostringOptional

100000513

Example: 회원번호

custCpnsAplyNostringOptional

고객보상신청번호

Example: 10000901

cpnsAmtNostringOptional

보상금액번호

Example: C1003671

promoNmstringOptional

쿠폰명

Example: 고객보상 정액 50000원

accpContstringOptional

접수내용

Example: 보상접수내용 입니다.

payReqMemostringOptional

지급요청메모

Example: 지급요청바랍니다.

payBankCdstringOptional

지급은행코드

payActnNostringOptional

지급계좌번호

payDepositorNmstringOptional

지급예금주명

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/customerCompensMgmt/updateCustomerCompensDetail

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/customerCompensMgmt/updateCustomerCompensDetail HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 301

{
  "cpnsMeanCd": "보상수단코드(CS019)",
  "mbrNo": "회원번호",
  "custCpnsAplyNo": 10000901,
  "cpnsAmtNo": "C1003671",
  "promoNm": "고객보상 정액 50000원",
  "accpCont": "보상접수내용 입니다.",
  "payReqMemo": "지급요청바랍니다.",
  "payBankCd": "text",
  "payActnNo": "text",
  "payDepositorNm": "text"
}

{
  "timestamp": "2026-02-27T18:21:21.659Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 접수취소/반려

post

기능설명

• 선택한 고객보상을 접수취소/반려 처리 합니다.

---

상세설명

• 반려는 각 권한별 사용자만 처리 가능합니다.

• 접수취소/반려 처리된 고객보상접수는 재 신청이 불가능하며 상담신청부터 다시 등록해야 합니다.

코드정리

• 접수취소/반려 분류타입(type): 접수취소(C), 보상승인반려(A), 지급승인반려(B)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

typestringOptional

접수취소/반려 분류타입

Example: C

custCpnsAplyNostring[]Optional

고객보상신청번호

Example: 10000901

memostringOptional

반려사유

Example: 반려합니다.

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/customerCompensMgmt/returnCustomerCompensDetail

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/customerCompensMgmt/returnCustomerCompensDetail HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "type": "C",
  "custCpnsAplyNo": 10000901,
  "memo": "반려합니다."
}

{
  "timestamp": "2026-02-27T18:21:21.659Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 지급승인 위한 상세정보 조회

post

기능설명

• 고객보상 지급승인하기 위한 상세 정보를 조회 합니다.

---

상세설명

• 선택한 고객보상신청번호, 고객보상분류타입에 해당하는 상세 정보를 조회 합니다.

코드정리

• 고객보상분류타입(type): 보상승인(A), 지급승인(P)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객보상 지급승인위한 상세정보 조회 요청 DTO

custCpnsAplyNoListstring[]Optional

고객보상신청번호 목록

Example: [10000901]

typestringOptional

고객보상분류타입

Example: A

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/customerCompensMgmt/getCustomerCompensInfo

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/customerCompensMgmt/getCustomerCompensInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "custCpnsAplyNoList": [
    10000901
  ],
  "type": "A"
}

{
  "timestamp": "2026-02-27T18:21:21.659Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "payActnNo": "text",
      "custCpnsAplyNo": "text",
      "ccnNo": "text",
      "cpnsTypNo": "text",
      "cpnsMeanCd": "text",
      "rspnGbCd": "text",
      "cpnsAprvStatCd": "text",
      "cpnsPayStatCd": "text",
      "mbrNo": "text",
      "accpDtm": "text",
      "accpCont": "text",
      "acptmnId": "text",
      "cpnsAmtNo": "text",
      "promoNm": "text",
      "aprvDtm": "text",
      "aprmnId": "text",
      "payReqMemo": "text",
      "retnDtm": "text",
      "retnProcmnId": "text",
      "payDtm": "text",
      "paymnId": "text",
      "payCont": "text",
      "payReqDtm": "text",
      "payBankCd": "text",
      "payDepositorNm": "text",
      "ordNo": "text",
      "goodsNo": "text",
      "retnCausCont": "text",
      "couponNo": "text",
      "mileage": "text",
      "giftNo": "text",
      "getUserNm": "text",
      "getUserCellNo": "text",
      "zipcode": "text",
      "zipcodeD": "text",
      "zipNo": "text",
      "payCpnsNo": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 승인처리

post

기능설명

• 접수된 고객보상을 승인처리 합니다.

---

상세설명

• 접수 > 보상승인 > 지급승인 단계로 처리됩니다.

• 보상수단이 쿠폰, 마일리지일 경우 지급승인되면 지급상태는 지금완료 처리됩니다.

• 보상수단이 현금일 경우 지급승인되면 지급상태는 지급대기로 처리되며 고객에게 입금완료 후 지급완료 처리됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

고객보상 승인처리 요청 DTO

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/customerCompensMgmt/approveCustomerCompensDetail

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/customerCompensMgmt/approveCustomerCompensDetail HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1152

{
  "request": [
    {
      "custCpnsAplyNo": "고객보상신청번호",
      "ccnNo": "상담번호",
      "cpnsTypNo": "보상유형번호",
      "cpnsMeanCd": "보상수단코드(CS019)",
      "rspnGbCd": "귀책구분코드(CS020)",
      "cpnsAprvStatCd": "보상승인상태코드(CS021)",
      "cpnsPayStatCd": "보상지급상태코드(CS020)",
      "mbrNo": "회원번호",
      "mbrNm": "회원명",
      "loginId": "회원ID",
      "accpDtm": "접수일시",
      "accpCont": "접수내용",
      "acptmnId": "접수자ID",
      "cpnsAmtNo": "보상금액번호",
      "promoNm": "프로모션명(쿠폰명)",
      "aprvDtm": "승인일시",
      "aprmnId": "승인자ID",
      "payReqMemo": "지급요청메모",
      "retnDtm": "반려일시",
      "retnProcmnId": "반려처리자ID",
      "payDtm": "지급일시",
      "paymnId": "지급자ID",
      "payCont": "지급내용",
      "payReqDtm": "지급요청일시",
      "payBankCd": "지급은행코드",
      "payActnNo": "지급계좌번호",
      "noEncryptPayActnNo": "지급계좌번호(복호화)",
      "payDepositorNm": "지급예금주명",
      "ordNo": "주문번호",
      "goodsNo": "상품번호",
      "retnCausCont": "반려사유내용",
      "couponNo": "쿠폰번호",
      "mileage": "마일리지",
      "request": "고객보상접수정보 요청 DTO",
      "custCpnsAplyNoList": "고객보상신청번호 목록"
    }
  ]
}

{
  "timestamp": "2026-02-27T18:21:21.659Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상관리 목록 조회

get

기능설명

• 고객보상관리 목록을 조회 합니다.

---

상세설명

• 선택한 조건에 대한 고객보상관리 목록을 조회 합니다.

---

수정번호

• Release v2.00_240613: 기간 검색 조건 개선

• Release v2.00_240827: V2 RealGridListResponse 변경

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

periodTypestringOptional

기간검색종류

Example: 0

startDatestring · dateOptional

시작일자

Example: 2023-07-01

endDatestring · dateOptional

종료일자

Example: 2023-09-15

rspnGbCdstring · enumOptional

귀책구분코드(CS020)

Example: 10Possible values:

cpnsTypNostringOptional

보상유형번호

Example: 10053

cpnsMeanCdstring · enumOptional

보상수단코드(CS019)

Example: 10Possible values:

mbrTypestringOptional

회원검색종류

Example: 1

loginIdstringOptional

회원ID

Example: kdh9110

cpnsAprvStatCdstring · enumOptional

보상승인상태코드(CS021)

Example: 10Possible values:

cpnsPayStatCdstring · enumOptional

보상지급상태코드(CS020)

Example: 10Possible values:

userTypestringOptional

처리자검색종류

Example: 1

userIdstringOptional

담당자ID

Example: x2beecc

businessTypestringOptional

업무타입

Example: 1

businessNumberstringOptional

업무번호

Example: 12345

siteNostringOptional

사이트번호

Example: 1

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v2/customerservice/customerCompensMgmt/getCustomerCompensList

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/customerCompensMgmt/getCustomerCompensList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "custCpnsAplyNo": "text",
      "accpDtm": "text",
      "accpCont": "text",
      "cpnsAprvStatCd": "text",
      "cpnsAprvStatNm": "text",
      "cpnsPayStatCd": "text",
      "cpnsPayStatNm": "text",
      "cpnsTypNm": "text",
      "cpnsMeanCd": "text",
      "cpnsMeanNm": "text",
      "rspnGbCd": "text",
      "rspnGbNm": "text",
      "cpnsAmtNo": "text",
      "maxPayLim": "text",
      "overAmt": "text",
      "ccnNo": "text",
      "ordNo": "text",
      "goodsNo": "text",
      "goodsNm": "text",
      "itmNm": "text",
      "loginId": "text",
      "mbrNm": "text",
      "mbrNo": "text",
      "entrNm": "text",
      "acptmnId": "text",
      "aprvDtm": "text",
      "aprmnId": "text",
      "retnDtm": "text",
      "retnProcmnId": "text",
      "payDtm": "text",
      "paymnId": "text",
      "payCont": "text",
      "payReqMemo": "text",
      "payBankCd": "text",
      "payActnNo": "text",
      "payDepositorNm": "text",
      "siteNm": "text"
    }
  ]
}

고객보상 상세 정보 조회

get

기능설명

• 고객보상 상세 정보를 조회 합니다.

---

상세설명

• 선택한 고객보상 상세정보를 조회 합니다.

---

수정번호

• Release v2.00_240905: 고객 보상 대분류 조회 추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

custCpnsAplyNoStringRequired

고객보상신청번호

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/customerCompensMgmt/getCustomerCompensDetailSaveView

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/customerCompensMgmt/getCustomerCompensDetailSaveView?custCpnsAplyNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:21:21.659Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "csCompensDetailResponse": {
      "custCpnsAplyNo": "text",
      "mbrNm": "text",
      "mbrNo": "text",
      "loginId": "text",
      "ccnNo": "text",
      "ordNo": "text",
      "otherCount": 1,
      "goodsNo": "text",
      "goodsNm": "text",
      "promoNm": "text",
      "cpnsMeanCd": "text",
      "cpnsTypNm": "text",
      "cpnsTypLrgNm": "text",
      "rspnGbCd": "text",
      "standard": "text",
      "maxPayLim": 1,
      "cpnsAmtNo": "text",
      "payBankCd": "text",
      "payDepositorNm": "text",
      "payActnNo": "text",
      "cpnsAprvStatCd": "text",
      "cpnsAprvStatNm": "text",
      "cpnsPayStatCd": "text",
      "cpnsPayStatNm": "text",
      "accpCont": "text",
      "payReqMemo": "text",
      "acptmnId": "text",
      "accpDtm": "text",
      "aprmnId": "text",
      "aprvDtm": "text",
      "retnProcmnId": "text",
      "retnDtm": "text",
      "paymnId": "text",
      "payDtm": "text",
      "retnCausCont": "text",
      "dcRateAmt": 1,
      "cpnsConts": "text"
    },
    "loginId": "text",
    "codeList": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "grpCd": "ME001",
          "cd": 11,
          "cdNm": "상품즉시할인",
          "cdDesc": "다국어 코드설명",
          "useYn": "Y",
          "sortSeq": 1,
          "ref1Val": "기준코드 참조1값에 대한 설명",
          "ref2Val": "기준코드 참조2값에 대한 설명",
          "ref3Val": "기준코드 참조3값에 대한 설명",
          "ref4Val": "기준코드 참조4값에 대한 설명",
          "ref5Val": "기준코드 참조5값에 대한 설명",
          "ref6Val": "기준코드 참조6값에 대한 설명",
          "ref7Val": "기준코드 참조7값에 대한 설명"
        }
      ]
    },
    "csCpGradeAmtCode": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "grpCd": "ME001",
          "cd": 11,
          "cdNm": "상품즉시할인",
          "cdDesc": "다국어 코드설명",
          "useYn": "Y",
          "sortSeq": 1,
          "ref1Val": "기준코드 참조1값에 대한 설명",
          "ref2Val": "기준코드 참조2값에 대한 설명",
          "ref3Val": "기준코드 참조3값에 대한 설명",
          "ref4Val": "기준코드 참조4값에 대한 설명",
          "ref5Val": "기준코드 참조5값에 대한 설명",
          "ref6Val": "기준코드 참조6값에 대한 설명",
          "ref7Val": "기준코드 참조7값에 대한 설명"
        }
      ]
    },
    "csCpUserGrade": "text",
    "csCpUserGradeOfAcptmId": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 접수자 권한 조회

get

기능설명

• 고객보상 접수자의 권한을 조회 합니다.

---

상세설명

• 고객보상을 접수한 삼당원의 권한을 조회 합니다.

• N:없음 A:승인요청자 , P:지급승인자 , All:승인요청자 & 지급승인자

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

loginIdStringRequired

로그인한 상담사ID

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/customerCompensMgmt/getCsCompensUserGrade

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/customerCompensMgmt/getCsCompensUserGrade?loginId=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:21:21.659Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}