Crear private token
Descripción | Crea un Private Widget Token para inicializar el Widget de Movired en modo pasarela y/o recarga tipo 2 |
---|---|
Tipo | POST |
URL | https://widget.movired.cl/api/widget/create-token |
Parámetros del cuerpo
Nombre | Tipo | ¿Obligatorio? | Descripción |
---|---|---|---|
string | si | El correo electrónico del usuario que esta cargando | |
amount | int | si | El monto en clp que el usuario está cargando |
number | string | si | El número de cuenta/tarjeta bip/Rut bipQr que el usuario está pagando/cargando |
external_id | string | no | El id de la transacción proveniente del sistema externo |
product | int | no(*) | El producto es obligatorio solo si utilizarás el widget en modo recarga tipo 2. Para indicar una recarga de bip!QR debes pasar 1 a la propiedad product, si lo que deseas cargar es una tarjeta bip normal debes ingresar un 2. |
Parámetros del encabezado
Nombre | Valor | Descripción |
---|---|---|
content-type | application/json | Indica que el cuerpo o la respuesta está en json |
x-public-token | string | Token otorgado por Movired para usar el Widget |
x-authorization-token | string | Token que debes obtener utilizando el endpoint “Crear código de autorización”. |
Respuestas
Código Http | Cuerpo de la respuesta |
---|---|
200 | Ok |
400 | Errores de validación |
403 | Public Token no válido |
Ejemplos de códigos
Se recomienda obtener el widgetToken a través del backend
Solicitud
Código Php
<?php $obj = new stdClass(); $obj->email = "developer@movired.cl"; $obj->amount = 1000; $obj->number = "111111111"; $obj->external_id = "external_id"; $obj->product = 1;//(*) $url = "https://widget.movired.cl/api/widget/create-token"; $headers = array( "x-public-token: " . tu_public_token, "x-authorization-token: " . tu_authorization_token, "Content-Type: application/json" ); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($obj)); $response = curl_exec($ch); if (curl_errno($ch)) { echo 'Error: ' . curl_error($ch); } else { $data = json_decode($response, true); if ($data['status_code'] == 200) { $private_widget_token = $data['data']['widgetToken']; echo $private_widget_token; } } curl_close($ch); ?>
Código Javascript
let obj = { "email": "developer@movired.cl", "amount": 1000, "number": "111111111", "external_id": "external_id", "product": 1//(*) } fetch("https://widget.movired.cl/api/widget/create-token", { method: "POST", headers: { "x-public-token": tu_public_token, "x-authorization-token": tu_authorization_token, "Content-Type": "application/json", }, body: JSON.stringify(obj) }) .then(json => json.json()) .then(data => { if (data.status_code == 200) { private_widget_token = data.data.widgetToken; console.log(private_widget_token); } }) .catch(e => console.log(e))
(*) La propiedad es obligatoria si deseas utilizar el modo recarga tipo 2.
Una vez realizada la petición obtienes un widgetToken(private widget token) único por cada transacción que realices, que identifica internamente los datos de la transacción. Este token te permite inicializar e interactuar con el Widget de Movired.