Payouts: send customer and seller payouts through the same API as payments

Omno Pay-Out lets merchants send customer payouts, marketplace seller payouts and cashback or reward payouts to cards, local payment methods and crypto through the same API they use for payments. Eligibility rules pick a provider that can pay the recipient, the request can move to another route if one fails, and the final status arrives by webhook.

Updated

Webhooks: the final status is pushed to your back office. Credit balances from the webhook, not from the browser redirect. Examples. Values are illustrative.

In 30 seconds

  • Customer payouts, seller payouts and cashback to cards, local methods and crypto use the same API as payments.
  • Eligibility by country, method, customer group and verification level decides which providers may pay each recipient.
  • Close a payout on the final webhook; pending and timed-out payouts can still resolve later.
  • 3 min read
  • 5 features
  • 4 settings you control
Talk to us

What it does

One API for both directions
Pay-In and Pay-Out share authentication, transaction model, statuses and webhook format, so one integration covers money in and money out.
Payouts from the hosted checkout
Customers can receive a payout in the same checkout session they pay in, using methods that are eligible for them.
Direct Link payouts
Backend-driven APM and crypto payouts without any Omno UI, for seller payouts, cashback and other flows your own systems control end to end.
Routing for payouts
Eligibility by country, method, customer group and customer verification level applies to payouts too, so funds only go through providers allowed for that recipient.
Webhook status updates
Every payout reports its final status to your backend by webhook, with Get Transaction Info available for reconciliation.
On this page4 sections

How do payouts work in Omno?

A payout starts from one of two places. In the hosted checkout, the customer opens the payout view in the same session they use for payments, chooses an eligible method and confirms the amount. In Direct Link, your backend calls Omno directly for APM and crypto payouts, such as marketplace seller payouts or cashback, and no Omno UI is shown. Either way the request enters the same API as a payment.

Omno then applies eligibility. Providers that do not pay out in the recipient’s country, do not support the chosen method, or are restricted to other customer groups or customer verification levels (KYC levels in the API) are removed. Routing picks one of the remaining providers and sends the payout. When the provider confirms or rejects it, Omno sends a webhook to your backend with the final status. That webhook, or a call to Get Transaction Info, is what your finance team should use to close the payout.

Payout statuses follow the same pattern as payments. A payout can succeed, be declined by the provider, fail before or at the provider, time out, or stay pending while the receiving bank or wallet processes it. Pending and timed-out payouts can resolve later, so your systems should keep the payout open until a final status arrives instead of retrying blindly and risking a double payment. Using your own reference on every request makes it easy to match the webhook to the payout in your ledger, and the transaction ID Omno returns links the payout to its routing log.

Why are payouts harder than payments?

Payments are pushed by a customer who wants to buy. Payouts are pulled from your balance, under more rules and more scrutiny. Several things make them harder:

  • Coverage is thinner. Not every method that accepts payments can send money back. Some providers accept payments in a country but cannot pay out there.
  • Identity rules are stricter. Many markets expect payouts to go to an account in the recipient’s own name, and refunds often return through the method used to pay.
  • Timing is visible. A slow seller or customer payout is a support ticket and a reason to leave. Customers and sellers notice delays more than they notice fast payments.
  • Funding matters. A provider can only pay out what is available in your balance with that provider, so payout routing has to consider where funds sit.

Treating payouts as part of the same orchestration layer addresses most of these. The same rules that keep a payment away from an unsuitable provider keep a payout away from one too.

What changes versus a single PSP?

With one provider, your payout coverage is that provider’s coverage. If it cannot pay to a local wallet in Uzbekistan or a bank account in Mexico, you either build a second integration or ask customers and sellers to choose something else. If its payout rail is down, customer and seller payouts queue up and support volume rises.

With Omno, payouts can use any eligible provider connected to your account. You can route payouts for a country to the provider with the best payout coverage there, even if a different provider handles most payments. Customer groups let you give high-value customers or top sellers a different payout path. Customer verification levels let you hold back payouts through certain providers until a recipient is verified. All payouts report in one format, so reconciliation does not change when the provider does.

How should finance teams reconcile payouts?

Use the webhook as the trigger and the transaction ID as the key. When a payout webhook arrives with a final status, update your ledger and the customer’s or seller’s balance. For payouts that stay pending longer than expected, call Get Transaction Info rather than guessing. Export payout data from the dashboard by provider, method and period to match against provider statements, and use the routing logs to see which provider handled each payout and why. Omno’s reporting and data export cover payments and payouts in the same format, which keeps month-end work in one place.

Illustrative payout webhook. Field names are simplified; see the API reference for the exact schema.json
{
  "event": "payout.status_changed",
  "transaction_id": "po_93a6f1c8",
  "merchant_reference": "payout-77120",
  "status": "SUCCESS",
  "psp": "psp_d",
  "method": "local_wallet",
  "amount": 300.00,
  "currency": "UZS",
  "customer_id": "customer-5531",
  "completed_at": "2026-10-13T14:02:55Z"
}

Settings you control

Payout routers
Define which providers handle payouts per country and method, and pin a router with routerId when needed.
Verification gating
Require a minimum customer verification level before a recipient can be paid through a given provider.
Customer groups
Give VIP sellers, high-value customers or high-risk groups their own payout providers and rules.
Webhook endpoint
Choose where payout outcomes are delivered so finance can close each payout on the authoritative status.
Developer guide

Frequently asked questions

Are refunds sent as payouts?

No. Refunds are a separate flow, and refunds through Omno are on the roadmap but not available yet. Payouts are their own flow, where eligibility rules decide which payout providers are available for each customer, country and method, and many markets expect funds to go to an account in the customer's own name.

Which methods support payouts?

It depends on the method and the provider. Cards, many local wallets and bank transfer methods support payouts, while some vouchers and cash methods do not. The payment method pages on this site list payout support for each method.

How do I know a payout has been completed?

From the webhook Omno sends with the final status. Do not mark a customer or seller payout as paid on a UI event. If a webhook is delayed, check the status with Get Transaction Info.

Do payouts use the same routing rules as payments?

They use the same eligibility model, filtering by country, method, customer group and customer verification level, with routers configured for payouts. You can keep payment and payout routing separate where providers differ.

it will.

Tell us where your payments fail. We will show you how routing changes the outcome.

esc
↑↓ to move ↵ to open All results