> For the complete documentation index, see [llms.txt](https://startbutton.gitbook.io/startbutton-product-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://startbutton.gitbook.io/startbutton-product-api/webhooks/transaction-status-query.md).

# Transaction Status Query

## Transaction Status Query

Alternative to listening to events by using a webhook URL, you can request/call for the transaction status. This requires making a `GET` request at regular intervals to get the final status of a request.

**Base URL:** See [Environments & Base URLs](/startbutton-product-api/getting-started/environments-and-base-urls.md) — single shared base URL for sandbox and production.

`GET` - `{{baseurl}}/transaction/status/:reference`

| Header        | Value               |
| ------------- | ------------------- |
| Authorization | `Bearer SECRET_KEY` |
| Content-type  | `application/json`  |

**Sample payload for transfer:**

```json
{
    "success": true,
    "message": "transaction fetched",
    "data": {
        "transaction": {
            "gatewayReference": null,
            "_id": "64f42c68ecfd2f6f1xxxxxxx",
            "transType": "transfer",
            "status": "pending",
            "feeAmount": 1500,
            "merchantId": "64459778bf350cc65xxxxxxx",
            "transactionReference": "1481fxxxxxxx",
            "userTransactionReference": "aedxxxx",
            "isRecurrent": false,
            "createdAt": "2023-09-03T06:49:12.509Z",
            "updatedAt": "2023-09-03T06:51:11.016Z",
            "amount": 100,
            "currency": "NGN",
            "recipient": {
                "recipientName": "John Doe",
                "currency": "NGN",
                "institutionType": "nuban",
                "institutionName": "Providus Bank",
                "institutionNumber": "54004xxxxx",
                "_id": "64f33cca80649e4fxxxxxxx"
            }
        },
        "authorizationCode": null
    }
}
```

**Sample payload for collection (Re-charge disabled):**

```json
{
    "success": true,
    "message": "transaction fetched",
    "data": {
        "transaction": {
            "_id": "64fb69a68a6f0187bxxxxxxx",
            "transType": "collection",
            "status": "successful",
            "merchantId": "64459778bf350cc65xxxxxxx",
            "transactionReference": "401f69xxxxxx",
            "userTransactionReference": "aedxxxx",
            "customerEmail": "test1@email.com",
            "paymentCode": "ugjhxxxxx",
            "isRecurrent": false,
            "postProcess": null,
            "gatewayReference": null,
            "createdAt": "2023-09-08T18:36:22.214Z",
            "updatedAt": "2023-09-08T18:59:00.375Z",
            "feeAmount": 12.5,
            "amount": 50000,
            "currency": "NGN"
        },
        "authorizationCode": null
    }
}
```

**Sample payload for collection (Re-charge enabled):**

```json
{
    "success": true,
    "message": "transaction fetched",
    "data": {
        "transaction": {
            "_id": "64fb69a68a6f0187bxxxxxxx",
            "transType": "collection",
            "status": "successful",
            "merchantId": "64459778bf350cc65xxxxxxx",
            "transactionReference": "401f69xxxxxx",
            "userTransactionReference": "aedxxxx",
            "customerEmail": "test1@email.com",
            "paymentCode": "ugjhvjhvv",
            "isRecurrent": false,
            "postProcess": null,
            "gatewayReference": null,
            "createdAt": "2023-09-08T18:36:22.214Z",
            "updatedAt": "2023-09-08T18:59:00.375Z",
            "feeAmount": 12.5,
            "amount": 50000,
            "currency": "NGN"
        },
        "authorizationCode": "5cb5047xxxxxxx"
    }
}
```

> `amount` is in fractional unit.