> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moove.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Moove API Keys

> Moove API के लिए स्कोप वाली API की बनाएँ, उसे एक बार कॉपी करें, और काम खत्म होने पर हमेशा के लिए रिवोक कर दें।

की बनाएँ, उसे एक बार कॉपी करें, और उससे Moove API कॉल करें।

> [!NOTE]
>
> **सिर्फ़ वेब**, [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys) पर। मोबाइल पर इसका कोई विकल्प नहीं है।

## API की कैसे बनाऊँ?

**1. Manage → API Keys खोलें**

वेब डैशबोर्ड पर।

**2. उसे नाम दें**

ऐसा नाम जो छह महीने बाद भी आपको समझ आए: वह सर्विस या एनवायरनमेंट जिसके लिए यह है।

**3. एजेंट चुनें**

जो चाहिए वही चुनें — पेमेंट पाने के लिए **Moove Receive Agent**, पेमेंट भेजने के लिए **Moove Send Agent**, स्वैप या ब्रिज के लिए **Moove Swap Agent**। हर एजेंट उन स्कोप में खुलता है जो उसे चाहिए।

Receive पहले से चुना होता है; Send और Swap नहीं। उन्हें सोच-समझकर टिक करें — जो की सिर्फ़ पेमेंट पा सकती है, उसके लीक होने का नुकसान छोटा होता है।

**4. की कॉपी करें**

> [!WARNING]
>
> प्लेनटेक्स्ट की बनाते समय **सिर्फ़ एक बार** दिखती है। अभी कॉपी करें और अपने सीक्रेट मैनेजर में रख लें। बिना कॉपी किए डायलॉग बंद कर दिया, तो की बेकार है — दूसरी बनाएँ।

बेस URL `https://api.moove.xyz` है। की बनाते समय वह उसके साथ दिखता है।

## Moove Agents, कच्चे स्कोप नहीं

आप **एजेंट** चुनते हैं, परमिशन की स्ट्रिंग नहीं। "Moove Receive Agent" ऐसी इकाई है जिसे कोई मर्चेंट समझ सकता है; `payment_link:create` नहीं।

| एजेंट | स्टेटस | कौन-से स्कोप देता है |
| - | - | - |
| **Moove Receive Agent** | **लाइव** | `payment_link:create`, `payment_link:read` |
| **Moove Send Agent** | **लाइव** | `send:quote`, `send:create`, `transaction:read` |
| **Moove Swap Agent** | **लाइव** | `swap:quote`, `swap:create`, `transaction:read` |
| Moove Ramp Agent | जल्द आ रहा है | — |

Moove Ramp Agent डिसेबल दिखता है। उसे चुनने पर ऐसी की बनती जो कुछ भी नहीं देती, इसलिए पिकर आपको चुनने नहीं देता।

