Get a terminal payment

OAuth scope: terminal.read

Retrieves the current status and outcome of a terminal payment by ID.

Use this endpoint to poll for the payment result if you cannot receive webhooks. The status field indicates whether the payment is still pending, was authorized, or was refused.

For a real-time alternative, subscribe to the v1/terminal-payments webhook instead.

GET /v2/terminal_payments/{id}

Get a terminal payment

cURL

curl --request GET \
  --url https://thirdparty.qonto.com/v2/terminal_payments/{id} \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "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"
  }
}

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

200

application/json

Terminal payment details.

terminal_payment · object · required

Show child attributes