> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paybyrd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Transactions

You can query a specific transaction to retrieve detailed information about it. This is useful when a Paybyrd webhook is not received or a technical issue prevents your software from receiving a payment response. Without this response, your staff may be unable to verify whether the transaction was processed or what its result was. They may also attempt to cancel or refund the transaction, or inadvertently create a duplicate.

## Query a transaction

Example request and response for the Query transactions endpoint:

```bash Query Transaction Request theme={null}
curl --request GET \
  --url https://gateway.paybyrd.com/api/v2/transactions/{transactionId} \
  --header 'Accept: application/json' \
  --header 'x-api-key: {your_api_key}'
```

```json Query Transaction Response (Success) theme={null}
{
   "referencedTransactions":[],
   "code":"BYRD200",
   "description":"Operation successfully completed",
   "currency":"EUR",
   "orderRef":"ORDER#3570",
   "brand":"VISA",
   "operationType":"Payment",
   "status":"Success",
   "fingerPrint":"fb1714e5-f2a4-40c8-b3e6-7487187bdaab",
   "createdDate":"2021-06-08T22:07:37Z",
   "transactionDate":"2021-06-08T22:07:37Z",
   "capturedDate":"2021-06-08T22:08:06Z",
   "maskedCardNumber":"420000******0000",
   "initiatedFrom":"HostedForm",
   "subscriptionGuid":"476f8d2c-22ee-42a0-b986-0d01b9292c49",
   "personId":78,
   "index":2,
   "externalSessionIdentifier":"f31a836d-42c6-41c7-b0d0-109d64efb133",
   "externalTransactionIdentifier":"b1b2cf19-e9fe-4b7c-be1a-a12f0f8899f2",
   "externalCustomIdentifier":"8cb922ee-01cd-453d-90b9-b377e4f1d38b",
   "transactionId":"8cb922ee-01cd-453d-90b9-b377e4f1c3cb",
   "amount":"5.00",
   "acquirerEntity": "11854",
   "acquirerReference": "999999935"
}
```

***

## Query a transaction by acquirer custom identifier

Example request and response for querying a transaction by acquirer custom identifier:

```bash Query Transaction Request theme={null}
curl --request GET \
  --url https://gateway.paybyrd.com/api/v2/transactions?acquirerCustomId=${customIdentifier} \
  --header 'Accept: application/json' \
  --header 'x-api-key: {your_api_key}'
```

```json Query Transaction Response (Success) theme={null}
[
    {
        "currency": "EUR",
        "acquirer": "SIMULATED",
        "brand": "MASTER",
        "paymentMethod": "Card",
        "operationType": "Payment",
        "status": "Success",
        "fingerPrint": "f7f76173-f357-4863-bbc3-f5b6204a2769",
        "createdDate": "2025-05-12T18:04:38Z",
        "transactionDate": "2025-05-12T18:04:38Z",
        "capturedDate": "2025-05-12T18:04:41Z",
        "maskedCardNumber": "555534******1115",
        "authorizationCode": "327161",
        "initiatedFrom": "Server",
        "subscriptionGuid": "b9852997-0e6a-4542-a9fd-e9ae76967653",
        "personId": 10,
        "expiresAt": "2025-05-12T18:19:39Z",
        "attempt": 0,
        "index": 0,
        "externalSessionIdentifier": "b7fc1639-6dda-4c20-b618-097ef1e4e842",
        "externalTransactionIdentifier": "b15dc08a-277e-4c24-95e4-0ceb10540efd",
        "externalCustomIdentifier": "bc0a8270d48b4a3d9f1bf0a4eab365dc",
        "acquirerResponseCode": "00",
        "acquirerResponseMessage": "Success",
        "card": {
            "holder": "Jane Jones",
            "number": "555534******1115",
            "expiresAt": "12/25",
            "installments": 1,
            "installmentAmount": 2634,
            "isPayerTraveling": false,
            "countryCode": "QAT"
        },
        "acceptTokenization": true,
        "cardInfoComposition": {
            "cardServiceType": "Credit",
            "sourceEnvironment": "Online",
            "cardCommercialType": "Corporate",
            "cardIssueLocation": "NonEea"
        },
        "transactionId": "bc0a8270-d48b-4a3d-9f1b-f0a4eab365dc",
        "amount": "26.34",
        "isoAmount": 2634
    }
]
```

***

See the [Query transactions API endpoint](/api-reference/transactions/query) for more details.

The **status** field indicates whether the transaction was processed successfully.

<Note>See the full list of the possible status at [Transaction Status page](ref:appendix-transaction-status).</Note>