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

# PG Settlement

## Receive PG Approval Reconciliation List

> \## Function Description\
> \* Receives and saves the PG approval reconciliation list.\
> \---\
> \## Detailed Description\
> \* Receives the PG company's approval reconciliation list information corresponding to the PG type code and the inquiry start/end date and time.\
> \* Saves the approval list information retrieved for PG approval reconciliation.\
> \* Records with deposit confirmation status Y cannot be saved.\
> \---\
> \## Revision History\
> \* \`\`\`Release v1.04\_231120\`\`\`: Initial development of PG approval reconciliation reception\
> \* \`\`\`Release v2.00\_240627\`\`\`: Added Toss PG\
> \* \`\`\`Release v2.00\_240711\`\`\`: For Toss approval reconciliation, set the trdNo value to the payment key for approvals and the transaction key for refunds; excluded the usage status condition when retrieving merchant information<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 Settlement"],"summary":"Receive PG Approval Reconciliation List","description":"## Function Description\n* Receives and saves the PG approval reconciliation list.\n---\n## Detailed Description\n* Receives the PG company's approval reconciliation list information corresponding to the PG type code and the inquiry start/end date and time.\n* Saves the approval list information retrieved for PG approval reconciliation.\n* Records with deposit confirmation status Y cannot be saved.\n---\n## Revision History\n* ```Release v1.04_231120```: Initial development of PG approval reconciliation reception\n* ```Release v2.00_240627```: Added Toss PG\n* ```Release v2.00_240711```: For Toss approval reconciliation, set the trdNo value to the payment key for approvals and the transaction key for refunds; excluded the usage status condition when retrieving merchant information\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":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PgApprovalAdjustReceiveRequest":{"type":"object","description":"PG Approval/Settlement Information Reception Request DTO","properties":{"startDate":{"type":"string","format":"date","description":"Search Start Date"},"endDate":{"type":"string","format":"date","description":"Search End Date"},"pgGbCd":{"type":"string","description":"PG Classification Code (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"}}}}}}
````

## Receive PG Settlement Reconciliation List

> \## Function Description\
> \* Receives and saves the PG settlement reconciliation list.\
> \---\
> \## Detailed Description\
> \* Receives the PG company's settlement reconciliation list information corresponding to the PG type code and the inquiry start/end date and time.\
> \* When the PG settlement information's (settlement amount - VAT - fee) = deposit amount matches the EC system's payment data's payment amount - fee, the deposit is confirmed.\
> \* The EC system's payment data fee is calculated as a fixed rate or fixed amount according to the merchant's fee information.\
> \* Records with deposit confirmation status Y cannot be saved.\
> \---\
> \## Revision History\
> \* \`\`\`Release v1.04\_231120\`\`\`: Initial development of PG settlement reconciliation reception\
> \* \`\`\`Release v2.00\_240627\`\`\`: Added Toss PG\
> \* \`\`\`Release v2.00\_240711\`\`\`: For Toss settlement reconciliation, set the trdNo value to the payment key for approvals and the transaction key for refunds<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 Settlement"],"summary":"Receive PG Settlement Reconciliation List","description":"## Function Description\n* Receives and saves the PG settlement reconciliation list.\n---\n## Detailed Description\n* Receives the PG company's settlement reconciliation list information corresponding to the PG type code and the inquiry start/end date and time.\n* When the PG settlement information's (settlement amount - VAT - fee) = deposit amount matches the EC system's payment data's payment amount - fee, the deposit is confirmed.\n* The EC system's payment data fee is calculated as a fixed rate or fixed amount according to the merchant's fee information.\n* Records with deposit confirmation status Y cannot be saved.\n---\n## Revision History\n* ```Release v1.04_231120```: Initial development of PG settlement reconciliation reception\n* ```Release v2.00_240627```: Added Toss PG\n* ```Release v2.00_240711```: For Toss settlement reconciliation, set the trdNo value to the payment key for approvals and the transaction key for refunds\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":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PgApprovalAdjustReceiveRequest":{"type":"object","description":"PG Approval/Settlement Information Reception Request DTO","properties":{"startDate":{"type":"string","format":"date","description":"Search Start Date"},"endDate":{"type":"string","format":"date","description":"Search End Date"},"pgGbCd":{"type":"string","description":"PG Classification Code (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"}}}}}}
````