perseguir
En esta página
Chase es el negocio de procesamiento de pagos y adquisiciones de comerciantes de JP Morgan Chase; su portal de desarrollador y su documentación utilizan el nombre. Morgan Chase. Los datos llegan a Athia de tres maneras: Athia sondea las API de informes y pagos globales para conocer el estado de los pagos y los informes, recibe notificaciones en el webhook que usted registra en el portal de JPMC y recoge archivos por lotes SFTP donde la integración se basa en formularios. Los requisitos previos del lado del proveedor (acceso a la API en el portal para desarrolladores de pagos de JP Morgan Chase y cualquier formulario DFR que deba enviarse a su gerente de relaciones de JPMC) se coordinan con su equipo de Athia. Una vez que tenga las credenciales, podrá completar la conexión usted mismo.
Lo que obtienes#
- Pagos - estado e información de pago en tiempo real.
- Transacciones — detalles de transacciones y saldos.
- Informes — ventas, reembolsos, depósitos y comisiones, prefinanciados y posfinanciados.
- Notificaciones — eventos y recomendaciones.
Los informes personalizados se definen a través de parámetros de API o mediante un formulario DFR donde el informe que necesita no es uno de los que devuelven las API.
Antes de empezar#
Necesitas acceso a la Portal para desarrolladores de pagos de JP Morgan Chase con permiso para generar certificados, credenciales OAuth o claves API.
En el portal:
- Solicitar o configurar el acceso a la Pagos globales y Informes APIs.
- Habilite las funciones que necesita, por ejemplo, pagos y notificaciones en tiempo real.
- Genera la credencial que utilizará Athia.
Elija un tipo de credencial
Cualquiera de los dos funciona:
- OAuth — generar un ID de cliente y un secreto, y establecer los alcances
payments:readyreports:read. Ambos ámbitos son de solo lectura: esta credencial no puede mover dinero. - Basado en certificado - descargar el
.pem/.crtarchivos del portal y cárguelos en Athia.
Asocie la credencial con su tipo de entidad: Empresa o Unidad de Negocios.
El formulario DFR
Los informes adicionales requieren un DFR (Informes de archivos delimitados) forma. se pide Nombre comercial y Número de entidady envía el formulario completo por correo electrónico a su Gerente de Relaciones JPMC. Comuníquese con su equipo de cuentas de Athia si desea ayuda con los formularios DFR o con la configuración inicial.
Credenciales que Athia solicita#
| Campo | Requerido | Qué es / dónde encontrarlo |
|---|---|---|
| Nombre | Sí | Su etiqueta para esta conexión: identifique la entidad de Chase que cubre |
| Programación | Sí | ¿Con qué frecuencia Athia encuesta a Chase: diariamente o cada hora? |
| ID de cliente de OAuth | Solo OAuth | Desde la credencial OAuth que generaste en el portal JPMC |
| Secreto del cliente OAuth | Solo OAuth | The matching secret for that client ID |
| Carga de certificado | Sólo certificado | El .pem / .crt archivos descargados del portal: utilícelos en lugar del par OAuth |
| Número de entidad | Sí | Su identificador de entidad JPMC, el mismo número utilizado en el formulario DFR |
Configuración de la conexión#
- En el portal JPMC, confirme el acceso a la API, habilite las funciones que necesita y genere el par OAuth con
payments:readyreports:reado los archivos del certificado. - En Athia, vaya a Configuración → Conexiones → + Agregar conexión y seleccione perseguir.
- En Configurar Conector, introduzca Nombre y elija Programación.
- En Ingrese Credenciales, introducir ID de cliente de OAuth y Secreto del cliente OAuth, o cargar el
.pem/.crtarchivos, luego ingrese su Número de entidad. - Defina la red y la operación: seleccione o cree un grupo y agregue las operaciones que cubre esta conexión.
- Seleccione Verifique la Conexión. Athia ejecuta un ping ligero de estado de pago contra la API.
- Copie la URL de destino del Webhook de Athia desde el asistente y regístrelo en el portal JPMC; consulte a continuación.
La conexión ahora muestra como ACTIVE y comienza la primera sincronización. Para varias entidades, genere un certificado independiente o utilice subID y cree una conexión por entidad.
gancho web#
Registre Athia como destino de notificación para que los cambios de estado de pago lleguen a medida que ocurren y no en la siguiente encuesta.
- Copie la URL de destino del Webhook de Athia desde el asistente de conexión.
- En el Portal para desarrolladores de pagos de JP Morgan Chase, abra la configuración de notificaciones/webhook.
- Pegue la URL de Athia y seleccione los eventos que desee: cambios de estado de pago, además de actualizaciones de pago y recomendaciones si las usas.
- Habilite el webhook y luego pruebe la configuración desde el portal.
Omita esto y Athia solo verá lo que arroja la encuesta programada.
Cadencia de sincronización#
Diario o cada hora. Cuando su integración se basa en formularios en lugar de API, llegan los mismos datos que lote SFTP archivos en lugar de encuestas API.
Límites y cosas que saber#
- Se requiere el número de entidad. Sin él, la conexión no puede tener como alcance la entidad JPMC correcta.
- Una credencial por entidad. Certificados o subID separados y una conexión Athia separada para cada uno.
- Los formularios DFR se envían a través de su administrador de relaciones. Permita un tiempo de espera antes de que aparezcan los informes que desbloquean.
- Los entornos de producción y prueba están separados. Utilice credenciales de producción en la conexión en la que espera datos de producción.
- Los datos de la tarjeta están minimizados. 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 |
|---|---|---|
| La verificación falla al cargar un certificado | Archivo incorrecto exportado o el certificado no es el asociado con esta entidad | Vuelva a descargar el .pem / .crt desde el portal JPMC y subir nuevamente |
| La verificación falla en OAuth | Alcances que faltan en el cliente | Añadir payments:read y reports:read en el portal, luego verifique nuevamente |
| Los pagos llegan pero los informes están vacíos | Acceso a la API de informes no concedido o el informe necesita un formulario DFR | Solicitar acceso a la API de informes en el portal; para informes adicionales, envíe el formulario DFR por correo electrónico a su gerente de relaciones |
La conexión es ACTIVE pero los datos pertenecen a otra entidad | incorrecto Número de entidad en la conexión | Corrija el número de entidad y verifique nuevamente |
| No llega nada entre encuestas | Webhook no registrado o no habilitado en el portal | Vuelva a agregar el URL de destino del Webhook de Athia, seleccione eventos de cambio de estado de pago y habilítelo |
| No hay ningún dato después de la primera sincronización | Credenciales del entorno de prueba en una conexión de producción | Vuelva a emitir las credenciales en el entorno en el que procesa y luego vuelva a conectarse |
Relacionado#
- Conectores de Athia — catálogo completo de conectores
- Diccionario de datos de Athia — definiciones de campos
- Integración de Athia — descargas de archivos, acceso a almacenes y otras opciones de integración