Skip to main content
GET
/
v2
/
terminal_payments
/
{id}
Get a terminal payment
curl --request GET \
  --url https://thirdparty.qonto.com/v2/terminal_payments/{id} \
  --header 'Authorization: Bearer <token>'
{
  "terminal_payment": {
    "id": "019dd925-c6cb-7cdd-9e8f-14104f887764",
    "terminal_id": "019d7188-1476-7a74-a7da-01c57793eb93",
    "poi_id": "S1F2-000158252426226",
    "amount": {
      "value": "12.50",
      "currency": "EUR"
    },
    "status": "AUTHORIZED",
    "authorized_amount": {
      "value": "12.50",
      "currency": "EUR"
    },
    "payment_method": "visa",
    "card_summary": "4242",
    "metadata": {
      "order_id": "order-456",
      "table": "12"
    },
    "created_at": "2026-04-29T12:10:24Z",
    "updated_at": "2026-04-29T12:10:26Z",
    "authorized_at": "2026-04-29T12:10:26Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.qonto.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to poll for the outcome of a terminal payment when you cannot receive webhooks. For real-time delivery, subscribe to the v1/terminal-payments webhook instead.

Authorizations

​
Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

​
id
string<uuid>
required

Terminal payment UUID returned in the response body of POST /v2/terminals/{terminal_id}/payment.

Response

Terminal payment details.

​
terminal_payment
object
required