Retrieve a payment intent

curl --request GET \
  --url https://api.qint.ch/api/v1/intents/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.qint.ch/api/v1/intents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.qint.ch/api/v1/intents/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "id": "pi_x7k2m9p4q1w8",
  "status": "initiated",
  "amount": 49.9,
  "currency": "CHF",
  "title": "Order #1001",
  "assetSymbol": null,
  "cryptoAmount": null,
  "depositAddress": null,
  "checkoutUrl": "https://checkout.qint.ch/pay/pi_x7k2m9p4q1w8",
  "returnUrl": "https://shop.example.ch/checkout/order-received/1001",
  "createdAt": "2026-07-08T09:15:00+00:00",
  "expiresAt": "2026-07-08T09:30:00+00:00",
  "confirmedAt": null,
  "settledAt": null,
  "reversedAt": null,
  "reversed": false,
  "underpaid": false,
  "feeAmount": null,
  "netAmount": null,
  "settledAmount": null,
  "receivedAmount": null,
  "underpaidBps": null,
  "creditAmount": null,
  "creditCurrency": null,
  "creditRate": null
}

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "An error occurred while processing your request.",
  "status": 400,
  "detail": "currency must be one of: CHF, EUR, USD, GBP.",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "An error occurred while processing your request.",
  "status": 400,
  "detail": "currency must be one of: CHF, EUR, USD, GBP.",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "An error occurred while processing your request.",
  "status": 400,
  "detail": "currency must be one of: CHF, EUR, USD, GBP.",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "An error occurred while processing your request.",
  "status": 400,
  "detail": "currency must be one of: CHF, EUR, USD, GBP.",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}

GET

api

intents

{id}

Retrieve a payment intent

curl --request GET \
  --url https://api.qint.ch/api/v1/intents/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.qint.ch/api/v1/intents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.qint.ch/api/v1/intents/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "id": "pi_x7k2m9p4q1w8",
  "status": "initiated",
  "amount": 49.9,
  "currency": "CHF",
  "title": "Order #1001",
  "assetSymbol": null,
  "cryptoAmount": null,
  "depositAddress": null,
  "checkoutUrl": "https://checkout.qint.ch/pay/pi_x7k2m9p4q1w8",
  "returnUrl": "https://shop.example.ch/checkout/order-received/1001",
  "createdAt": "2026-07-08T09:15:00+00:00",
  "expiresAt": "2026-07-08T09:30:00+00:00",
  "confirmedAt": null,
  "settledAt": null,
  "reversedAt": null,
  "reversed": false,
  "underpaid": false,
  "feeAmount": null,
  "netAmount": null,
  "settledAmount": null,
  "receivedAmount": null,
  "underpaidBps": null,
  "creditAmount": null,
  "creditCurrency": null,
  "creditRate": null
}

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "An error occurred while processing your request.",
  "status": 400,
  "detail": "currency must be one of: CHF, EUR, USD, GBP.",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "An error occurred while processing your request.",
  "status": 400,
  "detail": "currency must be one of: CHF, EUR, USD, GBP.",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "An error occurred while processing your request.",
  "status": 400,
  "detail": "currency must be one of: CHF, EUR, USD, GBP.",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "An error occurred while processing your request.",
  "status": 400,
  "detail": "currency must be one of: CHF, EUR, USD, GBP.",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"
}

Authorizations

Authorization

string

header

required

Authorization: Bearer qk_live_… — a Qint API key created in the dashboard under Developers → API keys.

Path Parameters

string

required

The payment intent id (pi_…).

Response

The payment intent.

A payment intent as returned by the merchant API.

string

required

Payment intent id (pi_…).

Example:

"pi_x7k2m9p4q1w8"

status

enum<string>

required

Lifecycle of a payment intent. Transitions follow initiated → pending → confirmed → settled, with failed, expired and cancelled branches. Terminal states never change again — except that a merchant may resolve an underpaid, expired payment as accepted from the dashboard review queue, which moves it expired → settled.

