raya
En esta página
Una única clave de API restringida proporciona a Athia acceso completo a la actividad de Stripe: pagos, autorizaciones y rechazos, reembolsos y disputas, así como los detalles de los pagos realizados y los cobros.
Lo que obtienes#
Pagos y intentos de pago con sus resultados, reembolsos, disputas y la tarifa registrada para cada transacción.
La opción más completa con una sola credencial. Una única clave restringida cubre todos los dominios: no hay informes para habilitar primero, lo que la convierte en el conector más rápido para empezar.
La opción menos detallada en términos de costes. Las tarifas se aplican de forma combinada, por lo que no se pueden dividir las tarifas entre los componentes del esquema y la pasarela. Para trabajar a nivel de tarifas, utilice Adyen o Checkout.com data.
Antes de empezar#
La versión de la API de tu cuenta de Stripe debe ser 2019-02-19 o posterior.
Crea un clave de API restringida (rk_…) para Athia en la consola de Stripe: no tu clave secreta estándar:
- Ve a Desarrolladores → Claves de API y selecciona Crear clave restringida.
- Selecciona Crear tu propia integración y continúa.
- Nombra la clave: por ejemplo,
Athia Integration. - Establece los permisos a continuación.
- Crea la clave y copia el token.
| Accede a | Recursos |
|---|---|
| Leer | Saldo, fuentes de transacciones de saldo, transferencias de saldo, cargos, disputas, eventos, archivos, PaymentIntents, PaymentMethods, Payouts, Productos, SetupIntents, Sources, Tokens, Notas de crédito, Suscripciones, SKUs, Ejecuciones de informes, Tipos de informes. Si utilizas Cuentas Conectadas, también otorga permisos de lectura en los recursos de Conexión, incluyendo los enlaces de Cuenta. |
| Escribir | Puntos finales de Webhook |
Hay tres permisos que pueden ser fácilmente omitidos. Uno detiene la conexión; los otros dos fallan silenciosamente.
| Autorización | Omitirlo y |
|---|---|
| Leer en Eventos | La conexión falla por completo. |
| Leer en Informes — Ejecuciones de informes y Tipos de informes | Los datos de tarifas de tarjetas a nivel de transacción no están disponibles, sin causa aparente. |
| Leer en los recursos de Conexión, incluyendo Enlaces de Cuenta | Los datos de la cuenta conectada no pueden seleccionarse. |
Credenciales que solicita Athia#
| Campo | Requerido | ¿Qué es / dónde encontrarlo |
|---|---|---|
| Nombre | Sí | Su etiqueta para esta conexión: identifique la cuenta de Stripe que cubre |
| Programación | No | ¿Con qué frecuencia consulta Athia a Stripe? |
| Clave de API | Sí | La clave restringida creada anteriormente |
| Marco de tiempo de sincronización histórica | Sí | Todo o Límite de fecha — hasta qué punto se realiza la sincronización hacia atrás |
| Límite de sincronización hacia atrás | Con Límite de fecha | La fecha más temprana a la que se realiza la sincronización hacia atrás |
Configuración de la conexión#
- En Configuración → Conexiones, seleccione + Agregar Conexión y seleccionar raya.
- En Configurar Conector, introduce un Nombre y elegir Programación.
- En Introducir Credencialesy pegar la clave en Clave de API, selecciona una Marco de tiempo de sincronización históricay establecer la Límite de sincronización hacia atrás fecha si Límite de fecha se muestra una.
- Selecciona Verificar Conexión.
- Copiar la URL de Destino de Webhook de Athia mostrada en el asistente.
- En Stripe, vaya a Desarrolladores → Webhooks → Agregar punto finaly pegar esa URL, y seleccionar los eventos
charge.succeeded,dispute.createdypayout.paid. Probar, guardar y habilitar el punto final.
La conexión muestra entonces ACTIVE y comienza la primera sincronización. Para cada cuenta de Stripe adicional, incluyendo Cuentas Conectadas — cree una clave y una conexión separadas.
Cadencia de sincronización#
Elige una Programación que coincida con la frecuencia con la que realiza la conciliación. Una frecuencia de consulta más rápida no mejora los registros de pagos y tarifas, que solo se actualizan cuando Stripe realiza los pagos.
Límites y cosas que saber#
- La sincronización histórica está limitada a un año. Todo Esto permite a Athia acceder a todo el año; Límite de fecha requiere una Límite de sincronización hacia atrás fecha, que no puede ser anterior a un año antes de la fecha actual. Para un historial más antiguo, cárgalo a través de una transferencia de archivo segura (SFTP/S3) — consulta Integrando Athia.
- Las tarifas se combinan. La interchange granular no está disponible a través de este conector.
- Los montos son unidades menores — divididos entre 100. Athia gestiona esto durante la ingestión; es importante al reconciliar con una exportación de Stripe.
- Los datos de la tarjeta están minimizados. Para saber qué contiene cada campo introducido, consulte Diccionario de Datos de Athia.
Solución de problemas#
| Lo que ves | Causa probable | Qué hacer |
|---|---|---|
| La verificación tiene éxito, pero un dominio está vacío | Falta de acceso a ese recurso | Edite los permisos de la clave y vuelva a conectar |
| Menos historial de lo esperado | El límite de un año | Carga el historial anterior a través de una descarga segura de un archivo |
Relacionado#
- Conectores de Athia — el catálogo completo de conectores.
- Integrando Athia — rutas de integración, incluyendo transferencias de archivos y entre almacenes.
- Diccionario de Datos de Athia — definiciones de nivel de campo.