Customers

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

export API_BASE='https://platform.swipelux.com'
export SWIPELUX_API_KEY='replace-with-your-api-key'

Individual customers

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

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 देखें।

Business customers

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

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 देखें। Directors, owners, और अन्य business participants को तब जोड़ें जब वे ज्ञात हों या अनुरोध किए गए हों। यह उदाहरण POST /v3/customers/{customerId}/related-parties के साथ एक director बनाता है:

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} के साथ पढ़ें, फिर यह तय करने के लिए कि customer आगे क्या कर सकता है, capabilities और उनके openTaskIds का उपयोग करें।

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

आगे, आवश्यक product outcome को खोजने और सक्रिय करने के लिए Capabilities और tasks पर जारी रखें।

शुरू करें

ग्राहकों को शामिल करें

धन प्रवाह बनाएँ

लॉन्च

Individual customers

Business customers

Capabilities से readiness पढ़ें

​Individual customers

​Business customers

​Business related parties जोड़ें

​Capabilities से readiness पढ़ें

Individual customers

Business customers

Business related parties जोड़ें

Capabilities से readiness पढ़ें