Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.coinom.com/llms.txt

Use this file to discover all available pages before exploring further.

API keys are used to authenticate your requests to the Coinom API.
Each merchant has its own API keys, which are automatically generated when you create a merchant.

Overview

An API key allows your application to securely communicate with Coinom. You will use your API key to:
  • Create payments
  • Check transaction status
  • Access merchant-related endpoints

Where to Find Your API Key

To access your API keys:
  1. Log in to your Coinom dashboard
  2. Navigate to Merchants
  3. Select your merchant
  4. Open the API Keys section

API Key Types

Secret Key

  • Used for server-side requests
  • Must be kept private
  • Never expose it in frontend code

Public Key (optional)

  • Used for client-side integrations
  • Safe to expose in frontend environments

Using Your API Key

Include your API key in the request header:
Authorization: Bearer YOUR_API_KEY

Example Request

curl https://api.coinom.com/v1/payments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Security Best Practices

  • Never share your secret API key publicly
  • Do not store keys in client-side code
  • Use environment variables to store keys
  • Rotate your API keys periodically

Regenerating API Keys

If your API key is compromised, regenerate it immediately.
  1. Go to your Merchant Dashboard
  2. Open the API Keys section
  3. Click Regenerate Key
⚠️ Regenerating a key will invalidate the old key instantly.

  • Create a Merchant
  • Accept Payments