Solicitud de url de inicio de pago

POST/openwaylet/web/v1/transactions

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: API Key

Add parameter in header

x-openwaylet-apikey

Example

x-openwaylet-apikey: 2f68dbbf-519d-4f01-9636-e2421b68f379

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

{
  "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"
}

Responses

OK(200)

HTTP Code: 200

Content Type : JSONapplication/json

url

string

required

URL a la derivar al usuario

{
  "url": "https://unnatural-politics.info"
}

Last modified: 6 months ago