---
title: "Read a sandbox token payment and credit delivery status"
method: GET
path: "/v1/credit-payments/{id}"
tags: ["Credits"]
---

# Read a sandbox token payment and credit delivery status

`GET /v1/credit-payments/{id}`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/credit-payments/{id}`
- Auth: HTTP bearer

Unavailable in production. Read-only; never grants credits. Requires the creating user and exact workspace, with active ownership for teams. Returns no token, client secret, payment method or customer information. A succeeded payment can precede webhook credit delivery. This endpoint uses the dedicated sandbox Stripe account, never the existing live Checkout client.

## Path parameters

- `id` string, required

## Response `200`

Sandbox payment status; credits_added is backed by the ledger

- object
  - `data` object, required
    - `id` string, required
    - `status` 'requires_payment_method' | 'requires_confirmation' | 'requires_action' | 'processing' | 'requires_capture' | 'canceled' | 'succeeded', required
    - `amount_cents` integer, required
    - `currency` 'usd', required
    - `credits` integer, required
    - `credits_added` boolean, required
    - `organization_id` string, uuid, nullable, required
    - `livemode` false, required
    - `status_url` string, required

## Other responses

- `400`: Invalid input or missing Idempotency-Key
- `401`: Authentication required
- `403`: Write permission or active team ownership required
- `404`: Payment or token not found in this account/workspace
- `409`: Operation conflict or unconfirmed execution
- `422`: Token rejected or payment needs unsupported customer action
- `500`: Invalid payment record
- `503`: Sandbox disabled, provider unavailable, or payment outcome unknown

---

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