/v1/event/payout/{eventId}

Get a single payout event by its event ID

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retrieve details of a single fiat payout transaction by event ID.

Retrieves the full details of a single fiat payout transaction identified by its event ID.

Purpose

  • Status Polling: Check whether a payout has moved from pending to completed or failed
  • Recovery: Retrieve payout details (like payout_id, beneficiary, or failure_reason) if the original response to /v1/event execution request was lost or timed out.
  • Reconciliation: Verify amounts, reference, and commission for a specific past payout event.

Request Parameters

ParameterTypeLocationRequiredDescription
eventIdUUIDPathYesThe unique event ID you generated and sent in the /v1/event execution request.
AuthorizationStringHeaderYesYour API Key.

Response

The response returns a PayoutEventResponse object. Note there are two distinct status fields:

FieldTypeDescription
statusStringAPI request status (e.g., "success").
resultObjectThe payout data wrapper.
result.event_idStringThe event ID used for the lookup.
result.statusStringEvent status — the state of the overall execution event.
result.payoutObject / nullThe fiat payout details. May be null if the payout hasn't been created yet for this event.
result.payout.payout_idStringPaybis internal payout identifier.
result.payout.statusStringPayout status — the current state of the fiat payout itself (e.g., pending, completed, failed).
result.payout.amountStringThe payout amount.
result.payout.currencyStringThe payout currency.
result.payout.created_atStringTimestamp the payout was created.
result.payout.updated_atStringTimestamp the payout was last updated.
result.payout.referenceStringPayment reference sent to the beneficiary's bank.
result.payout.beneficiaryObjectBusiness or individual beneficiary details.
result.payout.transaction_idString / nullRelated transaction identifier, if applicable.
result.payout.failure_reasonString / nullReason for failure, if the payout failed.
result.payout.commissionObjectCommission amount and currency charged for the payout.

Example Response

{
  "status": "success",
  "result": {
    "event_id": "e24b0081-8a83-4705-8cd5-7293f2c1c302",
    "status": "completed",
    "payout": {
      "payout_id": "paybis-payout-778899",
      "amount": "500.00",
      "currency": "EUR",
      "created_at": "2026-08-20T10:15:00Z",
      "updated_at": "2026-08-20T10:17:32Z",
      "reference": "INV-2026-0456",
      "status": "completed",
      "beneficiary": {
        "type": "individual",
        "first_name": "Jane",
        "last_name": "Doe",
        "iban": "DE89370400440532013000"
      },
      "transaction_id": "paybis-tx-998877",
      "failure_reason": null,
      "commission": {
        "amount": "2.50",
        "currency": "EUR"
      }
    }
  }
Path Params
string
required
Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json