Start 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:

HMAC_SHA512(customer + 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

customer

string

required

User ID. The user's email or phone number or the user's unique Repsol registration identifier may be sent.

amount

number

required

Charge amount

commerceId

string

required

Identifier of the merchant making the charge. Provided by Klikin.

callbackUrl

string

required

paymentId

string

required

Identifier of the operation in the trade. It must be unique per transaction.

items

array [object {5}]

optional

units

integer

required

Number of items

description

string

required

Item description

unitPrice

integer

required

Price item

totalPrice

integer

required

Price total

generateCashback

boolean

required

Indicates whether cashback is generated or not, by default, true.

signature

string

required

Example

{
  "customer": "Loraine_Hessel@example.com",
  "amount": 300,
  "commerceId": "f86edbb51682cee8fcdb13ff",
  "callbackUrl": "https://whirlwind-starter.org",
  "paymentId": "202305248569",
  "items": [
    {
      "units": 2,
      "description": "Electronic Rubber Computer",
      "unitPrice": 100,
      "totalPrice": 200,
      "generateCashback": false
    }
  ],
  "signature": "a77eebdac8f8b8dbe0fdf8d3"
}

Signature#

Callback signature calculation#

Request

Responses

Signature

Callback signature calculation