Skip to content
API reference
/
/
Fetch payin transaction

Fetch payin transaction

Request

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

Security
bearerAuth
Path
payinIdstringrequired

Payment transaction ID

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

Responses

Payment transaction details

Bodyapplication/json
idstringrequired

Unique identifier for the pay-in transaction.

Example:"944732c4608c441aa91379478b91f76e"
amountnumberrequired

Processed pay-in 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-000201"
currencystringrequired

Processed pay-in currency (may differ from initialCurrency after conversion).

Example:"EUR"
statusstringrequired

PayIn transaction status.

Enum:"CREATED""PENDING""PENDING_3DS""SUCCESS""REFUNDED""PARTIALLY_REFUNDED""DECLINED""FAILED""TIMEOUT""REFUND_FAILED"
Example:"SUCCESS"
initialAmountnumberrequired

Requested pay-in amount.

Example:100
initialCurrencystringrequired

Requested pay-in currency.

Example:"EUR"
routerIdstring

Router the transaction was processed through.

returnUrlsobject(ReturnUrls)required

Return URLs after the transaction is finished. A redirect does not confirm the final status; use webhooks or the GET transaction endpoint.

cardIdstring

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

Example:"944732c4608c441aa91379478b91f76e"
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.

Example:"7094c34678b3a4e29bcb5149266d1c811de2b6fc9370be9d5acdd7a334d8852b"
merchantPspIdstring

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:"944732c4-608c-441a-a913-79478b91f76e"
pspTransactionIdstring

PSP-side transaction ID.

Example:"944732c4-608c-441a-a913-79478b91f76e"
statusReasonobject(PayInStatusWithReason)

PayIn transaction status with a detailed reason.

previousTransactionCountinteger, (int32)

Number of previous transactions the customer made in your system.

metadataobject(TransactionMetadata)

Transaction metadata

transactionTypestring

Transaction type.

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

User-provided additional data for Alternative Payment Methods.

pspAdditionalDataobject

Additional data obtained from 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-000201",
  "currency": "EUR",
  "status": "SUCCESS",
  "initialAmount": 100,
  "initialCurrency": "EUR",
  "cardMask": "1234 56** **** 1234",
  "cardBrand": "VISA",
  "merchantPspId": "944732c4-608c-441a-a913-79478b91f76e",
  "pspTransactionId": "944732c4-608c-441a-a913-79478b91f76e",
  "transactionType": "CARD",
  "createdAt": "2026-09-25T10:00:00Z",
  "updatedAt": "2026-09-25T10:00:05Z"
}