Start QR payment

This endpoint starts the payment process that the user must finish on Waylet app.

Successful responses will have 201 HTTP status and contain the Waylet identifier for the payment.

Signature

API requests needs a signature:

HMACSHA512(qrContent + amount + commerceId + paymentId + callbackUrl)

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

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

qrContent

string

required

QR code that identifies a Waylet payment operation.

amount

number

required

Amount to be charged.

commerceId

string

required

Waylet commerce identifier. Will be provided by Klikin.

callbackUrl

string

required

Callback URL that will be invoked when payment ends.

paymentId

string

required

Payment identifier. Must be unique for any given commerceId

items

array [object {5}]

optional

Shopping cart items

units

integer

required

Item count.

description

string

required

Item description.

unitPrice

integer

required

Item unit price.

totalPrice

integer

required

Item total price.

generateCashback

boolean

required

Item should generate cashback. True by default.

signature

string

required

Example

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

Signature#

Callback signature calculation#

Request

Responses

Signature

Callback signature calculation