---
name: nicky-crypto-button
description: Use when adding or adapting the official Nicky crypto payment button in a website or application, including HTML, React, or another framework, and connecting it to an existing checkout URL or callback.
---

# Nicky Crypto Payment Button

Implement the official Nicky button in the current project using the files bundled with this skill.

## Steps

1. Identify the destination project's framework, routing, styling conventions, asset paths, checkout integration, and applicable project instructions.
2. Choose plain (monogram and label only, no asset API) or with asset icons. Use the matching HTML/React example. Read `references/style-guide.md` and inspect the example files in `examples/` and the original mark in `assets/`.
3. Use the original N monogram and one of the supplied dark, lime, or light variants. Preserve the mark's square proportions, supplied heights, spacing, and contrast. Keep the preview canvas behind every variant at #F5F4F0.
4. Use the selected localized action label with the Nicky monogram. Presets are Pay, Donate, Send, Buy and Tip with Nicky. Supported locales match Nicky production: English, Brazilian Portuguese, Greek, Spanish, French, Russian, Vietnamese and Nepali. Set `lang` to the selected locale. The legacy `crypto` action uses Nicky's existing Pay with Crypto translations. These labels reflect later product direction and do not revise the Version 1.0 source PDF. Keep the full label visible beside the mark.
5. Connect only a checkout URL or callback already supplied by the integrator. Validate that a URL is HTTPS and contains no credentials. For the asset presentation only, Your Nick (email, verified domain or Short ID) may be used to load connected asset icons from userAssetConnections, deduplicated by canonical ticker. Resolve email addresses and domains to their matching Short ID with `GET /api/public/Nick/search?q=...` first, then call `GET /api/public/Payment/get-payment-data?userShortId=...`, since the payment-data endpoint accepts only Short IDs. Do not use acceptedAssets pricing currencies. Changing the action text does not create a new payment operation. Use only bundled ticker-to-icon mappings, and omit unsupported icons. Never use a payment button to open signup. Do not invent SDKs, packages, authentication, or confirmation logic.
6. Implement link semantics for a ready URL and button semantics for a callback. Support keyboard use, visible focus, pending/loading, disabled state, accessible loading announcements, reduced motion, and mobile layout.
7. For the asset presentation only, include the bundled `assets/crypto/` icon directory at the paths expected by the example. Show connected assets in sequence, then rapidly return to the N monogram with a mechanical split-flap effect. Respect reduced-motion preferences. Do not show an asset count. Include all connected assets in the accessible name. For both presentations, set `lang` to the actual label language. Use RTL only for legacy Arabic/Hebrew translations. Keep useful hover, pressed and focus states without adding a loading animation. Verify the destination project's viewport, locale, focus, disabled behavior, account asset results and errors, and that the URL/callback starts only the existing flow. Report changed files and how the result was checked.

## Packaged resources

- `references/style-guide.md`: supplied component settings and behavior.
- `assets/n-mark.png`: original Nicky monogram.
- `assets/crypto/`: the shipped crypto icons used by the example component.
- `assets/nicky-crypto-button.css`: standalone button styles.
- `examples/button.html`: plain HTML example.
- `examples/button-with-assets.html`: HTML example with connected asset icons.
- `examples/CryptoPaymentButton.tsx`: plain React and TypeScript example.
- `examples/CryptoPaymentButtonWithAssets.tsx`: React and TypeScript example with connected asset icons. Both files export `CryptoPaymentButton`.

The canonical public documentation is https://nicky.me/branding-guidelines/payment-button/ and the existing API reference is https://api-public.pay.nicky.me/swagger/index.html.

The bundled examples use NICKY and its verified checkout URL as a live sample. Replace the destination before integrating for another account. For the asset version, also replace Your Nick with an email, verified domain or Short ID. No sample submits or confirms a payment automatically.
