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

externalId

string

required

Payment identifier. Must be unique for any given commerceId

commerceId

string

required

Waylet commerce identifier. Will be provided by Klikin.

amount

string

required

Amount to be charged.

callbackUrl

string

required

Callback URL that will be invoked when payment ends.

urlOk

string

required

URL for redirection on successful payments.

urlKo

string

required

URL for redirection on failed payments.

urlClose

string

required

URL for redirection when user closes this window.

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