This endpoint allows you to retrieve the current status and full details of a specific Pay-in transaction using its unique event identifier.

Purpose

Status Polling: Check if a transaction has moved from waiting_funds to processing or completed if you are not relying solely on webhooks.
Recovery: Retrieve transaction details (like the generated blockchain_address) if the original response was lost or timed out.
Reconciliation: Verify amounts and exchange rates for specific past events.

Request Parameters

Parameter	Type	Location	Required	Description
`event_id`	UUID	Path	Yes	The unique event ID you generated and sent in the `/v1/event` execution request.
`Authorization`	String	Header	Yes	Your API Key.

Response

The response returns a single GetPayInResponse object containing the current state of the transaction.

Response Body Schema:

Field	Type	Description
`status`	String	API request status (e.g., "success").
`result`	Object	The pay-in data wrapper.
`result.event_id`	String	The event ID used for the lookup.
`result.transaction_id`	String	Paybis internal transaction identifier.
`result.status`	String	Crucial Field. The current state of the pay-in (e.g., `waiting_funds`, `completed`, `failed`).
`result.blockchain_address`	String	The specific crypto wallet address generated for this user to deposit funds.
`result.fiat`	Object	The fiat amount/currency to be credited to your ledger.
`result.crypto`	Object	The crypto amount/currency expected from the user.
`result.rate`	String	The exchange rate applied to this transaction.

Example Response

{
  "status": "success",
  "result": {
    "event_id": "e24b0081-8a83-4705-8cd5-7293f2c1c302",
    "transaction_id": "paybis-tx-998877",
    "status": "waiting_funds",
    "blockchain_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
    "fiat": {
      "amount": "100.00",
      "currency": "EUR"
    },
    "crypto": {
      "amount": "0.05",
      "currency": "ETH"
    },
    "rate": "2000.00"
  }
}

200OK

404Not found