Initial Setup

Required Headers

All merchant POS requests require these headers:

Header	Required	Type	Notes
apikey	Yes	String	API key issued by Crypto POS support
merchantid	Yes	String	Merchant username/ID associated with the API key

For POST /crypto/v1/createInvoice, include:

Header	Required	Type	Notes
content-type	Yes	String	Runtime currently expects exact value application/json

Important Content-Type Caveat

Current runtime behavior strictly checks content-type === application/json for createInvoice.

Values such as application/json; charset=utf-8 may be rejected.

Environment Placeholders

Store and inject these values in your backend environment:

CRYPTOPOS_BASE_URL={BASE_URL}
CRYPTOPOS_API_KEY={apikey}
CRYPTOPOS_MERCHANT_ID={merchantid}

Example cURL Header Usage

curl -X GET "{BASE_URL}/crypto/v1/list-txs" \
  -H "apikey: ${CRYPTOPOS_API_KEY}" \
  -H "merchantid: ${CRYPTOPOS_MERCHANT_ID}"