API v2
Devoluciones {new}
Webhook

Notificación del estado de una devolución

Cuando realices una devolución, podemos enviarte una notificación directamente a la URL que especifiques en el campo notification_url. Así, estarás al tanto de cualquier evento relacionado con la devolución de manera automática.

Te enviaremos el mensaje usando el método HTTP POST.

Para asegurarte de que todo funciona correctamente, solo necesitas que tu endpoint devuelva un código de estado HTTP 200. Esto nos indicará que recibiste la notificación sin problemas.

¡Aviso importante! Para usar este Webhook, es necesario disponibilizar un endpoint público que acepte una comunicación de tipo POST.

Posibles estados de la orden que se notifica vía webhook:

EstadoDescripción
REFUNDEDLa devolución se realizó de manera satisfactoria. El comprador debería ver su dinero según los tiempos del banco que usó para pagar.
NOT_REFUNDEDLa devolución no pudo confirmarse por no haber pasado alguna de nuestras validaciones.

Ejemplo de una notificación:

{
  "uuid": "9d42ef50-a139-4606-bc21-43d5e2722876",
  "external_reference": "sf2e0241-a139-4606-adb1-74a842641281",
  "status": "REFUNDED/NOT_REFUNDED",
  "created_date": "2022-06-06T13:23:27Z",
  "api_version": "2"
}
CampoTipoDescripción
uuidstringIdentificador único de la orden.
external_referencestringNúmero de referencia de la orden. Este puede ser dado por la tienda al momento de crear la orden.
statusstringEstado de la devolución.
created_datestringFecha de creación de la devolución.
api_versionstringVersión de la API de Ualá Bis API Cobros Online.