Reconciliation Concepts

Reconciliation Concepts

Reconciliation is the process of checking a provider event and deciding where it belongs in Symba Payments.

A provider event is a message from a payment provider. It may say that money was received, a transfer succeeded, a transfer failed, or a payment status changed.

A Symba Payments transaction is the record created inside Symba Payments for work such as collecting a repayment, making a deposit, disbursing a loan, or processing a withdrawal.

Most events are matched automatically. Reconciliation is used when Symba Payments needs a person to review the event before it is applied.

Direction

Every provider event has a direction:

  • Inbound means money is coming in, such as a loan repayment or savings deposit.
  • Outbound means money is going out, such as a loan disbursement or savings withdrawal.

Direction matters because it controls which transactions are reasonable matches. An inbound payment should not be linked to an outbound transfer.

Match candidates

A match candidate is an existing Symba Payments transaction that may belong to the provider event. Symba Payments compares details such as amount, reference, phone number, timing, and provider receipt information.

When one candidate is certain enough, Symba Payments can apply it automatically. When there is doubt, the event is shown for review.

Account candidates

Some provider payments are made to an account reference instead of a transaction that already exists in Symba Payments. In that case, Symba Payments can look for a loan account or savings account.

For inbound payments, choosing the account creates the matching transaction:

  • A loan account creates a repayment.
  • A savings account creates a deposit.

For outbound events, users choose from existing open transactions on the account.

Resolution statuses

Provider events can have these statuses:

  • Pending Review: Symba Payments found possible matches and a user must choose.
  • Unmatched: Symba Payments did not find a suitable automatic match.
  • Auto-Applied: Symba Payments matched and applied the event automatically.
  • Manually Accepted: A user accepted a suggested transaction match.
  • Manually Linked: A user selected an account or transaction manually.
  • Manually Rejected: A user rejected a suggested match.
  • Confirmed Unrelated: A user confirmed that the event does not belong to a Symba Payments transaction.