Recibir respuestas en un webhook

Recibir respuestas en un webhook

1. Descripción

Si el comercio requiere recibir las respuesta de los pagos de las suscripciones en un backend, ya sea, para actualizar información o simplemente almacenar la respuesta en base de datos como respaldo, entonces debe habilitar un webhook
El webhook para suscripciones es un enpoint API que el comercio debe habilitar para recibir las respuestas de los pagos exitoso o fallidos de las suscripciones que tenga registradas en Greenpay.

2. Configuración

2.1 Ruta del webhook

A continuación, se describe la ruta que se deben configurar para recibir la respuesta. Este enpoint debe estar habilitado para recibir peticiones POST.

Por ejemplo, si se cuenta con un dominio en  webhook.micomercio.com que se quiere establecer como webhook de suscripciones, entonces la ruta habilitada debe ser:
  •  webhook.micomercio.com/subscription/payment/results

2.2 Headers y body para el webhook

Este endpoint debe soportar y permitir los siguientes headers:

  • 'Accept': 'application/json'

  • 'Content-Type': 'application/json'


Además, el cuerpo (body) que enviará Greenpay será un objeto json, como el siguiente:


Aprobado

{
    "approved": [
        {
            "status": "approved",
            "orderStatus": "ACTIVE",
            "order": {
                "orderReference": "36149696ae466d3f472c301c81778d64_1",
                "subscriptionId": "36149696ae466d3f472c301c81778d64",
                "user": "Inno Imagen Sociedad Anónima",
                "amount": 7459.9999983,
                "currency": "CRC",
                "date": "2023-03-23T07:08:31.878Z",
                "authorization": "112980",
                "details": {
                    "token": "b62829cc-c76b-4c90-81f2-a8c45583d327",
                    "time_local_tran": "010831",
                    "systems_trace_audit_number": "423478",
                    "success": true,
                    "retrieval_ref_num": "8177526768",
                    "resp_code": "00",
                    "reserved_private4": "APPROVED",
                    "proc_code": null,
                    "network_international_id": null,
                    "mti": "0210",
                    "merchant_id": 194,
                    "date_local_tran": "0323",
                    "card_acceptor_terminal_id": null,
                    "authorization_id_resp": "112980"
                },
                "errors": [],
                "reason": "APPROVED"
            }
        }
    ]
}

Rechazo

{
    "failed": [
        {
            "status": "failed",
            "orderStatus": "PENDING",
            "order": {
                "orderReference": "ec9e5f98fc682737153f291d456f3ef4_24",
                "subscriptionId": "ec9e5f98fc682737153f291d456f3ef4",
                "user": "618038e5e4b07a144369cff6",
                "amount": 5.99,
                "currency": "USD",
                "date": "2023-12-04T07:01:02.631Z",
                "authorization": null,
                "details": {
                    "token": "eee59a72-4548-4f6d-b025-661a501cea18",
                    "time_local_tran": "010058",
                    "systems_trace_audit_number": "726893",
                    "success": false,
                    "retrieval_ref_num": "333801005888",
                    "resp_code": "51",
                    "reserved_private4": "FONDOS INSUFICIENTES FONDOS INSUFICI",
                    "proc_code": "000000",
                    "network_international_id": "0003",
                    "mti": "0210",
                    "merchant_id": 2,
                    "date_local_tran": "1204",
                    "card_acceptor_terminal_id": "00150860",
                    "authorization_id_resp": null
                },
                "errors": [
                    [
                        "authorizer",
                        "FONDOS INSUFICIENTES FONDOS INSUFICI"
                    ]
                ],
                "reason": "FONDOS INSUFICIENTES FONDOS INSUFICI"
            }
        }
    ]
}
3. Utilizar el webhook

Para configurar este webhook en GreenPay se deben seguir los siguientes pasos
  1. Ingresa al portal de Greenpay (Dashboard) en https://dashboard.greenpay.me/login.
  2. Ir a la sección de Configuración.
  3. Click sobre el botón Agregar nuevo.
  4. Agregar URL que desean establecer como webhook, por ejemplo, webhook.micomercio.com
  5. Guardar la configuración.
  6. Una vez configurado, recibirá la notificaciones al server del URL configurado.
En la siguiente imagen, se pueden ver las indicaciones para la configuración en el dashboard.


    • Related Articles

    • Recibir respuestas en el webhook

      El webhook es un servicio web que recibe respuestas, en este caso de tipo POST en diferentes rutas, por ejemplo, para webhook.micomercio.com las rutas serían las siguientes: / : Para recibir las respuestas enviadas por el servicio de checkout ...
    • Recibir respuestas en un webhook

      1. Descripción Si el comercio necesita recibir las respuesta de los pagos en lote en su un backend, ya sea para actualizar pedidos, información o simplemente almacenar la respuesta en base de datos como respaldo, entonces debe habilitar un webhook. ...
    • Recibir la respuesta en el webhook

      El webhook es un servicio web que recibe respuestas, en este caso de tipo POST en diferentes rutas, por ejemplo, para webhook.micomercio.com las rutas serían las siguientes: / : Para recibir las respuestas enviadas por el servicio de checkout ...
    • Recibir la respuesta de pago en el webhook

      El webhook es un servicio web que recibe respuestas, en este caso de tipo POST en diferentes rutas, por ejemplo, para webhook.micomercio.com las rutas serían las siguientes: / : Para recibir las respuestas enviadas por el servicio de checkout ...
    • Respuesta de pago en webhook

      1. Descripción Si el comercio require recibir las respuesta de los pagos o tokenización de tarjetas en un backend, ya sea, para actualizar pedidos, información o simplemente almacenar la respuesta en base de datos como respaldo, entonces debe ...