Fetch payout transaction

API reference

Request

Returns the payout transaction for the given ID. This is the authoritative status check for a payout, used alongside webhooks. Never rely on redirects or client-side events for the final status.

Security

bearerAuth

Path

payoutIdstringrequired

Payout ID. Returned by createPayout.

Example:944732c4608c441aa91379478b91f76e

curl -i -X GET \
  https://api.omno.com/v3/public/payout/944732c4608c441aa91379478b91f76e \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Payout transaction

Bodyapplication/json

idstringrequired

Unique identifier for the payout transaction.

Example:"944732c4608c441aa91379478b91f76e"

amountnumberrequired

Processed payout amount.

Example:100

merchantIdstringrequired

Unique identifier for the merchant.

Example:"944732c4608c441aa91379478b91f76e"

customerIdstringrequired

Omno customer ID.

Example:"944732c4608c441aa91379478b91f76e"

orderIdstringrequired

Merchant-specified order identifier.

Example:"order-2026-000123"

currencystringrequired

Processed payout currency (may differ from initialCurrency after conversion).

Example:"EUR"

statusstringrequired

Payout transaction status.

Enum:"CREATED""WAITING_FOR_CONFIRMATION""PENDING""PROCESSED""REJECTED""FAILED""TIMEOUT"

Example:"PROCESSED"

initialAmountnumberrequired

Requested payout amount.

Example:100

initialCurrencystringrequired

Requested payout currency.

Example:"EUR"

routerIdstring

Router the transaction was processed through.

cardIdstring

Unique identifier for the card, if a saved card was used.

cardMaskstring

Masked card number, if a card was used.

Example:"1234 56** **** 1234"

cardBrandstring

Card brand, if a card was used.

Example:"VISA"

cardHashstring

Card hash, if a card was used.

predictedPspIdstring

PSP predicted by routing before processing.

processorPspIdstring

ID of the PSP that processed the transaction. For test transactions this equals the fake PSP ID provided by Omno — never credit or debit real balances for these.

Example:"944732c4608c441aa91379478b91f76e"

pspTransactionIdstring

PSP-side transaction ID.

previousTransactionCountinteger, (int32)

Number of previous transactions the customer made in your system.

statusReasonobject(PayoutStatusWithReason)

Payout transaction status with a detailed reason.

metadataobject(TransactionMetadata)

Transaction metadata

transactionTypestring

Transaction type.

Enum:"CARD""BANK""WALLET""CASH""CRYPTO""OTHER"

Example:"BANK"

browserobject(Browser)

Customer browser information, collected client-side and required for Direct Link processing (used for 3DS and fraud checks).

additionalDataobject

Method-specific data provided when processing the payout.

pspAdditionalDataobject

Additional data returned by the PSP during processing.

createdAtstring, (date-time)required

Transaction creation time in UTC.

updatedAtstring, (date-time)required

Transaction last update time in UTC.

Response

{
  "id": "944732c4608c441aa91379478b91f76e",
  "amount": 100,
  "merchantId": "944732c4608c441aa91379478b91f76e",
  "customerId": "944732c4608c441aa91379478b91f76e",
  "orderId": "order-2026-000123",
  "currency": "EUR",
  "status": "PROCESSED",
  "initialAmount": 100,
  "initialCurrency": "EUR",
  "processorPspId": "944732c4608c441aa91379478b91f76e",
  "pspTransactionId": "944732c4-608c-441a-a913-79478b91f76e",
  "transactionType": "BANK",
  "createdAt": "2026-09-25T10:00:00Z",
  "updatedAt": "2026-09-25T10:00:08Z"
}