Solicitud de url de inicio de pago

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

externalId

string

required

Identificador único de operación

commerceId

string

required

Identificador del comercio facilitado por Klikin

amount

string

required

Importe de la operación

callbackUrl

string

required

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

urlOk

string

required

URL a la que reenviar al usuario si la operación prospera correctamente

urlKo

string

required

URL a la que reenviar al usuario si la operación no prospera correctamente

urlClose

string

required

URL a la reenviar al usuario si se cierra la ventana

Example

{
  "externalId": "20230405126789",
  "commerceId": "edfdaaeb20edea2bb93aa0a2",
  "amount": "210",
  "callbackUrl": "http://pointed-hire.name",
  "urlOk": "https://calculating-bootie.name",
  "urlKo": "http://constant-dog.org",
  "urlClos": "https://deafening-ball.com"
}

Solicitud de url de inicio de pago

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

Request

Responses

Cálculo de la firma del callback (signature)