Esta guía permite comunicarse con los terminales bancarios Revolut. Puede enviar automáticamente el importe a cobrar al terminal y recibir el estado del pago directamente en Hiboutik.

#Configuración y uso

#Recuperación de claves API de Revolut

Primero debe recuperar sus claves API desde la interfaz de administración de Revolut:

https://developer.revolut.com/docs/guides/accept-payments/get-started/generate-the-api-key

En la aplicación Revolut by Hiboutik, introduzca:

• su clave secreta
• su clave pública

Es posible añadir varios pares de claves API para gestionar múltiples tiendas o entidades jurídicas diferentes.

#Configuración de terminales

Una vez configuradas las claves, aparecerán automáticamente las ubicaciones y los terminales asociados.

Si su terminal no aparece, verifique que el modo Pay at counter esté activado.

#Cobro de una venta

Durante una venta:

1. el importe se envía automáticamente al terminal Revolut
2. el cliente realiza el pago en el terminal
3. el estado del pago se devuelve automáticamente a Hiboutik

---

#Comunicación API con el terminal

También es posible enviar pagos directamente al terminal mediante API.

#Ejemplo PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://revolut.hiboutik.net/api/',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "amount": 100,
    "currency": "GBP",
    "terminal_id": "c3b7ebf0-75f2-40fb-9ca9-344ec64948dd",
    "reference" => "12345"
  }',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Accept: application/json',
    'Authorization: Bearer <yourApiKey>'
  ),
));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

#Consulta del estado de una transacción

GET https://revolut.hiboutik.net/api/status/{transaction_id}
Authorization: Bearer <yourApiKey>

#Estados posibles

Estado	Descripción
pending	Pago enviado al terminal
processing	Pago en curso
completed	Pago validado
failed	Pago rechazado
cancelled	Pago cancelado

---

#Historial, cancelaciones y reembolsos

Desde la sección Historial de la aplicación, puede consultar todos los pagos realizados mediante Revolut.

Para cada transacción, puede:

• cancelar una operación
• realizar un reembolso parcial o total

#Cancelación de un pago

1. Haga clic en Reversal
2. Siga las instrucciones mostradas en el terminal

#Reembolso de un pago

1. Introduzca el importe a reembolsar en céntimos
2. Haga clic en Refund
3. Siga las instrucciones mostradas en el terminal

---

Información importante

• El modo Pay at counter solo acepta pagos enviados desde Hiboutik o mediante la API de la aplicación.
• Para introducir manualmente un importe directamente en el terminal, el modo Pay at counter debe estar desactivado.
• Las transacciones realizadas fuera del país asociado a la cuenta Revolut pueden ser rechazadas.
• Varios usuarios pueden compartir el mismo terminal.
• El terminal también puede aceptar pagos mediante Revolut Pay mostrando un código QR directamente en la pantalla del terminal.