Skip to content

Common request headers

Headers are grouped by the direction of the request.

API request headers

Merchant requests to VellPay use the following headers for every country and endpoint.

HeaderTypeRequiredLengthDescription
appIdStringYes-Application identifier assigned by VellPay
timestampStringYes13Current millisecond timestamp; must be within five minutes of platform time
nonceStringYes-Random string for a single request; must not be reused
authorizationStringYes-Request signature generated with the merchant private key

Callback request headers

VellPay uses the following headers when sending pay-in, payout, and other business callbacks to merchants.

HeaderTypeRequiredLengthDescription
appIdStringYes-Application identifier assigned by VellPay
timestampStringYes13Millisecond timestamp when VellPay sends the callback
nonceStringYes-Random string used to sign this callback
authorizationStringYes-Callback signature generated with the VellPay platform private key
countryStringYes2Two-letter country code of the order