Describe the error the mapping should fix
Identify the source event, current destination account, intended treatment, and affected dates. A mapping change should solve a specific posting problem, such as a refund entering the wrong account or a settlement being treated as new revenue. Have the accounting owner approve the intended result.
Save the current configuration and a representative export before changing it. Confirm whether the connector applies changes only to future activity or can resynchronize history. Do not assume that saving a setting leaves prior entries untouched.
Choose test cases that cover the actual exceptions
Include an ordinary sale, partial refund, fee, payout, and a transaction crossing month-end where relevant. Add another currency or entity only if the business uses it. Record the expected accounts, amounts, dates, and external references before examining the test output.
Use an approved test environment or a documented nonposting preview where available. If the platform lacks one, plan a tightly controlled production change with accounting approval and a clear correction procedure. Do not create fake live customer transactions or move money merely to demonstrate the mapping.
Check the whole accounting event
A sale can reach the correct revenue account while leaving the processor clearing balance wrong. Compare all related entries and reconcile the payout to the bank. Check taxes and discounts under the company's actual accounting treatment rather than inferring them from the net amount.
For an illustrative $100 sale with a $3 fee and a $97 settlement, the corrected flow should explain all three components once. A mapping that fixes the fee but creates another $97 sale has not solved the integration. Keep the test evidence attached to the change approval.
Set a cutover and review the next synchronization
Record the effective date, configuration version, and owner. Confirm how existing errors will be corrected separately from new postings. Avoid rerunning an entire history unless the platform's behavior, duplicate protection, and correction plan are understood.
After the next sync, compare event counts and totals with the source, inspect the test cases, and review the relevant ledger balances. Keep an eye on previously processed references that reappear. Close the change only when the accounting result and the integration's repeat behavior both match the approved expectation.
Sources
Requirements and product details can change. Check the linked guidance for the facts that apply to your situation.
Related reading
Need help with this work?
General information, not personalized accounting, tax, legal, or investment advice. Have the appropriate qualified professional review decisions that depend on your circumstances.