> For the complete documentation index, see [llms.txt](https://docs.papelship.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.papelship.com/api-based-store/crypto-invoice.md).

# Crypto Invoice

Direct cryptocurrency deposit invoice generation with HD wallet derivation

## Create Direct Crypto Deposit Invoice

> Generates a dedicated cryptocurrency deposit invoice with a derived HD wallet deposit address, exchange rate, and QR code.

```json
{"openapi":"3.0.3","info":{"title":"PapelShip API Gateway","version":"1.0.0"},"tags":[{"name":"Crypto Invoice","description":"Direct cryptocurrency deposit invoice generation with HD wallet derivation"}],"servers":[{"url":"https://papelship.com","description":"Production API Server"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API-Key","description":"Pass your secret API key formatted as: `Authorization: Bearer psa_...`"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Alternative header format: `X-API-Key: psa_...`"}}},"paths":{"/api/api-store/v1/crypto-invoice":{"post":{"summary":"Create Direct Crypto Deposit Invoice","description":"Generates a dedicated cryptocurrency deposit invoice with a derived HD wallet deposit address, exchange rate, and QR code.","operationId":"createCryptoInvoice","tags":["Crypto Invoice"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Unique UUID/string to prevent duplicate deposit address creation on retries.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","coin_type"],"properties":{"amount":{"type":"number","description":"Order total in fiat currency"},"currency":{"type":"string","description":"Fiat currency code","default":"USD"},"coin_type":{"type":"string","description":"Crypto coin symbol (LTC, BTC, USDT, USDC, DOGE, ETH, TRX, SOL, BNB)"},"network":{"type":"string","description":"Blockchain network override (e.g. TRC20, ERC20, SOL)"},"customer_email":{"type":"string","format":"email"},"description":{"type":"string"},"redirect_url":{"type":"string","format":"uri"},"webhook_url":{"type":"string","format":"uri"},"expires_in":{"type":"integer","description":"Expiration in minutes (default 60)","default":60}}}}}},"responses":{"200":{"description":"Crypto deposit invoice created with dedicated deposit address","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"invoice":{"type":"object","properties":{"invoice_id":{"type":"string"},"store_hash_id":{"type":"string"},"amount":{"type":"number"},"currency":{"type":"string"},"crypto_coin":{"type":"string"},"expected_crypto_amount":{"type":"number"},"deposit_address":{"type":"string"},"payment_url":{"type":"string","format":"uri"},"qr_code_url":{"type":"string","format":"uri"},"status":{"type":"string"},"expires_at":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"Bad Request / Crypto Method Disabled / Coin Not Enabled"}}}}}}
```