> 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/collections/transaction-statuses.md).

# Transaction Statuses

Collections move through these statuses after initialization.

| Status       | Description                                                                                                                                           | Conclusive |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| `initiated`  | The merchant initialized the transaction.                                                                                                             | No         |
| `pending`    | The transaction has been acknowledged.                                                                                                                | No         |
| `ongoing`    | The customer has not completed authorization.                                                                                                         | No         |
| `verified`   | <p>The processor received and verified payment.<br><br>At this point, you can go ahead to give value to your customers for their purchase/payment</p> | Yes        |
| `successful` | Settlement completed and funds are in your available balance.                                                                                         | Yes        |
| `abandoned`  | No payment arrived after at least one hour.                                                                                                           | Yes        |
| `failed`     | Transaction unsuccessful                                                                                                                              | Yes        |

See [Accept Payments — Overview](/startbutton-product-api/collections/accept-payments-overview.md) to initialize a collection.

### Query a transaction

Use this endpoint to retrieve the latest transaction status. It is an alternative to relying on webhook events.

See [Authentication](/startbutton-product-api/getting-started/authentication.md) before making requests.

`GET /transaction/status/:reference`

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

Replace `:reference` with the transaction reference. Poll until a conclusive status is returned.

### Sample response

{% tabs %}
{% tab title="Collection" %}

```json
{
  "success": true,
  "message": "transaction fetched",
  "data": {
    "transaction": {
      "transType": "collection",
      "status": "successful",
      "transactionReference": "401f69xxxxxx",
      "amount": 50000,
      "currency": "NGN"
    },
    "authorizationCode": null
  }
}
```

{% endtab %}
{% endtabs %}

Amounts are in fractional units.