Ozow Hub

Reconcile a settlement

Everything needed to match the money Ozow pays into your bank account against the payments you collected, line item by line item, including the fees that make the two differ.

On this page4 sections
Markdown, linkedMarkdown, everything inlined

A settlementSettlement Ozow paying the money you have collected into your bank account. Payins arrive at Ozow first and are settled to you on a schedule, so what a customer paid you today and what has been settled to you today are different amounts. is one payment from Ozow into your bank account covering many customer payments, minus fees. Reconciling it means proving the amount that arrived is the amount you were owed, and finding the difference when it is not.

List your settlements, fetch each one's line items, match the settlement to your bank statement and the line items to your own records. What is left over is what needs investigating.

Both APIs are here, because a settlement does not move when an integration does. Implement against the One API guide on a new integration. The Payments API guide is the same task on the older contract, and it stays correct for as long as you are collecting through it. The migration guide has no settlements step, so there is nothing to port beyond the endpoints themselves.

Settlements cover payinsPayin A payment made by a consumer to a merchant. The direction most of this site is about: money coming in. Its counterpart is a payout, which sends money out and is not tied to any payment anyone made you. only. FloatFloat The balance held with Ozow that payouts and refunds are paid out of. Both draw on it, and neither will process while it is empty. Payins do not need one, so if you only take payments you never meet it. is the opposite direction, money you pay Ozow to fund refunds and payoutsPayout Money sent from a merchant to a bank account. Unlike a refund, a payout is not tied to a payment anyone made you, so you can pay anyone with a bank account. Payouts draw on your float rather than on your incoming payments, and they are not self-service: they need approval from Ozow and testing in staging first., and a settlement never covers it.

Fees and rounding are where the arithmetic stops matching. Read the guide's sections on both: a reconciliation written without them reports every settlement as short.

What this was built from

Implement against these

Every field name, order and format on these pages is exact.

  • Reconcile settlements: Pull settlement data from One API and tie it back to the deposits in your bank account and the records in your own system, line item by line item.
  • Reconcile settlements: Pull settlement data from the Payments API, the legacy path, and tie it back to the deposits in your bank account and the orders in your own system.

Background

Context for the above. Nothing here is implemented against.

  • How Ozow works: How Ozow connects you to South African banks and payment methods, and the two directions money moves: payins from customers, payouts to recipients.
  • Prerequisites and onboarding: What to have in place before you write any code: a merchant account, Dashboard access, your credentials, and payout eligibility if you need it.
  • Settlements: How Ozow pays what you have collected into your bank account: what a settlement contains, when it arrives, how to track it, and how it meets your float.
  • Transaction and settlement statuses: Every payin, payout, refund and settlement status, which are final, and what to do about each.

The contract

Fetch the OpenAPI document named above to generate a client, or to check a field name or an enum against the schema.