---
title: "Retrieve a PaymentIntent status"
method: GET
path: "/payment-intents/{id}/status"
tags: ["Payments"]
---

# Retrieve a PaymentIntent status

`GET /payment-intents/{id}/status`

This endpoint allows you to fetch the status of an existing payment intent from our database.
    You must either provide the "id" or the "token" for us to find that payment intent.
    Retrieving using the "token" is the fastest way and uses a more permissive rate limit (10 requests per 5 seconds).

## Path parameters

- `id` string, required

## Query parameters

- `token` string

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Response `200`

- PaymentIntentStatusDto
  - `id` string, required — Unique identifier for the Payment intent
  - `status` 'action_required' | 'canceled' | 'failed' | 'payment_required' | 'processing' | 'successful', required — Current status of this Payment intent

## Other responses

- `401` — Wrong credentials
- `403` — Forbidden
- `404` — Not Found
- `429` — ThrottlerException: Too Many Requests
- `500` — Internal error

---

[API](https://skmtc.net/hub2/apis/hub2-service-api.md) · [All operations](https://skmtc.net/hub2/apis/hub2-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hub2/hub2-service-api/revisions/adb17b4b80f4/schema)