Waylet PayInicio de cobro con QR
POST/integrations/openwaylet/v1/payments/start/qrEste 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
Texto codificado en el QR (identifica una operación de pago en Waylet)
Importe del cargo
Identificador del comercio que realiza el cargo. Proporcionado por Klikin.
URL a la que enviar el resultado de la operación
Identificador de la operación en el comercio. Ha de ser único por operación de cargo.
Número de elementos del ítem
Descripción del ítem
Precio unitario del ítem
Precio total de las unidades del ítem
Indica si genera cashback o no, por defecto, true
Firmado de la petición
{
"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"
}Responses
Identificador del pago en Waylet
{
"_id": "bf48b9abf84cd8cd61cc40d7"
}