---
title: "Credit a confirmed top-up to a key"
method: POST
path: "/v1/topup/claim"
---

# Credit a confirmed top-up to a key

`POST /v1/topup/claim`

## Request

- Base URL: `https://qmax.exchange/api`
- URL: `https://qmax.exchange/api/v1/topup/claim`
- Auth: none declared

Reads the receipt from QPayhub (payer + this key + nonce) and adds the amount paid to the balance. Each payment counts once.

## Request body

- object
  - `keyId` string, required
  - `payer` string, required: Identity that signed the payment
  - `nonce` string, required

## Response `200`

{ ok, creditedQu, balanceQu }

## Other responses

- `400`: No receipt yet, or already credited

---

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