---
title: "Get a payment"
method: GET
path: "/v1/payments/{paymentId}"
tags: ["Payments"]
---

# Get a payment

`GET /v1/payments/{paymentId}`

Retrieve a single payment by its ID.

## Path parameters

- `paymentId` string, uuid, required

## Response `200`

Payment found.

- object
  - `payment` Payment
    - `id` string, uuid
    - `txId` string — YuvexPay transaction ID.
    - `amount` number — Merchant-requested base amount, in BRL. This is the seller's intended receivable.
    - `feeAmount` number — YuvexPay platform fee, in BRL. When `feePassedToPayer` is true, this equals `payerFeeAmount` and is charged on top of `amount`. When false, this is deducted from `amount` to produce `netAmount`.
    - `netAmount` number — Merchant's net receivable, in BRL. Equals `amount` when `feePassedToPayer` is true; equals `amount - feeAmount` otherwise.
    - `feePassedToPayer` boolean — Resolved decision (after applying the per-payment override, company default, and sub-R$1 forced passthrough) on whether the fee was added on top for the payer.
    - `payerFeeAmount` number, nullable — Fee amount added to the payer's total charge. Null when `feePassedToPayer` is false. When true, payer-charged total = `amount + payerFeeAmount`.
    - `status` 'NEW' | 'PENDING_METHOD_SELECTION' | 'PROCESSING' | 'CONFIRMED' | 'PAID' | 'CANCELLED' | 'EXPIRED' | 'REFUNDED' | 'PARTIAL_REFUND' | 'CHARGEBACK' | 'MED_FROZEN' — Possible payment statuses.
    - `paymentMethod` 'PIX' | 'CARD' | 'BOLETO' — Available public payment methods.
    - `currency` 'BRL' — Supported currencies.
    - `description` string
    - `metadata` object
    - `expiresAt` string, date-time
    - `createdAt` string, date-time
    - `methodData` object — Payment method-specific data (QR code for PIX, barcode for boleto, etc.).
      - `type` 'PIX' | 'CARD' | 'BOLETO' — Available public payment methods.
    - `paidAt` string, date-time, nullable — Timestamp when the payment was confirmed paid. Null until paid.
    - `payer` object, nullable — Payer (debtor) identity captured from the PIX network once the charge is paid. Provider-agnostic. Null for historical records or open-payer charges where no payer data was captured.
      - `name` string, nullable — Payer full name.
      - `document` string, nullable — Payer CPF/CNPJ, returned unredacted when the full value is on file. May be masked (e.g. "75******20") for open-payer charges where only a masked value was provided by the payer's bank.
      - `documentType` 'CPF' | 'CNPJ', nullable — Payer document type.
      - `institutionName` string, nullable — Payer bank/institution name.
      - `institutionIspb` string, nullable — Payer bank ISPB (Banco Central participant identifier).

## Other responses

- `401` — Missing or invalid authentication token.
- `404` — Resource not found.

---

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