Payment start URL

Callbacks

When the operation is finished a POST request will be sent to the callbackUrl.

Callback signature calculation

The signature that will send the request to the API will be calculated in the following way (in pseudo-code):

HMACSHA512(paymentId + wayletPaymentId + status + amount)

using a secret that will be provided by Klikin for test environments.

POST {$request.body.callbackUrl}

Campo	Descripción
paymentId	Trade operation identifier
wayletPaymentId	Waylet operation identifier matching the identifier returned in the request
status	You may receive one of the following values: PAID, REFUSED or CANCELED
errorCode	If status = REFUSED, you receive the error code
errorDescription	If status = REFUSED, you receive the error description
amount	Amount requested to be collected
signature

Request

Authorization

Add parameter in header

x-openwaylet-apikey

Example:

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

Body Params application/json

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

Callback signature calculation#

Request

Responses

Callback signature calculation