Creación de QR

Crea tu QR de DeUna en Ecuador.

Entornos disponibles

• Producción: https://api.payvalida.com/api/v4/merchants/qr/deuna

• Sandbox: https://api-test.payvalida.com/api/v4/merchants/qr/deuna

Todas las peticiones deben autenticarse mediante un checksum (query parameters), el cual se construye utilizando el algoritmo SHA-512 con la siguiente estructura:

checksum = SHA512(merchant + order + timestamp + fixedhash)

Donde:

• merchant: Nombre del comercio asignado por Payválida.

• order: Identificador único de la orden asignada por el comercio

• timestamp: Marca de tiempo en formato ISO 8601 (Ejemplo: 2025-06-09T15:29:35.437Z)

• fixedhash: Valor fijo confidencial proporcionado al comercio por Payválida.

Es fundamental mantener el fixedhash seguro. No debe ser expuesto en el frontend ni compartido con terceros.

---

Headers requeridos

Content-Type: application/json
Accept: application/json

Parámetros de consulta (query parameters)

Parámetro	Tipo	Requerido	Descripción
merchant	string	Sí	Identificador del comercio.
order	string	Sí	Identificador único de la orden asignado por el comercio.
timestamp	string	Sí	Marca de tiempo en formato UNIX epoch.
checksum	string	Sí	SHA-512 de merchant + order + timestamp + fixedhash.

Ejemplo de solicitud

GET https://api-test.payvalida.com/api/v4/merchants/qr/deuna?merchant=kuanto&order=ordenpago123&timestamp=2025-06-09T15:29:35.437Z&checksum=abc123...
Content-Type: application/json
Accept: application/json

Respuesta exitosa

{
  "CODE": "0000",
  "DESC": "OK",
  "DATA": {
    "qr": "data:image/png;base64,iVBORw0KGgoAAA.....=",
    "deepLink": "https://pagar.deuna.app/H91/merchant?id=MD1Y7HWEV"
  }
}

Campos de la respuesta

• CODE: Código de respuesta. "0000" indica éxito.

• DESC: Descripción del resultado.

• DATA.qr: Imagen QR codificada en Base64 que puede ser utilizada directamente en un tag HTML <img>.

• DATA.deepLink: URL deeplink que redirige a la app DeUna para completar el pago.

---

Ejemplo en cURL

curl -X GET "https://api-test.payvalida.com/api/v4/merchants/qr/deuna?merchant=kuanto&order=ordenpago123&timestamp=2025-06-09T15:29:35.437Z&checksum=abc123... \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

---

Posibles errores

La API puede responder con los siguientes códigos de error en caso de solicitudes malformadas o fallas internas. Todos los errores mantienen la misma estructura de respuesta, cambiando los valores de CODE y DESC.

Formato de error

{
  "CODE": "0001",
  "DESC": "Invalid body"
}

Tabla de errores

CODE	DESC	Descripción
0001	Invalid body	La estructura de los parámetros enviados no es válida.
0002	Internal server error	Error interno del servidor. Intente nuevamente más tarde.