---
title: "Obtener Payment"
method: GET
path: "/payments/{encrypted_payment_id}"
tags: ["Payments"]
deprecated: true
---

# Obtener Payment

`GET /payments/{encrypted_payment_id}`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/payments/{encrypted_payment_id}`
- Auth: API key in header `x-api-key`

> **Deprecated.**

Devuelve el detalle de un Payment a partir de su identificador.

Se usa para consultar cómo quedó registrado un pago: el monto, la fecha, el Invoice que salda y el deudor asociado. Cuando el pago tiene un medio de pago asociado, la respuesta también incluye sus datos.

Sirve tanto para los pagos que Toku procesó como para los que se registraron de forma externa; `processed_by_toku` distingue unos de otros. Si el identificador no es válido o no corresponde a un Payment visible para tus credenciales, la llamada responde `404`.

## Path parameters

- `encrypted_payment_id` string, required: Identificador del Payment que se quiere consultar.

## Headers

- `x-account-key` string

## Response `200`

Detalle del Payment.

- PaymentResponse: Detalle de un Payment ya registrado. Es lo que devuelve la consulta de un Payment por su identificador. Reúne el pago, el Invoice que salda, el deudor y los datos del medio de pago utilizado. Los campos que dependen del Invoice o del deudor llegan en `null` cuando el Payment no quedó asociado a un Invoice.
  - `amount` number: Monto pagado. En los pagos registrados de forma externa corresponde al monto informado al registrarlos.
  - `authorization_code` string: Código de autorización entregado al aprobarse el cobro.
  - `buy_order` string: Identificador del documento que respalda el pago.
  - `card_number` string: Últimos dígitos de la tarjeta utilizada. Llega con valor solo cuando el pago tiene un medio de pago asociado con datos de tarjeta.
  - `card_type` string: Tipo de tarjeta utilizada. Llega con valor solo cuando el pago tiene un medio de pago asociado con datos de tarjeta.
  - `created_at` string, date-time, required: Fecha y hora en que el pago quedó registrado en Toku.
  - `customer` string: Customer dueño del Invoice pagado.
  - `deleted_at` string, date-time: Fecha y hora en que el Payment fue eliminado. Es `null` si sigue vigente.
  - `due_date` string: `due_date` del Invoice que se saldó.
  - `government_id` string: Identificador tributario del deudor, tal como está registrado en el Customer.
  - `id` union, required: Identificador del Payment.
    - integer
    - string
  - `invoice` string: Invoice que salda el Payment.
  - `mc_order_id` string: Identificador de la orden en el sistema del medio de pago.
  - `name` string: Nombre del deudor, tal como está registrado en el Customer.
  - `payment_method` string: Medio de pago con el que se pagó, en formato legible.
  - `payment_type` string: Modalidad de la tarjeta con la que se pagó: `Debit`, `Credit` o `Prepaid`.
  - `processed_by_toku` boolean: Es `true` cuando el cobro lo procesó Toku y `false` cuando el pago se registró de forma externa.
  - `product_id` string: `product_id` del Invoice que se saldó.
  - `transaction_date` string, date-time: Fecha en que se realizó el pago.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: Las credenciales no tienen acceso a este recurso.
- `404`: El identificador no es válido o no corresponde a un Payment visible.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas. Reintenta más tarde.

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)