---
title: "Get Payment"
method: GET
path: "/api/v2/payments/{payment_id}"
tags: ["Payments"]
---

# Get Payment

`GET /api/v2/payments/{payment_id}`

Retrieve detailed information about a specific payment by its ID.

## Path parameters

- `payment_id` string, uuid, required — Unique identifier (UUID) of the payment

## Response `200`

Successful Response

- PaymentResponse
  - `id` string, uuid — Unique identifier (UUID) of the payment
  - `amount` string — Payment amount
  - `currency` 'SAR' | 'USD' | 'EUR' | 'GBP' | 'AED' | 'BHD' | 'KWD' | 'OMR' | 'QAR' — ISO 4217 currency codes supported by Moyasar. Includes all currencies supported by Moyasar payment gateway.
  - `scheduled_on` string — Scheduled date and time for the payment
  - `type` 'INITIAL' | 'INSTALLMENT' | 'SPLIT_PREPAID' | 'SPLIT_REMAINDER'
  - `payment_method` 'MADA' | 'MASTERCARD' | 'VISA' | 'APPLE_PAY' | 'SAMSUNG_PAY' | 'AMEX' | 'CASH' | 'PGW_CARD_UNSPECIFIED' | 'BANK_TRANSFER' | 'CARD' | 'QURRAH' | 'BNPL'
  - `current_status` 'PENDING' | 'PROCESSING' | 'FAILED_INITIATION' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' | 'UNDER_REVIEW' | 'EXPIRED' | 'SETTLED' | 'REFUNDED' | 'PARTIALLY_REFUNDED'
  - `payed_at` string, date-time, nullable — Date and time when the payment was completed
  - `refunded_at` string, date-time, nullable — Date and time of the most recent refund
  - `refund_reason` 'REQUESTED_BY_CUSTOMER' | 'DUPLICATE' | 'FRAUDULENT' | 'OTHER'
  - `refund_note` string, nullable — Note for the most recent refund if set
  - `amount_refunded` string — Sum of all refund rows for this payment
  - `refunds` PaymentRefundResponse[] — Refund history for this payment
    - `id` string, uuid — Unique identifier of the refund row
    - `amount_refunded` string — Amount refunded in this refund
    - `refunded_at` string, date-time — When this refund was recorded
    - `refund_reason` 'REQUESTED_BY_CUSTOMER' | 'DUPLICATE' | 'FRAUDULENT' | 'OTHER'
    - `refund_note` string, nullable — Note explaining the refund if applicable
  - `latest_pgw_message` string, nullable — Latest payment gateway message for this payment
  - `amount_in_smallest_unit` integer — Payment amount in smallest currency unit (e.g. halala for SAR).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/streampay/apis/stream-app.md) · [All operations](https://skmtc.dev/streampay/apis/stream-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streampay/stream-app/revisions/515eeea7d260/schema)