---
title: "Get a payment"
method: GET
path: "/v1/gateway/payment/{id}"
tags: ["Gateway"]
---

# Get a payment

`GET /v1/gateway/payment/{id}`

This endpoint returns only basic information to display to the user to begin the payment flow.

## Path parameters

- `id` string, required — Payment ID

## Headers

- `Api-Key` string, nullable
- `App-Id` string, nullable
- `Client-Id` string, nullable
- `WCP-Version` string, nullable
- `Sdk-Name` string, nullable
- `Sdk-Version` string, nullable
- `Sdk-Platform` string, nullable

## Response `200`

Payment status retrieved successfully

- GetPaymentResponse
  - `amount` Amount, required
    - `display` AmountDisplay, required
      - `assetName` string, required — Full name of the asset
      - `assetSymbol` string, required — Ticker/symbol of the asset
      - `decimals` integer, required — Number of minor decimals of the asset
      - `iconUrl` string, nullable — URL of the icon of the asset (if token)
      - `networkIconUrl` string, nullable — URL of the icon of the network (if token)
      - `networkName` string, nullable — Name of the network of the asset (if token)
    - `unit` string, required — Currency unit, prefixed with either "iso4217/" or "caip19/"
    - `value` string, required — Amount value, in the currency unit's minor units
  - `buyer` BuyerInfo
    - `accountCaip10` string, required — Account CAIP-10
    - `accountProviderIcon` string, nullable — Account provider icon URL
    - `accountProviderName` string, required — Account provider name
  - `expiresAt` integer, required
  - `merchant` MerchantInfo, required
    - `iconUrl` string, nullable — Merchant icon URL
    - `name` string, required — Merchant name
  - `status` 'requires_action' | 'processing' | 'succeeded' | 'failed' | 'expired' | 'cancelled', required — Payment status representing the lifecycle of a payment. Payments progress through these states from creation to terminal status. Some states are specific to the payment source (pull vs push).

## Other responses

- `400` — Invalid request
- `401` — Invalid API key
- `404` — Payment not found
- `500` — Internal error

---

[API](https://skmtc.net/walletconnect/apis/walletconnect-pay-api.md) · [All operations](https://skmtc.net/walletconnect/apis/walletconnect-pay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/walletconnect/walletconnect-pay-api/versions/8e5708191dde/schema)