PayPal directo

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:read
• payouts: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:

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:

1. Transacciones (búsqueda, detalles)
2. Informes (saldos, transacciones)
3. Pagos (detalles)
4. Suscripciones
5. Disputas

La producción y la sandbox 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#

Configuración de la conexión#

1. Cree la aplicación, habilite la configuración de las 5 API y confirme que ambos ámbitos estén asociados.
2. En Configuración → Conexiones, seleccione + Agregar Conexión y seleccione PayPal directo.
3. En Configurar Conector, ingresar un Nombre y seleccione Programa.
4. En Introducir Credenciales, introduzca ID de cliente y Clave secreta.
5. Seleccione Verificar Conexión.
6. Copie la URL de destino de Webhook de Athia del asistente.
7. 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.CREATED y PAYOUTS.BATCH.PROCESSED. Guarde, luego habilite el webhook.

La conexión muestra entonces 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. Transaction Search informa sobre la actividad liquidada; obtenga las razones de rechazo de un conector de puerta de enlace en lugar de eso.
• Los importes son decimales — nunca los divida por 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 Integración de Athia.
• Los datos de la tarjeta se minimizan. El detalle a nivel de campo sobre lo que almacena Athia se encuentra en Diccionario de datos de Athia.

Resolución de problemas#

Relacionado#

• Conectores de Athia — el catálogo completo de conectores
• Diccionario de datos de Athia — definiciones de campos
• Integración de Athia — descargas de archivos, compartición de almacenes y otras vías de integración