Notificación Externa Payphone

📎¿Cómo funciona la notificación externa de pago?

El servicio de notificación externa de PayPhone permite que PayPhone envíe notificaciones a los comercios después de que se haya realizado un pago exitoso en una tienda registrada. El objetivo de esta notificación es informar al comercio sobre el estado de la transacción, enviando un JSON con los detalles de la misma. El comercio, a su vez, debe confirmar la recepción de esta notificación respondiendo con un JSON que indique si la notificación fue recibida correctamente o si ocurrió algún error.

🔄 Flujo de la notificación externa

1. Pago realizado: El cliente realiza un pago a través de cualquier servicio integrado de Payphone, como el botón de pago, cajita de pago, link de pago, tokenización, o API Sale.
2. Notificación: El servidor de Payphone envía una notificación al webhook configurado por el comercio.
3. Recepción: El comercio recibe la notificación en su servidor.
4. Respuesta: El comercio debe responder con un JSON confirmando la recepción o indicando el error que ocurrió.

⚠️Consideraciones Importantes: ¡Puntos Clave a Tener en Cuenta!

• Solo se notifican transacciones aprobadas.
• La comunicación entre el servidor de Payphone y el comercio debe ser a través de HTTPS con un certificado SSL válido para garantizar la seguridad de la información.
• El servicio requiere de una autorización previa para poder ser utilizado.
• El método debe llamarse: NotificacionPago

🛡️Proceso de Autorización para Notificación Externa

El acceso al servicio de Notificación Externa Payphone requiere una autorización previa. A continuación, se detalla el proceso:

✉️ Solicitud de Autorización:

Para iniciar el proceso, el comercio debe enviar un correo electrónico a nuestra area comercial de Payphone con la siguiente información:

📨 Correo electrónico de contacto: Las solicitudes pueden enviarse a requests.docs@payphone.app

1. Asunto: Activación de la funcionalidad: Notificación Externa
2. Identificador del comercio: RUC, Cédula de Identidad
3. Nombre del comercio
4. Giro de Negocio: la actividad o conjunto de actividades principales que realiza la empresa para generar ingresos.
5. Motivo detallado de la solicitud: Explicar el uso que se le dará al servicio y los beneficios que aportará al negocio.
6. Información de contacto del solicitante: Nombre completo, número de teléfono y correo electrónico.

🔍Revisión y Evaluación por el Agente Comercial:

El agente comercial de Payphone revisará cuidadosamente la solicitud, analizando los siguientes aspectos:

1. Viabilidad comercial: Se evaluará si el servicio solicitado se alinea con la estrategia y los objetivos de Payphone.
2. Riesgos: Se identificarán y evaluarán los posibles riesgos asociados con la activación del servicio, como riesgos de seguridad o fraude.
3. Investigación adicional: El agente comercial podrá solicitar información adicional al cliente si es necesario para completar el análisis.
4. Reuniones: El agente comercial podrá programar reuniones con el cliente para discutir la solicitud en detalle y aclarar cualquier duda.

🏢Validación del Comercio:

Payphone realizará una verificación exhaustiva de la información del comercio, incluyendo:

1. Verificación de identidad: Se verificará la identidad del comercio y sus representantes.
2. Datos de contacto: Se validarán los datos de contacto proporcionados.
3. Actividad comercial: Se analizará la actividad comercial del comercio.
4. Evaluación de riesgos: Se evaluarán los riesgos asociados al comercio, como riesgo crediticio o riesgo de fraude.
5. Cumplimiento normativo: Se verificará que el comercio cumple con todas las regulaciones y normativas aplicables.
6. Firma de acuerdos: Se firmarán acuerdos de responsabilidad entre Payphone y el comercio para formalizar la relación.

✅Aprobación de la Solicitud:

1. Autorización: Una vez que el comercio haya sido validado y se hayan obtenido las aprobaciones internas, el agente comercial autorizará el uso del servicio de Notificación Externa.
2. Activación: El área técnica de Payphone procederá a activar el servicio para el cliente.
3. Notificación: Se notificará al cliente que el servicio ha sido activado y se le proporcionarán las instrucciones de uso.

📡Seguimiento y Monitoreo:

1. Monitoreo continuo: Payphone realizará un seguimiento continuo del uso del servicio para asegurar su correcto funcionamiento y detectar posibles problemas.
2. Soporte: Se brindará soporte técnico al cliente en caso de cualquier inconveniente.

🛠️ Guía de Implementación: Notificación Externa

El servicio de notificación externa de PayPhone te permite recibir automáticamente en tu Webhook el detalle de cada pago aprobado. ¡Ideal para procesar pedidos, confirmar compras y mantener tu sistema actualizado en tiempo real!

📤¿Qué se envía?

Al aprobarse un pago, Payphone te envía un JSON con toda la información relevante.

Ejemplo de JSON:

{
  "Amount": 2688,
  "AuthorizationCode": "W32805807",
  "ClientTransactionId": "ID-UNICO-1446-3748",
  "StatusCode": 3,
  "TransactionStatus": "Approved",
  "StoreId": "your_storeId",
  "PhoneNumber": "593984111333",
  "Email": "eloy@mail.com",
  "CardType": "Credit",
  "Bin": "409724",
  "DeferredCode": "00000000",
  "DeferredMessage": null,
  "Deferred": false,
  "CardBrandCode": "50",
  "CardBrand": "Visa St Georges Bank",
  "Document": "1234567890",
  "Currency": "USD",
  "Taxes": [],
  "Reference": "Referencia de Pago",
  "AdditionalData": null,
  "Products": [],
  "TransactionId": 32805807
}

📝Descripción de parámetros JSON enviados

‍

Se requiere que el comercio procese y almacene la información recibida en su webhook, y genere una respuesta JSON.

📩 ¿Qué se debe responder?

El webhook debe devolver una respuesta en formato JSON indicando:

• Response: Booleano indicando true si la notificación fue recibida correctamente, o false si ocurrió algún error.
• ErrorCode: Código de error correspondiente al procesamiento de la notificación. Se utiliza para especificar qué error ocurrió (si es que hubo alguno).

✅ Notificación Recibida.

{
  "Response": true,
  "ErrorCode": "000"
}

❌ Notificación con algún error.

{
  "Response": false,
  "ErrorCode": "111"
}

📚 Catálogo de Mensajes

El catálogo de códigos de error que se puede devolver es el siguiente:

La implementación correcta de este proceso permite a los comercios recibir el detalle de las transacciones aprobadas en una de sus tiendas registradas.

⚠️ Recomendaciones Finales

• ✔️ Asegúrate de almacenar toda la información de cada transacción.
• ✔️ Procesa las notificaciones rápidamente para evitar reintentos.
• ✔️ Mantén tu endpoint siempre disponible y seguro 🔐.