# PG정산
## PG 승인대사목록 수신
> \## 기능설명\
> \* PG 승인대사목록을 받아 저장합니다.\
> \---\
> \## 상세설명\
> \* PG구분코드, 조회 시작/종료일시에 해당하는 PG 사의 승인대사목록 정보를 수신합니다.\
> \* PG 승인대사를 위해 조회한 승인목록 정보를 저장합니다.\
> \* 입금확정여부가 Y인 건은 저장할 수 없습니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.04\_231120\`\`\`: PG승인대사 수신 최초 개발\
> \* \`\`\`Release v2.00\_240627\`\`\`: 토스 PG 추가\
> \* \`\`\`Release v2.00\_240711\`\`\`: 토스 승인대사시 trdNo 값을 승인 일때 결제키, 환불일때 트랜잭션키로 설정, 가맹점정보 조회시 사용여부 조건 제외 처리
````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 값을 승인 일때 결제키, 환불일때 트랜잭션키로 설정
````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"}}}}}}
````
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/common-api/pg.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.