Saltar al contenido principal
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:

  1. Solicitar o configurar el acceso a la Pagos globales y Informes APIs.
  2. Habilite las funciones que necesita, por ejemplo, pagos y notificaciones en tiempo real.
  3. 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:read y reports:read. Ambos ámbitos son de solo lectura: esta credencial no puede mover dinero.
  • Basado en certificado - descargar el .pem / .crt archivos 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#

CampoRequeridoQué es / dónde encontrarlo
NombreSíSu etiqueta para esta conexión: identifique la entidad de Chase que cubre
ProgramaciónSí¿Con qué frecuencia Athia encuesta a Chase: diariamente o cada hora?
ID de cliente de OAuthSolo OAuthDesde la credencial OAuth que generaste en el portal JPMC
Secreto del cliente OAuthSolo OAuthThe matching secret for that client ID
Carga de certificadoSólo certificadoEl .pem / .crt archivos descargados del portal: utilícelos en lugar del par OAuth
Número de entidadSíSu identificador de entidad JPMC, el mismo número utilizado en el formulario DFR

Configuración de la conexión#

  1. En el portal JPMC, confirme el acceso a la API, habilite las funciones que necesita y genere el par OAuth con payments:read y reports:read o los archivos del certificado.
  2. En Athia, vaya a Configuración → Conexiones → + Agregar conexión y seleccione perseguir.
  3. En Configurar Conector, introduzca Nombre y elija Programación.
  4. En Ingrese Credenciales, introducir ID de cliente de OAuth y Secreto del cliente OAuth, o cargar el .pem / .crt archivos, luego ingrese su Número de entidad.
  5. Defina la red y la operación: seleccione o cree un grupo y agregue las operaciones que cubre esta conexión.
  6. Seleccione Verifique la Conexión. Athia ejecuta un ping ligero de estado de pago contra la API.
  7. 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.

  1. Copie la URL de destino del Webhook de Athia desde el asistente de conexión.
  2. En el Portal para desarrolladores de pagos de JP Morgan Chase, abra la configuración de notificaciones/webhook.
  3. 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.
  4. 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 veCausa probableQué hacer
La verificación falla al cargar un certificadoArchivo incorrecto exportado o el certificado no es el asociado con esta entidadVuelva a descargar el .pem / .crt desde el portal JPMC y subir nuevamente
La verificación falla en OAuthAlcances que faltan en el clienteAñadir payments:read y reports:read en el portal, luego verifique nuevamente
Los pagos llegan pero los informes están vacíosAcceso a la API de informes no concedido o el informe necesita un formulario DFRSolicitar 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 entidadincorrecto Número de entidad en la conexiónCorrija el número de entidad y verifique nuevamente
No llega nada entre encuestasWebhook no registrado o no habilitado en el portalVuelva 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ónCredenciales del entorno de prueba en una conexión de producciónVuelva a emitir las credenciales en el entorno en el que procesa y luego vuelva a conectarse