> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/payment-bo-api/undefined-2.md).
# 결제수단 관리
## PG사 목록 수정
> \## 기능설명\
> \* PG사 정보를 수정하는 기능 입니다.\
> \---\
> \## 상세설명\
> \* \[BO] 주문/결제 > 결제수단 관리 > 결제수단 관리 페이지에서 PG사 목록을 수정하고 저장버튼 클릭 시 호출됩니다.\
> \* 공통코드(PG구분코드)에 등록되어있는 결제수단의 연결여부를 수정할 수 있습니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StStdCd":{"type":"object","description":"그룹코드 조회/등록/수정 Request","properties":{"grpCd":{"type":"string","description":"그룹코드"},"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값 설명"},"ref2Val":{"type":"string","description":"참조2값 설명"},"ref3Val":{"type":"string","description":"참조3값 설명"},"ref4Val":{"type":"string","description":"참조4값 설명"},"ref5Val":{"type":"string","description":"참조5값 설명"},"ref6Val":{"type":"string","description":"참조6값 설명"},"ref7Val":{"type":"string","description":"참조7값 설명"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/payment/paymentMethodMgmt/savePgList":{"post":{"tags":["결제수단 관리"],"summary":"PG사 목록 수정","description":"## 기능설명\n* PG사 정보를 수정하는 기능 입니다.\n---\n## 상세설명\n* [BO] 주문/결제 > 결제수단 관리 > 결제수단 관리 페이지에서 PG사 목록을 수정하고 저장버튼 클릭 시 호출됩니다.\n* 공통코드(PG구분코드)에 등록되어있는 결제수단의 연결여부를 수정할 수 있습니다.\n","operationId":"savePgList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}}}},"required":true},"responses":{"200":{"description":"PG사 목록 수정 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## PG사 별 결제수단 등록/수정
> \## 기능설명\
> \* PG사 별 결제수단을 등록하거나 기존에 등록된 결제수단을 수정할 수 있는 기능 입니다.\
> \---\
> \## 상세설명\
> \* \[BO] 주문/결제 > 결제수단 관리 > 결제수단 관리 페이지에서 결제수단목록에 신규 등록하거나 수정하고 저장버튼 클릭 시 호출됩니다.\
> \* PG사 별 결제수단을 신규로 등록하거나 기존에 등록되어있는 결제수단의 연결여부를 수정할 수 있습니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PaymentMethodListRequest":{"type":"object","description":"결제수단관리 DTO","properties":{"createList":{"type":"array","description":"결제수단 신규 등록 List","items":{"$ref":"#/components/schemas/OpPgByPayMean"}},"updateList":{"type":"array","description":"결제수단 수정 List","items":{"$ref":"#/components/schemas/OpPgByPayMean"}}}},"OpPgByPayMean":{"type":"object","description":"PG사별 결제수단 테이블 Entity","properties":{"pgGbCd":{"type":"string","description":"PG구분코드(OM030) 10:이니시스"},"payWayCd":{"type":"string","description":"결제수단코드(OM013) 11:신용카드, 12:실시간계좌이체, 32:마일리지"},"linkYn":{"type":"string","description":"연결여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/payment/paymentMethodMgmt/savePaymentMethodList":{"post":{"tags":["결제수단 관리"],"summary":"PG사 별 결제수단 등록/수정","description":"## 기능설명\n* PG사 별 결제수단을 등록하거나 기존에 등록된 결제수단을 수정할 수 있는 기능 입니다.\n---\n## 상세설명\n* [BO] 주문/결제 > 결제수단 관리 > 결제수단 관리 페이지에서 결제수단목록에 신규 등록하거나 수정하고 저장버튼 클릭 시 호출됩니다.\n* PG사 별 결제수단을 신규로 등록하거나 기존에 등록되어있는 결제수단의 연결여부를 수정할 수 있습니다.\n","operationId":"savePaymentMethodList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMethodListRequest"}}},"required":true},"responses":{"200":{"description":"PG사 별 결제수단을 등록/수정 성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## PG사 목록 조회
> \## 기능설명\
> \* 공통코드에 등록되어있는 PG사 목록을 조회합니다.\
> \---\
> \### 상세설명\
> \* \[BO] 주문/결제 > 결제수단 관리 > 결제수단 관리 페이지에서 PG사 목록을 조회할때 호출됩니다.\
> \* 공통코드인 PG구분코드(OM030)에 등록되어있는 \*\*PG구분코드, PG사명, 사용여부\*\*를 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BaseCommonEntity":{},"RealGridListResponsePaymentMethodResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/PaymentMethodResponse"}}}},"PaymentMethodResponse":{"type":"object","description":"결제수단 DTO","properties":{"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"useYn":{"type":"string","description":"사용여부"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"pgGbCdNm":{"type":"string","description":"PG구분코드명"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명"},"linkYn":{"type":"string","description":"연결여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/payment/paymentMethodMgmt/getPgList":{"get":{"tags":["결제수단 관리"],"summary":"PG사 목록 조회","description":"## 기능설명\n* 공통코드에 등록되어있는 PG사 목록을 조회합니다.\n---\n### 상세설명\n* [BO] 주문/결제 > 결제수단 관리 > 결제수단 관리 페이지에서 PG사 목록을 조회할때 호출됩니다.\n* 공통코드인 PG구분코드(OM030)에 등록되어있는 **PG구분코드, PG사명, 사용여부**를 조회합니다.\n","operationId":"getPgList","parameters":[{"name":"pagination","in":"query","required":true,"schema":{"$ref":"#/components/schemas/BaseCommonEntity"}}],"responses":{"200":{"description":"PG사 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponsePaymentMethodResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## PG사 별 결제수단 목록 조회
> \## 기능설명\
> \* 해당 PG사에 등록되어 있는 결제수단을 조회합니다.\
> \---\
> \## 상세설명\
> \* \[BO] 주문/결제 > 결제수단 관리 > 결제수단 관리 페이지에서 PG사 목록 중 하나의 PG사를 선택하면 호출됩니다.\
> \* 해당 PG사에 등록되어있는 모든 결제수단 목록 및 상세 정보(결제수단명, 연결여부, 수정자, 수정일시)를 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PaymentMethodRequest":{"type":"object","description":"결제수단관리 DTO","properties":{"pgGbCd":{"type":"string","description":"PG구분코드(OM030) 10:이니시스"}}},"RealGridListResponsePaymentMethodResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/PaymentMethodResponse"}}}},"PaymentMethodResponse":{"type":"object","description":"결제수단 DTO","properties":{"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"useYn":{"type":"string","description":"사용여부"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"pgGbCdNm":{"type":"string","description":"PG구분코드명"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명"},"linkYn":{"type":"string","description":"연결여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/payment/paymentMethodMgmt/getPaymentMethodListByPg":{"get":{"tags":["결제수단 관리"],"summary":"PG사 별 결제수단 목록 조회","description":"## 기능설명\n* 해당 PG사에 등록되어 있는 결제수단을 조회합니다.\n---\n## 상세설명\n* [BO] 주문/결제 > 결제수단 관리 > 결제수단 관리 페이지에서 PG사 목록 중 하나의 PG사를 선택하면 호출됩니다.\n* 해당 PG사에 등록되어있는 모든 결제수단 목록 및 상세 정보(결제수단명, 연결여부, 수정자, 수정일시)를 조회합니다.\n","operationId":"getPaymentMethodListByPg","parameters":[{"name":"paymentMethodRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/PaymentMethodRequest"}},{"name":"pgGbCd","in":"query","description":"PG구분코드","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"PG사 별 결제수단 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponsePaymentMethodResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```