---
title: "Métodos de pago"
description: "Listar y obtener métodos de pago disponibles para la credencial autenticada, sin secretos."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.pagofast.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Métodos de pago

# Métodos de pago

Un método de pago es una configuración concreta usable para cobrar.

Puede representar, por ejemplo:

- Getnet POS de una caja;
- Fiserv POS conectado a un terminal;
- Bancard QR de una sucursal;
- Getnet QR de un comercio.

No se devuelven credenciales, tokens ni configuración sensible.

Las rutas aceptan **API key** o **JWT**:

- con API key (`payment_methods:read`): métodos habilitados para esa key;
- con JWT: métodos propios del owner en el ambiente del deploy.

Para crear o configurar instancias, consultá [Métodos de pago de la cuenta](/resources/account-payment-methods).

## Endpoints

```http
GET /v1/payment-methods
GET /v1/payment-methods/{payment_method_id}
```

## Listar métodos

```http
GET /v1/payment-methods
Authorization: Bearer sk_live_7nWm...
```

### Response

```json
{
  "data": [
{
  "id": "019f704f-89d7-7e83-b3e1-f07c33801024",
  "name": "Getnet caja principal",
  "type": "pos",
  "provider": "getnet",
  "environment": "live",
  "status": "active",
  "capabilities": ["payments", "refunds", "cancellations"],
  "metadata": {
    "terminal_name": "Caja 1"
  },
  "created_at": "2026-07-17T13:00:00.000Z"
},
{
  "id": "019f7052-63ac-7cdf-bf8f-f6a7e14cf767",
  "name": "QR sucursal San Miguel",
  "type": "qr",
  "provider": "getnet",
  "environment": "live",
  "status": "active",
  "capabilities": ["payments", "refunds"],
  "metadata": {
    "store_name": "Sucursal San Miguel"
  },
  "created_at": "2026-07-17T13:05:00.000Z"
}
  ],
  "pagination": {
"limit": 50,
"offset": 0,
"total": 2
  }
}
```

Cuando el listado incluye `pagination`, usa `limit`, `offset` y `total`.

### Campos

| Campo          | Significado                                                |
| -------------- | ---------------------------------------------------------- |
| `id`           | Valor que se envía como `payment_method` al crear un pago. |
| `type`         | Canal normalizado, por ejemplo `pos` o `qr`.               |
| `provider`     | Procesador que ejecuta la operación.                       |
| `environment`  | `test` o `live`.                                           |
| `status`       | Solo un método `active` debe usarse para nuevas operaciones. |
| `capabilities` | Operaciones soportadas por esa configuración.              |
| `metadata`     | Información de presentación no sensible.                   |

Capabilities relevantes: `payments` para crear, `cancellations` para cancelar y `refunds` para devolver. Además de la capability, la API key necesita el scope correspondiente.

## Obtener un método

```http
GET /v1/payment-methods/019f704f-89d7-7e83-b3e1-f07c33801024
Authorization: Bearer sk_live_7nWm...
```

### Response

```json
{
  "data": {
"id": "019f704f-89d7-7e83-b3e1-f07c33801024",
"name": "Getnet caja principal",
"type": "pos",
"provider": "getnet",
"environment": "live",
"status": "active",
"capabilities": ["payments", "refunds", "cancellations"],
"metadata": {
  "terminal_name": "Caja 1"
},
"created_at": "2026-07-17T13:00:00.000Z"
  }
}
```

## Seguridad

Un método inexistente, ajeno o no habilitado para la credencial devuelve:

```json
{
  "error": {
"code": "payment_method_not_found",
"message": "El método de pago solicitado no existe o no está habilitado para esta API key.",
"category": "validation",
"retryable": false,
"request_id": "req_019f704f89d77e83",
"details": {}
  }
}
```

No guardes indefinidamente el catálogo: volvé a listarlo cuando recibas `payment_method_not_found` o cambie la configuración de la cuenta.

Source: https://docs.pagofast.com/resources/payment-methods/index.mdx