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.
Endpoints
GET /v1/payment-methods
GET /v1/payment-methods/{payment_method_id}Listar métodos
GET /v1/payment-methods
Authorization: Bearer sk_live_7nWm...Response
{
"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
GET /v1/payment-methods/019f704f-89d7-7e83-b3e1-f07c33801024
Authorization: Bearer sk_live_7nWm...Response
{
"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:
{
"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.