환불

원결제 환불 완료

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 · RefundBundleApproMgmtCUDSaveRequest[]

원주문 환불완료처리 요청 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

POST /api/order/v1/payment/saveRefundBundleApproMgmt HTTP/1.1
Host: api-order.x2bee.com/
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

환불접수등록 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

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

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

{
  "rfdNo": "text"
}

이전증빙서류

다음결제정보

마지막 업데이트 4개월 전