Authentication & Headers

UMVA API Authentication

The UMVA API uses a key pair for authentication. To make an authenticated request to the API, you must include the appropriate headers as described below.

Obtain the Keys:

Merchants: Merchants are required to use both Public and Secret Keys. These can be copied from the merchant dashboard under the specific merchant account details: https://umva.net/merchant/business/api/key. Please ensure that your keys are stored safely and not shared publicly. If your keys are compromised, contact UMVA immediately for assistance. You can also regenerate the Secret Key from your merchant account dashboard.

Non-Merchants and Referral Programs: Only API Keys are required, which can be obtained here: https://umva.net/user/api-keys.

Request Headers: For most API requests, only the Public Key header is required. Situations that require the Secret Key header will be indicated in the documentation.

Header Name Value Required
Content-Type application/json YES
x-api-version API version (currently 1) YES
public-key The Public Key as obtained from the merchant account or user API keys YES
secret-key The Secret Key as obtained from the merchant account. Required for specific situations. NO for Non-Merchants / YES for Merchants