PG Approval Comparison Management
Performs comparison between the EC system's payment history and the PG company's (Inicis) approval history. Key features include PG approval comparison and PG settlement comparison, which allow adjustment for amount discrepancies and deposit confirmation/cancellation processing.
Key Features
PG Approval Comparison
Perform settlement comparison for records where the EC payment amount and the PG transaction amount are the same.
If the deposit amount, after considering the fee, does not match the EC expected deposit amount, adjust the other adjustment amount.
Deposit confirmation and confirmation cancellation processing are available.
Upon receiving PG settlement information, deposit confirmation is automatically processed.
PG Settlement Comparison
From the PG approval list, perform settlement comparison for records where the EC payment amount and the PG transaction amount are the same.
If the deposit amount, after considering the fee, does not match the EC expected deposit amount, adjust the other adjustment amount.
Deposit confirmation and confirmation cancellation processing are available.
Upon receiving PG settlement information, deposit confirmation is automatically processed.
Process Definition
Compares the site's payment/cancellation history with the PG company's approval/approval-cancellation history.
For records where the amount matches at approval, the deposit information and settlement information are compared.
PG Settlement Comparison Summary Lookup
Look up summary information for the selected search conditions.
Look up the EC system's payment amount, expected fee, and expected deposit amount, along with the sum of the PG company's approval amount, payment fee, and deposit amount, the sum of the adjustment amount, and the EC-PG difference.
API Function List_PG Approval Comparison
PG Approval Comparison Summary Lookup
Look up the summary count and total for the PG approval comparison list.
BO
POST
Receive PG Approval Information
Receive the PG approval list for a specific date and PG company. Receive PG Approval Comparison List - /api/common/v1/adjust/pgCompare/receivePgApprovalList
BO
POST
Save PG Approval Comparison Discrepancy Reason
Save the reason for the comparison discrepancy between the PG approval record and the EC payment record.
BO
POST
Receive PG Approval Comparison List
Receive the PG approval list for a specific date and PG company via the PG company's interface. Receive PG Approval Comparison List - /api/common/v1/adjust/pgCompare/receivePgApprovalList
BO
POST
API Function List_PG Settlement Comparison
PG Settlement Comparison Summary Lookup
Look up summary information for the PG settlement comparison list.
BO
POST
Save PG Settlement Comparison Adjustment Reason
Adjust the amount and save the reason for records with a mismatched deposit amount.
BO
POST
Receive PG Settlement Information
Receive the PG settlement list for a specific date and PG company. *Receive PG Settlement Comparison List - /api/common/v1/adjust/pgCompare/receivePgAdjustList
BO
POST
PG Settlement Comparison Deposit Confirmation/Deposit Confirmation Cancellation Processing
Process deposit confirmation or cancel deposit confirmation for records with a matching deposit amount.
BO
POST
Receive PG Settlement Comparison List
Receive the PG settlement list for a specific date and PG company via the PG company's interface. *Receive PG Settlement Comparison List - /api/common/v1/adjust/pgCompare/receivePgAdjustList
BO
POST
Term Definitions
PG (Payment Gateway)
Enables the use of various payment methods such as card payment, easy payment, bank transfer, virtual account (no-bankbook deposit), gift certificate payment, and mobile phone payment.
Stands for ‘electronic payment agency’.
Other Notes
Currently, the Inicis MID is not issued individually but a shared MID is used, so all test data is transmitted; therefore, to distinguish only X2BEE orders, only order numbers matching the X2BEE order regular expression pattern are saved when saving approval comparison and settlement comparison data.
Pattern.compile("^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])O\d{6}$")
PG Approval Comparison
In the Api-common PG approval information reception API, approval information is retrieved for the MID registered at the “pg.compare” level in application.yml, for the PG company passed in the request.
Data and validity check by PG company upon receiving approval information
Inicis
Validity check: If the received data starts with 0001 (queried from an IP not registered on the merchant server) or 0003 (data items not configured on the merchant admin site), it is treated as an exception
Data: Since all records are transmitted as a String, split each approval record by **" "** and then split each field by **"|"**.
For cancellations before settlement (same-day cancellations), no payment approval data exists in the PG approval list, so approval data is generated directly to reconcile with the EC system.
PG Settlement Comparison
Data and validity check by PG company upon receiving settlement information
Inicis
Validity check: When the header of the received data is split, if the 21st field (error code) is “02 (invalid date format), 03 (MID password error), 04 (IP authorization error), 99 (unknown error)”, it is treated as an exception
Data: Since all records are transmitted as a String, split each approval record by **" "** and extract the actual data (rows starting with B), then split each field by **"|"**.