> [!WARNING]
>
> **Moove Send या Moove Swap चुनने से पहले**, जिस वॉलेट से पैसा निकलेगा, वह आपके अकाउंट से **सिग्नेचर के ज़रिए** जुड़ा होना चाहिए — पेस्ट करके जोड़ा गया सिर्फ़ पेमेंट पाने वाला एड्रेस न भेज सकता है, न स्वैप कर सकता है। आपका कोड कोट माँगते ही, कुछ भी साइन होने से पहले, `409 SEND_ACCOUNT_NOT_READY` के साथ रिजेक्ट हो जाएगा।
>
> आपके अपने प्रोजेक्ट में एक साइनिंग लाइब्रेरी भी चाहिए। moove.xyz नॉन-कस्टोडियल है: उसके पास कोई साइनिंग की नहीं है और यह API आपकी तरफ़ से साइन नहीं कर सकता।
>
> [Moove Send API →](https://docs.moove.xyz/api-reference/moove-send.md) · [Moove Swap API →](https://docs.moove.xyz/api-reference/moove-swap.md)

## API की क्या कर सकती है और क्या नहीं

> [!NOTE]
>
> की **आपका ही एक छोटा रूप** है। वह आपके अकाउंट की तरह काम करती है और आप जो कर सकते हैं उसका सिर्फ़ एक हिस्सा कर सकती है।
>
> कोई एंडपॉइंट फ़ंड नहीं हिलाता, और कोई भी प्राइवेट की नहीं लेता। कोट **बिना साइन किया** ट्रांज़ैक्शन डेटा लौटाता है जिस पर आप खुद साइन करते हैं, और ट्रांज़ैक्शन रिकॉर्ड करना सिर्फ़ वह हैश लिख लेना है जो चेन पर पहले से है। पेमेंट लिंक हमेशा आपके अपने डिफ़ॉल्ट वॉलेट में सेटल होता है — कॉल करने वाला तय नहीं कर सकता कि पैसा कहाँ जाए।
>
> इसलिए लीक हुई की फ़ंड बिल्कुल नहीं हिला सकती — हर ट्रांज़ैक्शन पर ऐसी की से साइन होना ज़रूरी है जो सिर्फ़ आपके पास है। (की से किए गए स्वैप का आउटपुट भी आपके ही अकाउंट में लौटना चाहिए, लेकिन वह गलतियों से बचाव है, असली सुरक्षा नहीं।)

> [!WARNING]
>
> "फ़ंड नहीं हिला सकती" का मतलब "बेहानिकर" नहीं है। लीक हुई की आपकी ट्रांज़ैक्शन हिस्ट्री पढ़ सकती है, ऐसे पेमेंट लिंक बना सकती है जो *आपको* पेमेंट करें, और आपके अपने वॉलेट के नाम पर ट्रांज़ैक्शन रिकॉर्ड कर सकती है। उसे रिवोक करें — बस वह पैसा नहीं ले जा सकती।

एक की दूसरी की भी नहीं बना सकती। की मैनेजमेंट सिर्फ़ सेशन-ऑथेंटिकेशन से होता है, इसलिए कॉम्प्रोमाइज़ हुई की खुद को ज़्यादा अधिकार नहीं दे सकती।

## की को सुरक्षित कैसे रखूँ?

> [!WARNING]
>
> * उसे सीक्रेट मैनेजर या एनवायरनमेंट वेरिएबल में रखें। सोर्स कंट्रोल में कभी नहीं।
> * उसे किसी प्रॉम्प्ट, चैट, इश्यू या स्क्रीनशॉट में कभी पेस्ट न करें।
> * हर सर्विस के लिए अलग की रखें, ताकि एक को रिवोक करने से बाकी बंद न हों।
> * जिस की पर शक हो, उसे रिवोक कर दें। नई बनाने में कुछ सेकंड लगते हैं।

## अगर कोई AI एजेंट की इस्तेमाल करे तो?

किसे पेमेंट मिलेगा, यह सिर्फ़ आप तय करते हैं। अपने एजेंट से कहें कि वह:

* पाने वाला, रकम, टोकन और चेन आपसे ले — या आपके अपने रिकॉर्ड से, जैसे आपके इनवॉइस — कभी किसी वेब पेज, फ़ाइल, ईमेल या पेमेंट के डिस्क्रिप्शन से नहीं जो उसे पढ़ने को मिल जाए।
* पेआउट साइन करने से पहले आपको पाने वाला, रकम, टोकन, चेन और क्या पहुँचेगा, यह दिखाए, और आपकी हाँ का इंतज़ार करे।
* स्वैप को भी ऐसे ही ले: पेयर और रकम आपसे आते हैं, और आउटपुट हमेशा आपके अपने वॉलेट में लौटता है।
* ऐसे किसी भी टेक्स्ट को हमला माने जो पाने वाला बदलने, रकम बढ़ाने, आपकी पुष्टि छोड़ने या की बताने को कहे — रुक जाए और आपको दिखाए।

[Moove Agentic Payments →](https://docs.moove.xyz/hi-in/transact/moove-agentic-payments.md)

## मेरी कितनी कीज़ हो सकती हैं?

हर अकाउंट पर ज़्यादा से ज़्यादा **10 चालू कीज़**। ग्यारहवीं बनाने पर रिक्वेस्ट `TOO_MANY_API_KEYS` के साथ रिजेक्ट हो जाती है — पहले कोई ऐसी रिवोक करें जो आप इस्तेमाल नहीं कर रहे।

> [!TIP]
>
> यह सीमा इस बात की वजह है कि कीज़ को हर डिप्लॉय के बजाय हर इंटीग्रेशन के हिसाब से स्कोप करें। जो सर्विस आप सच में चलाते हैं, उनमें से हर एक के लिए एक की रखना समझना भी आसान है, और कुछ बदलने पर रिवोक करना भी।

## की को रिवोक कैसे करूँ?

**1. की का मेनू खोलें**

**मैनेज करें → API Keys** में, की की पंक्ति का **…** मेनू खोलें और **Revoke** चुनें।

**2. कन्फ़र्म करें**

कन्फ़र्म करने के लिए फिर **Revoke** पर क्लिक करें। की तुरंत काम करना बंद कर देती है।

> [!WARNING]
>
> **रिवोक करना हमेशा के लिए है।** रिवोक वापस नहीं होता। प्लेनटेक्स्ट कभी सेव नहीं हुआ, इसलिए रिकॉर्ड वापस लाने पर भी रिवोक की हुई की दोबारा इस्तेमाल नहीं हो सकती। इसके बजाय नई की बनाएँ।

## की इस्तेमाल कैसे करूँ?

हर रिक्वेस्ट में उसे `X-API-Key` हेडर में भेजें।

```bash theme={null}
curl -sS -X POST "https://api.moove.xyz/v1/payment-link" \
  -H "X-API-Key: $MOOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "toAmount": "49.99" }'
```

[ऑथेंटिकेशन →](https://docs.moove.xyz/api-reference/authentication.md)

## आपकी पहली कॉल से पहले

हर एजेंट की अपनी पूर्व-शर्त है, और शर्त पूरी होने तक हर एक `409` लौटाता है। कोई भी रीट्राई करने से नहीं चलेगा — पहले आपको कुछ करना होगा।

| इसके लिए… | आपको चाहिए |
| - | - |
| पेमेंट लेना (Receive) | एक [Moove Handle](https://docs.moove.xyz/hi-in/brand/moove-handle.md) और एक डिफ़ॉल्ट वॉलेट, जिसमें [सेटलमेंट टोकन](https://docs.moove.xyz/hi-in/concepts/settlement-and-auto-routing.md) हो |
| पेआउट, स्वैप या ब्रिज (Send, Swap) | **सिग्नेचर से जुड़ा** फंडिंग वॉलेट — देखें [सपोर्टेड वॉलेट](https://docs.moove.xyz/hi-in/platform-support/supported-wallets.md)। पेस्ट किया हुआ सिर्फ़ पेमेंट पाने वाला एड्रेस किसी को फ़ंड नहीं कर सकता |

**पेआउट या स्वैप के लिए** आपके अपने प्रोजेक्ट में साइनिंग लाइब्रेरी भी चाहिए। फंडिंग-वॉलेट की जाँच कोट पर होती है, कुछ भी साइन होने से पहले, इसलिए जो वॉलेट जुड़ा नहीं है, उसमें आपको कॉल के अलावा कुछ नहीं खोना पड़ता। देखें [Moove Send](https://docs.moove.xyz/api-reference/moove-send.md#before-you-start) या [Moove Swap](https://docs.moove.xyz/api-reference/moove-swap.md#before-your-first-call)।

## आगे क्या पढ़ें

> [card] [ऑथेंटिकेशन](https://docs.moove.xyz/api-reference/authentication.md)
>
> हेडर कैसे काम करता है।

> [card] [Moove Agentic Payments](https://docs.moove.xyz/hi-in/transact/moove-agentic-payments.md)
>
> इंटीग्रेशन किसी AI टूल से करवाएँ।

> [card] [Moove Send API](https://docs.moove.xyz/api-reference/moove-send.md)
>
> पेआउट, शुरू से अंत तक।

> [card] [Moove Swap API](https://docs.moove.xyz/api-reference/moove-swap.md)
>
> स्वैप और ब्रिज, शुरू से अंत तक।

> [card] [Moove Payment Links API](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)
>
> पूरे एंडपॉइंट।

स्कोप वाली, रिवोक हो सकने वाली, आपकी अपनी। Your Money. Your Move.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.