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

# Customers

> वह individual या business बनाएँ जो capabilities, accounts, और transfers का स्वामी है।

Pay-in, payout, या issued bank account बनाने से पहले customer बनाएँ। Capabilities, accounts, और transfers उस customer के scope में होते हैं। अपने system में संबंधित record की स्थिर mapping के रूप में `externalId` का उपयोग करें।

```bash theme={null}
export API_BASE='https://platform.swipelux.com'
export SWIPELUX_API_KEY='replace-with-your-api-key'
```

<h2 id="individual-customers">
  Individual customers
</h2>

एक individual के लिए केवल `type` आवश्यक है। जो profile fields आप पहले से जानते हैं उन्हें शामिल करें, और अधिक तब जोड़ें जब वर्तमान capability या task को उनकी आवश्यकता हो।

Customer को [`POST /v3/customers`](/api-reference/customers/post-v3-customers) के साथ बनाएँ:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-user-123" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "type": "individual",
  "externalId": "user_123",
  "individual": {
    "firstName": "Amina",
    "lastName": "Diallo",
    "residenceCountry": "FR"
  }
}
JSON
```

लौटाए गए `data.id` को `CUSTOMER_ID` के रूप में संग्रहीत करें। नीति संदर्भ के लिए [Individual onboarding](/hi/knowledge-base/individual-onboarding/overview) देखें।

<h2 id="business-customers">
  Business customers
</h2>

एक business के लिए `business.legalName` आवश्यक है। उसी operation के साथ business बनाएँ:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-company-456" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "type": "business",
  "externalId": "company_456",
  "business": {
    "legalName": "Acme Payments SAS"
  }
}
JSON
```

लौटाए गए `data.id` को `CUSTOMER_ID` के रूप में संग्रहीत करें। नीति और document संदर्भ के लिए [Business onboarding](/hi/knowledge-base/business-onboarding/overview) देखें।

## Business related parties जोड़ें

Directors, owners, और अन्य business participants को तब जोड़ें जब वे ज्ञात हों या अनुरोध किए गए हों। यह उदाहरण [`POST /v3/customers/{customerId}/related-parties`](/api-reference/customers/post-v3-customers-by-customer-id-related-parties) के साथ एक director बनाता है:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/related-parties" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: related-party-director-001" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "partyType": "person",
  "roles": ["director"],
  "title": "Chief executive officer",
  "person": {
    "firstName": "Amina",
    "lastName": "Diallo",
    "residenceCountry": "FR"
  }
}
JSON
```

लौटाए गए `data.id` को `RELATED_PARTY_ID` के रूप में संग्रहीत करें।

## Capabilities से readiness पढ़ें

API में एक customer की verification या readiness status नहीं होती। वर्तमान profile data के लिए customer को [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id) के साथ पढ़ें, फिर यह तय करने के लिए कि customer आगे क्या कर सकता है, capabilities और उनके `openTaskIds` का उपयोग करें।

```bash theme={null}
curl --request GET \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}"
```

आगे, आवश्यक product outcome को खोजने और सक्रिय करने के लिए [Capabilities और tasks](/hi/integration/onboarding/capabilities-and-requirements) पर जारी रखें।


## Related topics

- [v3 पर माइग्रेट करना](/hi/api-reference/versioning/migrate-to-v3.md)
- [Individual onboarding API workflow](/hi/knowledge-base/individual-onboarding/api-workflow.md)
- [KYB workflow](/hi/knowledge-base/business-onboarding/kyb-workflow.md)
- [Quickstart](/hi/integration/quickstart.md)
- [Business onboarding FAQ](/hi/knowledge-base/business-onboarding/faq.md)