Implementation guides
Reconcile activity
Reconciliation should explain how a payment in your system became a financing obligation in Axiym and how that obligation changed over time.
Build a stable identifier chain
Store these relationships when they first become available:
| Your record | Axiym record |
|---|---|
| Your client identifier | clientId |
| Your original payment identifier | receivableId and paymentTransaction.paymentId |
| Funding request attempt | Idempotency key and X-Request-Id |
| Webhook delivery | Event id, type, timestamp, and related resource identifiers |
| Repayment or refund intent | Idempotency key, amount, currency, rail, and affected client |
Do not use a description, amount, or timestamp as the only join key.
Reconcile current state
For each client and accounting period:
- List the client's receivables and follow every page.
- Retrieve individual receivables when detailed disbursement or repayment transactions are required.
- Retrieve the client's credit accounts.
- Join those resources to your original payments, accepted financial operations, and stored events.
- Investigate missing, duplicated, or contradictory records before closing the period.
Values to compare
At minimum, compare:
- the funded payment amount and
initialPrincipal; currentPrincipaland recorded repayment transactions;repaymentAmountand the total obligation represented in your ledger;- credit-account
availableBalanceandprincipalOutstanding; and - resource state fetched from the API against the latest event you processed.
Events are an audit input, not the balance source of truth. If an event was missed or delivered out of order, rebuild current state from the list and get endpoints.
Recovery checks
Run periodic recovery jobs that:
- revisit recently changed clients and receivables;
- compare stored event IDs to processed IDs;
- follow all list pages;
- preserve unfamiliar statuses for investigation; and
- alert on financial records that cannot be joined to a known client payment.
The current PNSL contract does not expose a separate statement resource. Use receivables, their transaction records, credit accounts, and your own ledger as the reconciliation set.