> 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/store-front-api/common-api/pg.md).

# PG정산

## PG 승인대사목록 수신

> \## 기능설명\
> \* PG 승인대사목록을 받아 저장합니다.\
> \---\
> \## 상세설명\
> \* PG구분코드, 조회 시작/종료일시에 해당하는 PG 사의 승인대사목록 정보를 수신합니다.\
> \* PG 승인대사를 위해 조회한 승인목록 정보를 저장합니다.\
> \* 입금확정여부가 Y인 건은 저장할 수 없습니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.04\_231120\`\`\`: PG승인대사 수신 최초 개발\
> \* \`\`\`Release v2.00\_240627\`\`\`: 토스 PG 추가\
> \* \`\`\`Release v2.00\_240711\`\`\`: 토스 승인대사시 trdNo 값을 승인 일때 결제키, 환불일때 트랜잭션키로 설정, 가맹점정보 조회시 사용여부 조건 제외 처리<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Common API","version":"v1"},"servers":[{"url":"https://api-common.x2bee.com/api/common/","description":"prd"}],"paths":{"/v1/adjust/pgCompare/receivePgApprovalList":{"post":{"tags":["PG정산"],"summary":"PG 승인대사목록 수신","description":"## 기능설명\n* PG 승인대사목록을 받아 저장합니다.\n---\n## 상세설명\n* PG구분코드, 조회 시작/종료일시에 해당하는 PG 사의 승인대사목록 정보를 수신합니다.\n* PG 승인대사를 위해 조회한 승인목록 정보를 저장합니다.\n* 입금확정여부가 Y인 건은 저장할 수 없습니다.\n---\n## 수정번호\n* ```Release v1.04_231120```: PG승인대사 수신 최초 개발\n* ```Release v2.00_240627```: 토스 PG 추가\n* ```Release v2.00_240711```: 토스 승인대사시 trdNo 값을 승인 일때 결제키, 환불일때 트랜잭션키로 설정, 가맹점정보 조회시 사용여부 조건 제외 처리\n","operationId":"receivePgApprovalList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PgApprovalAdjustReceiveRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PgApprovalAdjustReceiveRequest":{"type":"object","description":"PG 승인/정산정보수신 요청 DTO","properties":{"startDate":{"type":"string","format":"date","description":"조회시작일자"},"endDate":{"type":"string","format":"date","description":"조회종료일자"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"}}},"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"}}}}}}
````

## PG 정산대사목록 수신

> \## 기능설명\
> \* PG 정산대사목록을 받아 저장합니다.\
> \---\
> \## 상세설명\
> \* PG구분코드, 조회 시작/종료일시에 해당하는 PG 사의 정산대사목록 정보를 수신합니다.\
> \* PG 정산정보의 (정산금액 - 부가세 - 수수료) = 입금금액이 EC 시스템의 결제 데이터의 결제금액 - 수수료와 같을 시 입금확정처리합니다.\
> \* EC 시스템의 결제 데이터 수수료는 가맹점의 수수료 정보에 따라 정율/정액으로 계산합니다.\
> \* 입금확정여부가 Y인 건은 저장할 수 없습니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.04\_231120\`\`\`: PG정산대사 수신 최초 개발\
> \* \`\`\`Release v2.00\_240627\`\`\`: 토스 PG 추가\
> \* \`\`\`Release v2.00\_240711\`\`\`: 토스 정산대사시 trdNo 값을 승인 일때 결제키, 환불일때 트랜잭션키로 설정<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Common API","version":"v1"},"servers":[{"url":"https://api-common.x2bee.com/api/common/","description":"prd"}],"paths":{"/v1/adjust/pgCompare/receivePgAdjustList":{"post":{"tags":["PG정산"],"summary":"PG 정산대사목록 수신","description":"## 기능설명\n* PG 정산대사목록을 받아 저장합니다.\n---\n## 상세설명\n* PG구분코드, 조회 시작/종료일시에 해당하는 PG 사의 정산대사목록 정보를 수신합니다.\n* PG 정산정보의 (정산금액 - 부가세 - 수수료) = 입금금액이 EC 시스템의 결제 데이터의 결제금액 - 수수료와 같을 시 입금확정처리합니다.\n* EC 시스템의 결제 데이터 수수료는 가맹점의 수수료 정보에 따라 정율/정액으로 계산합니다.\n* 입금확정여부가 Y인 건은 저장할 수 없습니다.\n---\n## 수정번호\n* ```Release v1.04_231120```: PG정산대사 수신 최초 개발\n* ```Release v2.00_240627```: 토스 PG 추가\n* ```Release v2.00_240711```: 토스 정산대사시 trdNo 값을 승인 일때 결제키, 환불일때 트랜잭션키로 설정\n","operationId":"receivePgAdjustList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PgApprovalAdjustReceiveRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PgApprovalAdjustReceiveRequest":{"type":"object","description":"PG 승인/정산정보수신 요청 DTO","properties":{"startDate":{"type":"string","format":"date","description":"조회시작일자"},"endDate":{"type":"string","format":"date","description":"조회종료일자"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"}}},"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"}}}}}}
````