---
title: "Pay a Scout credits top-up intent"
method: POST
path: "/api/x402/scout-credits/{topup_id}"
tags: ["Scout Credits"]
---

# Pay a Scout credits top-up intent

`POST /api/x402/scout-credits/{topup_id}`

## Request

- Base URL: `https://flint.network`
- URL: `https://flint.network/api/x402/scout-credits/{topup_id}`
- Auth: API key in header `PAYMENT-SIGNATURE`

x402 resource that settles one Scout credits top-up intent created by POST /api/account/scout-credits/intent. No session is required or accepted here: the intent already bound topup_id to an account, which is what lets a stock x402 client with an unauthenticated discovery request (awal x402 pay <pay_url>, for example) pay it. Every request is gated on the intent first, before any payment work: an unknown topup_id is 404; an already-settled or expired one is 409. Idempotent on settlement: a second successful payment against an already-settled topup_id is never credited twice.

## Path parameters

- `topup_id` string, required

## Response `200`

Payment settled and 100 credits were added to the intent's account.

- ScoutCreditsTopupIntentSettledResponse
  - `ok` unknown, required
  - `topup_id` string, required
  - `credits_added` unknown, required
  - `balance` integer, required
  - `receipt_id` string, required
  - `receipt_url` string, uri, nullable, required

## Other responses

- `400`: Invalid request
- `402`: Canonical x402 v2 payment challenge, with a pay_recipe (awal, script, credits, browser) for ways to pay this exact intent. No protected or expensive work has executed.
- `404`: topup_intent_not_found: no intent exists for this topup_id, or it expired out of storage.
- `409`: topup_intent_already_settled or topup_intent_expired: returned before any payment work when checked up front, or after a real settlement lost a redemption race (in which case the payment settled but was not credited a second time).
- `500`: Server error
- `502`: Upstream graph or service failure

---

[API](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api.md) · [All operations](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/revisions/eb5052b7b5dc?raw)