---
title: "Retrieve OCT Payment Request"
method: GET
path: "/v2/payments/oct/{id}/"
tags: ["payments"]
---

# Retrieve OCT Payment Request

`GET /v2/payments/oct/{id}/`

Retrieve a single OCT payment by the `id` returned at creation time. Returns 404 for payments belonging to another partner's consumers.

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

- GetOCTResponse — OCT payment details.
  - `id` string, uuid, required — Unique identifier for this payment. Use it with `GET /v2/payments/oct/{id}/`.
  - `consumer_id` string, uuid, required — External ID of the consumer associated with this payment.
  - `external_payment_card_id` string, uuid, required — External ID of the payment card that was credited.
  - `amount` number, double, required — Gross transfer amount in USD, inclusive of `fee_amount`.
  - `fee_amount` number, double, required — Fee deducted from `amount`. The card receives `amount - fee_amount`.
  - `description` string — Description recorded against the transaction.
  - `direction` 'Push', required — Always `Push` for OCT transactions.
  - `status` 'queued' | 'pending' | 'pending_review' | 'posted' | 'canceled' | 'error' | 'rejected' | 'returned', required — Lifecycle status of a card payment. `pending` is returned at creation; `posted` means funds have settled. `pending_review` indicates the payment is held for compliance review.

## Other responses

- `404` — Payment not found or does not belong to this partner

---

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