DocumentationRecipesAPI ReferenceChangelog
Documentation

Reconciliation Reports

Reconciliation Reports

2C2P provides daily reconciliation reports to help merchants reconcile payment transactions. Reports are delivered via SFTP in CSV format with comprehensive transaction-level data including amounts, fees, taxes, and payment details.

📘

Report Types

  • IPP Reconciliation Report - Installment Payment Plan transactions with term details, interest rates, and monthly payment breakdowns
  • Non-IPP Reconciliation Report - Full payment transactions including credit cards, debit cards, e-wallets, and alternative payment methods

Both reports follow the same file structure and field definitions, with IPP-specific fields populated only for installment transactions.

How It Works

SFTP Delivery

Reconciliation reports are automatically generated and delivered to your designated SFTP server daily. You do not need to request reports - they are pushed automatically at the scheduled settlement time.

👍

Connect using SFTP

  • IP Address : 52.76.184.174
  • Port : 22
  • Username : The merchant must fill in the SFTP setup form and send the request to support team. An account will be created for merchant to access 2c2p SFTP in demo and production environment.
  • Request Path : /input ( For File Pickup )
  • Response Path : /output ( For File Drop )
File InformationTime
Reconciliation report file dropBefore 4:00AM GMT+7
SimpleAuthorization file pickup5:00AM GMT+7
SimpleAuthorization file dropBefore 6:00AM GMT+7
OfflineAuthorization file pickup2:00PM GMT+7
OfflineAuthorization file dropBefore 6:00AM GMT+7 (next day)
Tokenization/Refund file pickup2:00AM GMT+7
Tokenization/Refund file dropBefore 3:00AM GMT+7
Quickpay/Promocode file pickupEvery hour
Quickpay/Promocode file dropWithin the next hour

File Naming Convention

Reconciliation report filenames follow a standardized format:

Reconcile2c2p_B_v2.4_MID_CURRENCY_yyyy-MM-dd_HHmmss.csv

Example:

Reconcile2c2p_B_v2.4_JT_THB_2024-06-22_153136_all.csv
Reconcile2c2p_B_v2.4_JT_THB_2024-06-22_153136_ipp.csv
Reconcile2c2p_B_v2.4_JT_THB_2024-06-22_153136_nonIpp.csv
ComponentDescription
Reconcile2c2p_B_v2.4Report identifier and version
MIDMerchant ID (e.g., JT)
CURRENCYSettlement currency (e.g., THB, SGD, MYR)
yyyy-MM-dd_HHmmssGeneration timestamp
_all / _ipp / _nonIppReport type suffix

File Format Specification

PropertyValue
FormatCSV (Comma-Separated Values)
Parameter DelimiterComma (,)
Record DelimiterLine Break (\n)

Report Structure

Reconciliation reports contain two record types:

Header Record (TYPE_TABLE = H)

Summary line containing merchant bank account details, pay-in date, and aggregate totals.

2C2P2023102301,2,H,test,0,12/10/2023,test,23/10/2023,000000,00/00/00,000000,702702000000000,00000000000000000000,00000000000000000000,000,000,000,4020.00,0.00,0.00,0.00,0.00,,,,,,,0.00,4020.00,0.00,SGD,000000,0,0,,,,,,,1340.00,,,,0.00,0.00,0.00,,,,,,,,,,,,,,,,,,,,,,,,,

Detail Records (TYPE_TABLE = D)

Transaction-level data for each payment, refund, or chargeback. Each row includes payment details, fees, taxes, and settlement information.

2C2P2023102301,1,D,test,0,12/10/2023,test,11/10/2023,130643,11/10/2023,000000,702702000000000,rT1qtTw8siLut3MWQajjxPtLE,,006,VI,BANCO DAVIVIENDA S.A.,2010.00,0.00,0.00,0.00,0.00,
2C2P2310110037,11/10/2023,1.65,0.10,1.75,,0.00,2010.00,0.00,SGD,368938,05,491647XXXXXX8295,36050,SHOPIFY,,,,0.00,670.00,M,3,0.00,0.00,0.00,0.00,,,,COL,VI,8041222,2C2P SG Test B,,Chow Sum,Payment for rT1qtTw8siLut3MWQajjxPtLE,,0.00,,,,,0.00,,,,,,,,

Download and Process Reports

  1. Connect to SFTP server using credentials provided by 2C2P
  2. Download the report file from /output path
  3. Parse the CSV using your preferred tool
  4. Reconcile transactions against your internal records

Data Parameters

The reconciliation report contains the following fields. For detailed field definitions, data types, and mandatory/optional status:

Report Version History

VersionRelease DateKey Changes
v2.42026Added Payment Type 016 (Loyalty Refund) for automatic loyalty refund adjustment handling
v2.32026Added AGENT_CHANNEL_CODE (column 85); renamed PAYMENT_CHANNELCHANNEL_CODE, PAYMENT_AGENT_SERVICEAGENT_CODE
v2.22026Added CARDTYPE, CARDLEVEL fields (columns 83-84)
v2.12026Added BACKEND_REFERENCE, REFUND_CHARGEBACK_FEE, REFUND_CHARGEBACK_VAT (columns 80-82); amount precision increased to 5 decimal places
v2.02025Added BACKEND_REFERENCE, REFUND_CHARGEBACK_FEE, REFUND_CHARGEBACK_VAT
v1.82025Added loyalty/voucher fields: REDEEMED_POINTS, REDEEM_POINTS_AMOUNT, VOUCHER_DESCRIPTION, REDEEM_VOUCHER_AMOUNT, REDEEMED_VOUCHERS_COUNT, PAYMENT_TYPE_NAME
v1.72025Added EWT_AMOUNT, CUSTOM_DATA_ONE, CUSTOM_DATA_TWO
v1.62025Added MCP fields: ACQUIRER_DISCOUNT, ACQUIRER_DISCOUNT_CURRENCY, MCP_AMOUNT, MCP_CURRENCY, MCP_EXRATE
v1.52024Added QR_REF_ID, CARDHOLDER_NAME, PRODUCT_DESCRIPTION, PROMOTION_CODE
v1.32024Added TRANSACTION_ID, MERCHANT_NAME
v1.22024Added CARD_BRAND
v1.12024Added ISSUER_COUNTRY

Related Documentation


Need Help?

Contact 2C2P Technical Support at [email protected] for:

  • SFTP account setup or credential resets
  • Report delivery issues or missing files
  • Field clarifications or reconciliation discrepancies