raya
Conecte Stripe a Athia, configure el acceso del proveedor necesario y verifique la primera sincronización de datos exitosa.
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_…Ve a
- Ir a Desarrolladores → Claves de API y selecciona Selecciona.
- Seleccione 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 Athia solicita#
| campo | ¿Qué es / dónde encontrarlo | 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 y seleccionar y seleccione raya.
- En , introduce un, introduzca y elegir y elija Programación.
- Introducir Credenciales Ingrese 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 Selecciona
- Verificar Conexión Copiar la.
- URL de Destino de Webhook de Athia URL de destino del 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 ahora muestra como ACTIVE y comienza la primera sincronización. Para cada cuenta de Stripe adicional, incluyendo Cuentas Conectadas — cree una clave y una conexión separadas.
Elige una#
Seleccione un 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 Integrando Athia Integración de 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.
- Para saber qué contiene cada campo introducido, consulte Diccionario de Datos de Athia Solución de problemas.
Lo que ves#
| Lo que ve | 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 Integrando Athia
- — rutas de integración, incluyendo transferencias de archivos y entre almacenes. Diccionario de Datos de Athia
- — definiciones de nivel de campo. — definiciones a nivel de campo.