Proveedores de pago

Este es el catálogo de solo lectura de proveedores de pago que Tokeflow sabe orquestar. Cada entrada describe qué admite un proveedor — métodos de pago, países, monedas y capacidades como la tokenización o el 3-D Secure — para que puedas decidir cuáles conectar para un merchant determinado.

Un proveedor solo se vuelve utilizable una vez que un merchant tiene un conector para él, que contiene las credenciales de ese merchant. El catálogo te dice lo que es posible; Conectores te dice lo que está realmente configurado. Tokeflow orquesta estos proveedores — no procesa ni liquida fondos por sí misma.

El objeto de proveedor de pago

Una entrada en el catálogo de proveedores.

Proveedores compatibles

El catálogo que devuelve GET /payment-providers es la fuente de verdad sobre lo que tu organización puede conectar hoy, y se habilita por organización. La lista pública de proveedores compatibles no se publica en esta referencia: cambia a medida que nuevos conectores entran en producción, y no todos los proveedores están disponibles para todas las organizaciones o mercados. Para saber si un proveedor, país o moneda concreto es compatible — o para solicitarlo — contacta con el equipo de Tokeflow, y se habilitará para tu organización cuando esté disponible.

Dos cosas que comprobar en el catálogo antes de construir sobre un proveedor:

• Cargos con credencial almacenada. El flujo en un clic necesita un proveedor que pueda cobrar después una tarjeta guardada. No todos pueden; cuando la credencial del instrumento está en un conector cuyo proveedor no puede, un cargo credential_on_file se rechaza con 400. Pregunta al equipo de Tokeflow cuáles de tus proveedores lo admiten.
• Datos del pagador exigidos. Algunos proveedores exigen la IP del pagador (payer_ip, o la IP de la sesión del Bridge SDK del pagador) y un cliente completo — nombre, documento fiscal, correo electrónico, teléfono y una dirección de facturación con código postal y número de calle — en cargos con tarjeta. Enviarlos en cada cargo deja al enrutamiento libre para elegir cualquier conector.

Endpoints

GET/api/v1/payment-providers

Lista todos los PSPs activos disponibles para conectar (slug, display_name, logo, supported_auth_methods).

Parámetros de consulta

Ejemplo de solicitud

curl -G https://api.tokeflow.com/api/v1/payment-providers \
  -H "Authorization: Bearer sk_live_mer_…" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=20"

Ejemplo de respuesta — 200

{
  "data": [
    {
      "id": "obj_1a2b3c4d",
      "slug": "provider_a",
      "display_name": "Provider A",
      "logo": "https://cdn.example.com/providers/provider_a.svg",
      "is_active": true,
      "supported_auth_methods": [
        "api_key",
        "oauth2"
      ],
      "default_supported_card_brands": ["visa", "mastercard", "amex"],
      "supported_currencies": null,
      "installment_config": { "credit_card": { "min": 1, "max": 12 } }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "total_pages": 3,
    "has_next": true,
    "has_prev": false
  }
}

GET/api/v1/payment-providers/:provider_id

Recupera los detalles de un solo PSP, incluidos los métodos de autenticación admitidos y los indicadores de configuración de OAuth.

Parámetros de ruta

Ejemplo de solicitud

curl https://api.tokeflow.com/api/v1/payment-providers/123 \
  -H "Authorization: Bearer sk_live_mer_…"

Ejemplo de respuesta — 200

{
  "id": "obj_1a2b3c4d",
  "slug": "provider_a",
  "display_name": "Provider A",
  "logo": "https://cdn.example.com/providers/provider_a.svg",
  "is_active": true,
  "supported_auth_methods": [
    "api_key",
    "oauth2"
  ],
  "default_supported_card_brands": ["visa", "mastercard", "amex"],
  "supported_currencies": null,
  "installment_config": { "credit_card": { "min": 1, "max": 12 } },
  "oauth_authorization_url": "https://provider.example.com/oauth/authorize",
  "oauth_token_url": "https://provider.example.com/oauth/token",
  "oauth_scopes": "payments:write",
  "oauth_pkce_required": true
}

Errores

Los errores usan el sobre estándar. Los casos más comunes aquí:

Consulta Errores para ver el catálogo completo.

Relacionados

• Conectores
• Perfiles de enrutamiento
• Upsells y downsells en un clic
• Cómo funciona Tokeflow