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.
| Header | Type | Required | Length | Description |
|---|---|---|---|---|
appId | String | Yes | - | Application identifier assigned by VellPay |
timestamp | String | Yes | 13 | Current millisecond timestamp; must be within five minutes of platform time |
nonce | String | Yes | - | Random string for a single request; must not be reused |
authorization | String | Yes | - | 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.
| Header | Type | Required | Length | Description |
|---|---|---|---|---|
appId | String | Yes | - | Application identifier assigned by VellPay |
timestamp | String | Yes | 13 | Millisecond timestamp when VellPay sends the callback |
nonce | String | Yes | - | Random string used to sign this callback |
authorization | String | Yes | - | Callback signature generated with the VellPay platform private key |
country | String | Yes | 2 | Two-letter country code of the order |