---
title: "Follow a payment or refund live"
method: GET
path: "/poslink/v3/payment-requests/{payment-request-id}"
tags: ["Payment Requests"]
---

# Follow a payment or refund live

`GET /poslink/v3/payment-requests/{payment-request-id}`

## Request

- Base URL: `https://api.teya.com`
- URL: `https://api.teya.com/poslink/v3/payment-requests/{payment-request-id}`
- Auth: OAuth 2
  - Authorization code: `https://id.teya.com/oauth/v2/oauth-authorize`
  - Token URL: `https://id.teya.com/oauth/v2/oauth-token`
- TypeScript: <https://skmtc.dev/teya/apis/poslink-api/docs/poslink/v3/payment-requests/:payment-request-id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single payment or refund and then keeps delivering its status changes as they happen, so you can show the customer live progress on screen.

**What to send:** the identifier of the payment or refund you want to follow.

**What you get back:** first the full details — the amount, whether it is a sale or a refund, its current status, and, where relevant, the reason behind that status. After that, you keep receiving updates as the status changes (for example, waiting for the card, then the final result). Once it reaches a final outcome — successful, failed, or cancelled — the final details are sent and the connection closes. If it is already finished when you ask, you get the full details once and the connection closes straight away.

**Required Scopes (one of the following):**

- `payment_requests/id` (returned via the register API: `POST /poslink/v1/epos/register`)
- `default_access` (deprecated, will be removed in the future; included for backward compatibility with existing integrations)

## Path parameters

- `payment-request-id` string, uuid, required

## Response `200`

The payment or refund, followed by live status updates

## Other responses

- `400`: Bad request
- `401`: Lacks valid authentication credentials for the requested resource
- `403`: The server understands the request but refuses to authorize it
- `404`: Payment request not found
- `408`: Request timeout
- `429`: Too many requests in a given amount of time
- `500`: Internal Server Error

---

[API](https://skmtc.dev/teya/apis/poslink-api.md) - [All operations](https://skmtc.dev/teya/apis/poslink-api/llms.txt) - [OpenAPI document](https://skmtc.dev/teya/apis/poslink-api/revisions/cc7c1bd11e93?raw)