환불

원결제 환불 완료

post

기능 설명

• BO에서 원결제 환불 완료 처리합니다.

---

상세 설명

• 주문 번호(ordNo), 클레임번호(claimNo), 클레임업무유형(claimBusinessType), **시스템유형(systemType)**은 필수로 있어야합니다.

• 대상 클레임을 반품완료처리합니다.

  • 반품완료처리 설명

    • 주문내역구분(OM003) 값이 반품(20) 이고, 주문내역상태(OM005) 값이 회수완료(36) 상태인 경우 처리 가능합니다.

    • API 호출 시점의 주문 상태를 재 확인, 완료 처리 가능 여부를 확인합니다.

    • 주문상세 테이블의 주문내역상태코드(OM005) 값이 반품완료(37) 상태로 변경되며(사은품 포함), 주문완료일시(ordFnshDtm)를 업데이트합니다.

    • 주문배송정보 테이블의 배송완료일시(deliFnshDtm)를 업데이트합니다.

    • 주문시 사용되었던 쿠폰과 주문상품(사은품 포함)의 재고가 복원됩니다. 단, 주문상세의 교환중반품여부(exchMidRtnYn)값이 (Y)인 경우 재고 복원대상에서 제외됩니다.

    • 환불 절차를 진행합니다.

    • 반품 완료 처리 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)

    • 반품 완료 처리 후 처리 이력을 생성합니다.

• 대상 클레임들을 모두 환불 완료 후 결과를 전달합니다.

---

특이 사항

• **클레임업무유형(claimBusinessType)**이 **반품완료(22)**인 경우에 원결제 환불 완료 처리합니다.

Header parameters

AuthorizationanyOptional

Access Token

Bodyobject[]

application/json

원주문 환불완료처리 요청 DTO

claimBusinessTypestring · enumRequired

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

Default: 20Example: 11Possible values:

ordNostringRequired

주문번호

Example: 20230808O007404

ordMediaCdstring · enumRequired

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

Default: 20Example: 20Possible values:

systemTypestring · enumRequired

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

Default: 20Example: 10Possible values:

claimNostringOptional

클레임번호

Example: 20230801C008072

Responses

200

성공

*/*

원주문 환불완료처리 결과 DTO

claimNostringOptional

클레임번호

Example: 20230101C000001

resultCodestringOptional

결과코드

Example: 0000

900

업무처리 오류 내용

*/*

post

/v1/payment/saveRefundBundleApproMgmt

HTTPcURLJavaScriptPython

POST /api/order/v1/payment/saveRefundBundleApproMgmt HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 118

[
  {
    "claimBusinessType": "11",
    "ordNo": "20230808O007404",
    "ordMediaCd": "20",
    "systemType": "10",
    "claimNo": "20230801C008072"
  }
]

[
  {
    "claimNo": "20230101C000001",
    "resultCode": "0000"
  }
]

환불접수 등록

post

기능 설명

• 고객센터에서 고객 보상(현금) 요청 시 환불 정보 테이블에 등록합니다.

---

상세 설명

• 요청한 고객 보상 정보를 환불 정보 테이블에 등록합니다.

• 테이블에 정보 등록이 성공하면 환불번호를 반환합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

환불접수등록 Request DTO

ordNostringOptional

주문번호

mbrNostringRequired

회원번호

mbrNmstringRequired

회원명

loginIdstringRequired

로그인ID

rfdTypCdstringRequired

환불유형코드(OM023)

rfdPrgsStatCdstringRequired

환불진행상태코드(OM024)

rfdBankCdstringRequired

환불은행코드(OM026)

rfdActnNostringRequired

환불계좌번호

rfdActnDepositorNmstringRequired

환불예금주

rfdCausCdstringRequired

환불사유코드(OM025)

rfdActnCertiYnstringRequired

환불계좌인증여부

rfdAmtinteger · int64Required

환불금액

rfdCmsnAmtinteger · int64Required

환불수수료금액

acptmnIdstringRequired

접수자ID

rfdSmsSndYnstringRequired

환불SMS발송여부

Responses

200

성공

*/*

rfdNostringOptional

900

업무처리 오류 내용

*/*

post

/v1/payment/refundAcceptRegister

HTTPcURLJavaScriptPython

POST /api/order/v1/payment/refundAcceptRegister HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 278

{
  "ordNo": "text",
  "mbrNo": "text",
  "mbrNm": "text",
  "loginId": "text",
  "rfdTypCd": "text",
  "rfdPrgsStatCd": "text",
  "rfdBankCd": "text",
  "rfdActnNo": "text",
  "rfdActnDepositorNm": "text",
  "rfdCausCd": "text",
  "rfdActnCertiYn": "text",
  "rfdAmt": 1,
  "rfdCmsnAmt": 1,
  "acptmnId": "text",
  "rfdSmsSndYn": "text"
}

{
  "rfdNo": "text"
}