Inicio de cobro con QR

Este método se utilizará para solicitar un cobro a un usuario de Waylet. Si la petición es correcta el servicio devolverá un HTTP status 201 con el identificador de la solicitud en Waylet.

Cálculo de la firma (Signature)

La firma que enviará la petición a la API se calculará de la siguiente forma (en pseudo-código):

HMACSHA512(qrContent + amount + commerceId + paymentId + callbackUrl)

utilizando una contraseña proporcionada por Klikin.

Callbacks

Cuando la operación finalice se enviará una petición POST al callbackUrl.

Cálculo de la firma del callback (signature)

La firma que enviará la petición a la API se calculará de la siguiente forma (en pseudo-código):

HMACSHA512(paymentId + wayletPaymentId + status + amount)

utilizando una contraseña proporcionada por Klikin.

POST {$request.body.callbackUrl}

Campo	Descripción
paymentId	Identificador de la operación del comercio
wayletPaymentId	Identificador de la operación de Waylet que coincide que identificador devuelto en la petición
status	Podrá recibir uno de estos valores: PAID -> cobro realizado correctamente REFUSED -> cobro no realizado rechazado CANCELED -> pago cancelado por el usuario
errorCode	En caso de status = REFUSED, código del error
errorDescription	En caso de status = REFUSED, descripción del error
amount	Importe solicitado a cobrar
signature	Firmado de la petición

Request

Authorization

Add parameter in header

x-openwaylet-apikey

Example:

x-openwaylet-apikey: ********************

Body Params application/json

qrContent

string

required

Texto codificado en el QR (identifica una operación de pago en Waylet)

amount

number

required

Importe del cargo

commerceId

string

required

Identificador del comercio que realiza el cargo. Proporcionado por Klikin.

callbackUrl

string

required

URL a la que enviar el resultado de la operación

paymentId

string

required

Identificador de la operación en el comercio. Ha de ser único por operación de cargo.

items

array [object {5}]

optional

units

integer

required

Número de elementos del ítem

description

string

required

Descripción del ítem

unitPrice

integer

required

Precio unitario del ítem

totalPrice

integer

required

Precio total de las unidades del ítem

generateCashback

boolean

required

Indica si genera cashback o no, por defecto, true

signature

string

required

Firmado de la petición

Example

{
  "qrContent": "fbcb80a6ca299a2b7b8dc4ed",
  "amount": 300,
  "commerceId": "2db2b0eaff308cb7bc3dabb3",
  "callbackUrl": "https://soft-temporary.net",
  "paymentId": "202305248569",
  "items": [
    {
      "units": 2,
      "description": "Small Granite Mouse",
      "unitPrice": 100,
      "totalPrice": 200,
      "generateCashback": false
    }
  ],
  "signature": "d5c5af0d7ef3c22da4d2accc"
}

Inicio de cobro con QR

Cálculo de la firma (Signature)#

Cálculo de la firma del callback (signature)#

Request

Responses

Cálculo de la firma (Signature)

Cálculo de la firma del callback (signature)