PayPal directo
Conecte PayPal Direct a Athia, configure el acceso del proveedor necesario y verifique la primera sincronización de datos exitosa.
En esta página
PayPal Direct es un conector auto-servicio: un ID de cliente y una clave secreta, dos ámbitos de lectura y cinco configuraciones de API habilitadas en la aplicación. Es la fuente de disputa más completa del catálogo, y se basa en informes, que definen lo que se puede y no se puede solicitar.
Lo que obtienes#
Transacciones, saldos y pagos realizados, y registros de disputas con su ciclo de vida.
Es el más adecuado para disputas. Los datos de disputa de PayPal son más completos que los de la mayoría, lo que convierte a este conector en el ideal para analizar las tasas de disputa por segmento, los resultados de ganar o perder, y el retraso entre una transacción y la disputa que genera. Las disputas surgen entre 30 y 180 días después, por lo que un historial completo de un año es importante aquí.
Es el menos adecuado para el análisis de fallos a nivel de transacción. La búsqueda de transacciones se basa en informes, que te indican lo que se ha completado, no lo que se intentó, por lo que No están disponibles los códigos de rechazo por intento. here.
Antes de empezar#
Tu cuenta de comerciante debe estar habilitada para pagos directos. Para su uso en tiempo real, se requiere la aprobación de PayPal: solicítala antes de empezar.
En el panel de PayPal, crea una API REST para Athia y anota su Client ID y clave secreta. Esta es la forma normal. Las cuentas de pagos directos existentes utilizan NVP/SOAP en lugar de: Nombre de usuario, Contraseña y Firma.
Debes habilitar exactamente dos ámbitos:
transactions:readpayouts:read
Estos dos ámbitos son de solo lectura: este credencial no puede capturar, reembolsar o enviar dinero.
Habilita la configuración de la API de la aplicación
Las cadenas de ámbito no controlan los datos por sí solas: lo hacen la configuración de la API de la aplicación. Habilita todas las cinco en la aplicación:
| Configuración de la aplicación | Lo que controla |
|---|---|
| Aceptar pagos | Pagos, autorizaciones, capturas, reembolsos |
| Suscripciones | Planes de facturación y registros de suscripción |
| Facturación | Registros de facturas |
| Disputas de clientes | Disputas y su ciclo de vida |
| Búsqueda de transacciones | Historial de transacciones y saldos |
Sin Facturación y Suscripciones habilitado, los datos de facturación y de planes de facturación llegan vacíos.
Crear un rol de solo lectura
Inicia sesión en el panel de desarrollador de PayPal como administrador y crea un rol personalizado: por ejemplo Integración de Athia — con permisos de solo lectura para:
- Transacciones (búsqueda, detalles)
- Informes (saldos, transacciones)
- Pagos (detalles)
- Suscripciones
- La producción y la sandbox son conexiones separadas.
La producción y el entorno de pruebas son conexiones separadas. Crea una aplicación y una conexión de Athia para cada entorno. Utiliza los credenciales de producción para la conexión de producción, o se verifica y no reconoce nada.
Credenciales que Athia solicita#
| campo | Requerido | Qué es / dónde encontrarlo |
|---|---|---|
| Nombre | Sí | Programa |
| Programación | No | Con qué frecuencia Athia consulta a PayPal |
| ID de cliente | Sí | Desde la aplicación que creaste para Athia |
| Clave secreta | Sí | La clave secreta correspondiente para esa aplicación |
| Nombre de usuario / Contraseña / Firma | Solo para sistemas heredados | Credenciales NVP/SOAP: Utilícelas en lugar de Client Id y Clave Secreta en las cuentas de pagos directos existentes. |
Configuración de la conexión#
- Cree la aplicación, habilite la configuración de las 5 API y confirme que ambos ámbitos estén asociados.
- En Configuración → Conexiones, seleccione + Agregar Conexión y seleccione PayPal directo.
- En , ingresar un, introduzca y seleccione Programa Programación.
- Introducir Credenciales , introduzca, introducir ID de cliente y Clave secreta.
- Verificar Conexión Verifique la Conexión.
- URL de destino de Webhook de Athia URL de destino del Webhook de Athia del asistente.
- En la consola de PayPal, vaya a Mis Aplicaciones y Credenciales → seleccione su aplicación → Webhooks → Agregar Webhook, pegue la URL y seleccione
PAYMENT.CAPTURE.COMPLETED,DISPUTE.CREATEDyPAYOUTS.BATCH.PROCESSEDLa conexión muestra entonces
La conexión ahora muestra como ACTIVE y comienza la primera sincronización. Para varias cuentas de comerciantes de PayPal, cree una aplicación y una conexión para cada una.
Cadencia de sincronización#
Los informes de liquidación ofrecen una frecuencia de consulta menor que un conector de puerta de enlace, y una consulta más rápida no proporciona detalles a nivel de intento que la fuente no posee. Sincronice según la frecuencia con la que realmente lee los datos.
Límites y cosas que saber#
- No hay códigos de rechazo por intento. Los importes son decimales
- — nunca los divida por 100. — nunca dividas entre 100.
- Tiempo de resolución de disputas. Las disputas aparecen poco después de la transacción, por lo que las tasas de disputas de períodos recientes siempre parecen mejores de lo que realmente serán. Compare cohortes que hayan tenido tiempo de madurar.
- El historial llega hasta tres años. Transaction Search devuelve hasta tres años de transacciones. Para cualquier cosa anterior, cargue los archivos — vea Los datos de la tarjeta se minimizan..
- El detalle a nivel de campo sobre lo que almacena Athia se encuentra en Detalles a nivel de campo sobre lo que almacena Athia se encuentran en Diccionario de datos de Athia.
Resolución de problemas#
| Lo que ve | Causa probable | Qué hacer |
|---|---|---|
| Las transacciones llegan pero no hay pagos | payouts:read no habilitado | Agregue el ámbito y luego vuelva a conectar |
| No hay razones de rechazo en ninguna parte | Esperado: solo informes de liquidación | Utilice un conector de nivel de puerta de enlace para los datos de intento |
| La verificación falla inmediatamente después de un cambio en el ámbito o los permisos | Permisos nuevos no aplicados aún | Espere hasta 9 horas, luego vuelva a intentar — no reemplace las credenciales |
| Los datos de la factura o plan de facturación están vacíos | Facturación o Suscripciones no habilitado en la aplicación | Habilite la configuración de la aplicación, espere a que se aplique y luego vuelva a conectar |
| No llegan eventos de disputa ni de pago entre las consultas | Webhook no registrado o no habilitado | Reagregue la URL de destino de Webhook de Athia bajo Mis Aplicaciones y Credenciales → Webhooks y habilítela |
| La tasa de disputa parece inusualmente baja | Las transacciones recientes no han alcanzado su período de disputa | Lea la tasa de disputa en cohortes maduras |
Relacionado#
- — el catálogo completo de conectores — catálogo completo de conectores
- Diccionario de datos de Athia — definiciones de campos
- — descargas de archivos, compartición de almacenes y otras vías de integración — descargas de archivos, acceso a almacenes y otras opciones de integración