---
title: "Fetch a Payment"
method: GET
path: "/v1/transit/payment/{payment_id}"
tags: ["Crypto Orchestration"]
---

# Fetch a Payment

`GET /v1/transit/payment/{payment_id}`

Retrieve payment details by payment ID

## Path parameters

- `payment_id` string, uuid, required

## Response `200`

Payment details retrieved successfully

- object
  - `data` object
    - `payment_id` string, uuid
    - `integration_type` string
    - `quote_id` string, uuid
    - `status` 'PAY_INIT' | 'PAY_PROCESS' | 'PAY_SUCCESS' | 'PAY_FAILED' | 'PAY_TIMEOUT' | 'PAY_CANCEL' | 'SETTLEMENT_INIT' | 'SETTLEMENT_HOLD' | 'SETTLEMENT_SUCCESS' | 'SETTLEMENT_FAILED'
    - `create_time` integer
    - `payment_info` object
      - `pay_id` string
      - `merchant_trade_no` string
      - `amount` string
      - `status` 'PAY_INIT' | 'PAY_PROCESS' | 'PAY_SUCCESS' | 'PAY_FAILED' | 'PAY_TIMEOUT' | 'PAY_CANCEL'
      - `currency` string
      - `currency_type` string
      - `expire_time` integer
      - `payment_time` integer — 0 until PAY_SUCCESS
    - `settlement_info` object, nullable — null until PAY_SUCCESS
      - `settlement_via` 'ONE_TO_ONE' | 'MARKET_ORDER' | 'FEE_RETENTION'
      - `wallet_address` string
      - `currency` 'USDC' | 'USDT' | 'BTC' | 'ETH'
      - `rail` 'SOLANA' | 'BITCOIN' | 'ETHEREUM' | 'BASE'
      - `amount` string
      - `trx_hash` string
      - `settle_time` integer
      - `status` 'SETTLEMENT_INIT' | 'SETTLEMENT_HOLD' | 'SETTLEMENT_SUCCESS' | 'SETTLEMENT_FAILED'
      - `retry_attempts` integer

## Other responses

- `401` — Authentication failed due to invalid credentials
- `403` — Payment ID doesn't belong to you
- `404` — Payment ID not found

---

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