Available options:

initiated,

pending,

confirmed,

settled,

failed,

expired,

cancelled

amount

number

required

The fiat amount charged.

Example:

49.9

currency

enum<string>

required

The invoice currency. amount, feeAmount, netAmount, settledAmount and receivedAmount are in it; the credit to your balance is in creditCurrency.

Available options:

CHF,

EUR,

USD,

GBP

checkoutUrl

string<uri>

required

The hosted checkout URL for this intent — redirect the buyer here.

Example:

"https://checkout.qint.ch/pay/pi_x7k2m9p4q1w8"

createdAt

string<date-time>

required

expiresAt

string<date-time>

required

End of the payment window — 15 minutes after creation. An unpaid intent is expired after this instant.

reversed

boolean

required

true once the payment has been reversed (reversedAt is set), otherwise false. A flag, not a status: status stays settled. Treat a reversed payment as not paid.

Example:

false

underpaid

boolean

required

true when the buyer sent less crypto than quoted. A flag, not a status. On an open or expired intent it means a short payment was detected; on a settled intent it means the payment settled short within your accepted underpayment (or was accepted from the review queue) and was credited on receivedAmount. See underpayments.

Example:

false

title

string | null

The title passed at creation, if any.

assetSymbol

string | null

The crypto asset the buyer selected at checkout (e.g. USDT). null until the buyer picks one.

cryptoAmount

string | null

The exact crypto amount the buyer must send, as an 8-decimal-place string (e.g. "49.90000000"). null until an asset is selected.

depositAddress

string | null

The deposit address the buyer pays to. null until an asset is selected.

returnUrl

string<uri> | null

The returnUrl passed at creation, if any.

confirmedAt

string<date-time> | null

When the deposit was confirmed on-chain, if it was.

settledAt

string<date-time> | null

When the payment settled, if it did.

reversedAt

string<date-time> | null

Set when the payment partner reversed the payment after it had settled. status stays settled; treat a reversed payment as not paid. See the webhook reversal fields.

feeAmount

number | null

Qint's fee deducted for this payment, in currency. 0 when the buyer paid the fee on top. Computed on the quote (on receivedAmount for a payment settled underpaid), so it agrees with the credit and does not change afterwards. null until status is settled.

Example:

0.25

netAmount

number | null

The credit basis less feeAmount, in currency: amount, or receivedAmount for a payment settled underpaid. Computed on the quote. null until status is settled. The amount added to your balance is creditAmount, in your Account Currency.

Example:

49.65

settledAmount

number | null

The fiat amount (in currency) the payment partner realised for the payment. Booked after settlement, so it is null at first and on most freshly settled payments. For information only: it changes neither feeAmount, netAmount nor the credit.

Example:

null

receivedAmount

number | null

For a payment that is underpaid and short: the fiat amount actually paid (in currency), the basis you are credited on before the fee. null otherwise.

Example:

null

underpaidBps

integer | null

How short an underpaid payment is, in basis points of the expected crypto amount (30 = 0.3 %). null unless the payment is underpaid and short.

Example:

null

creditAmount

number | null

What the payment added to your balance, in creditCurrency, 2 decimal places: netAmount × creditRate, rounded to the cent. Fixed at settlement and never recomputed. null until the payment is credited, and on payments settled before 20 October 2026.

Example:

49.65

creditCurrency

enum<string> | null

Your Account Currency at the time of the quote — the currency creditAmount is in. null until credited.

Available options:

CHF,

EUR,

USD,

GBP

creditRate

number | null

Units of creditCurrency per 1 unit of currency, fixed when the buyer was quoted (e.g. 0.9389 for EUR into CHF). 1 when the two currencies match. null until credited. Before 20 October 2026 this field meant fiat per stablecoin unit.

Example:

1

Merchant API

Payment intents

Currencies

Dashboard

Retrieve a payment intent

Authorizations

Path Parameters

Response