Consulta transacción

DescripciónConsultar el estado de una transacción
TipoPOST
URLhttp://widget.movired.cl/api/widget/verify-payment

Parámetros del encabezado

NombreValorDescripción
content-typeapplication/jsonIndica que el cuerpo o la respuesta está en json
x-widget-tokenstringToken recibido en el webhook, o el creado a través de la api “create private token” en la modalidad Widget Pasarela

Respuestas

Código HttpCuerpo de la respuesta
200Ok
400Token no válido, o problemas en la validación

Ejemplos de códigos

Solicitud

En caso que la solicitud este ok(200) la respuesta recibida tiene el siguiente formato

{
    "estado": estado,
    "respuesta": {
        "identificador": identificador,
        "monto": monto,
        "nro_tarjeta": numero_tarjeta,
        "email": email,
        "fecha_hora": fecha_hora,
        "estado": estado,
				"external_id": external_id(opcional)
    }
}

Aclaremos las propiedades del objeto:

1. estado : El campo estado indica el estado de la transacción, toma valor true cuando la transacción es exitosa y false en caso contrario.

2. respuesta: El campo respuesta es un objeto que entrega mas detalles de la transacción.

a. identificador : El campo identificador es nuestro id interno que identifica la transacción.

b. monto: El campo monto indica el monto pagado por el usuario mediante el widget.

c. nro_tarjeta : El campo nro_tarjeta indica el número de la cuenta a la que se realiza el pago/carga.

d. email : El campo email indica el correo electrónico del usuario indicado en el widget.

e. fecha_hora : El campo fecha_hora , con formato (yyyy-mm-dd hh:mm:ss), indica la fecha en que recibimos la notificación de la transacción.

f. estado : El campo estado indica el estado de la transacción, puede tomar valores del 1 al 4, donde estos son:

  1. created
  1. failed
  1. rejected
  1. succeeded

g. external_id : El campo opcional external_id , indica el id externo recibido por el endpoint “crear private token” en la modalidad de “widget Pasarela”.

Cuando la solicitud ha fallado se indica con el http code 400, y en el cuerpo de la respuesta el objeto solo trae la propiedad error que da la descripción de lo sucedido.