Quickstart

एक customer बनाएँ, एक पुन: उपयोग करने योग्य wallet तैयार करें, और आवश्यक sandbox flow चलाएँ।

1. Sandbox कॉन्फ़िगर करें

अपने backend से एक sandbox API key का उपयोग करें:

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

Key साझा API host पर sandbox environment का चयन करती है।

2. एक customer बनाएँ

POST /v3/customers के साथ एक individual customer बनाएँ:

curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-customer-001" \
  --header "Content-Type: application/json" \
  --data '{"type":"individual","externalId":"quickstart-customer-001"}'

data.id को CUSTOMER_ID के रूप में संग्रहीत करें।

3. Outcome चुनें

Pay-in: USD प्राप्त करें और customer के issued wallet में USDC settle करें।
Payout: Customer के issued wallet से customer-owned bank account में USDC भेजें।
Issued bank account: एक ACH/USD account जारी करें जो customer के issued wallet में settle होता है।

Third-party payout के लिए, Recipients या Send funds का पालन करें।

4. एक eligible capability खोजें

समर्थित capabilities को GET /v3/customers/{customerId}/capabilities/supported के साथ सूचीबद्ध करें:

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

एक response entry चुनें जिसमें availability available या beta पर सेट हो, eligibility.eligible true पर सेट हो, आवश्यक directions और method, और मेल खाता accountType हो। Pay-in destination, payout source, या bank-account settlement account के रूप में customer के issued wallet का उपयोग करें; इस payout path के लिए destinationId के रूप में customer-owned account का उपयोग करें। यदि institutions लौटाए जाते हैं, तो केवल एक लौटाए गए institution choice का उपयोग करें। Entry के id को CAPABILITY_ID के रूप में संग्रहीत करें; एक universal capability ID को hardcode न करें।

5. Capability का अनुरोध करें

चुनी गई capability का अनुरोध POST /v3/customers/{customerId}/capabilities/{capabilityId} के साथ करें:

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/capabilities/${CAPABILITY_ID}" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-capability-001" \
  --header "Content-Type: application/json" \
  --data '{}'

data.status को CAPABILITY_STATUS और data.openTaskIds को TASK_IDS के रूप में संग्रहीत करें।

6. Sandbox में onboarding पूरा करें

यदि TASK_IDS खाली नहीं है, तो Capabilities और tasks के माध्यम से प्रत्येक वर्तमान आवश्यकता पूरी करें। इस walkthrough के लिए, capability को POST /v3/sandbox/customers/{customerId}/capabilities/{capabilityId}/status के साथ ready पर सेट करें:

curl --request POST \
  "${API_BASE}/v3/sandbox/customers/${CUSTOMER_ID}/capabilities/${CAPABILITY_ID}/status" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"status":"ready"}'

यह test control production onboarding नहीं है। GET /v3/customers/{customerId}/capabilities/{capabilityId} के साथ पुन: प्राप्त करें:

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

data.status और data.openTaskIds से CAPABILITY_STATUS और TASK_IDS को refresh करें। केवल तब जारी रखें जब CAPABILITY_STATUS ready हो।

7. चयनित flow बनाएँ

Base पर एक issued USDC wallet POST /v3/customers/{customerId}/accounts के साथ बनाएँ:

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/accounts" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-flow-wallet-001" \
  --header "Content-Type: application/json" \
  --data '{"origin":"issued","type":"wallet","currency":"USDC","network":"base"}'

data.id को FLOW_WALLET_ID, data.status को FLOW_WALLET_STATUS, और data.openTaskIds को FLOW_WALLET_TASK_IDS के रूप में संग्रहीत करें। यदि FLOW_WALLET_TASK_IDS खाली नहीं है, तो Capabilities और tasks के माध्यम से वर्तमान tasks पूरे करें। Wallet को GET /v3/customers/{customerId}/accounts/{accountId} के साथ पुन: प्राप्त करें:

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

data.status और data.openTaskIds से FLOW_WALLET_STATUS और FLOW_WALLET_TASK_IDS को refresh करें। केवल तब जारी रखें जब FLOW_WALLET_STATUS ready हो।

Pay-in
Payout
Issued bank account

POST /v3/quotes के साथ USD-to-USDC quote बनाएँ:

curl --request POST \
  "${API_BASE}/v3/quotes" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-payin-quote-001" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{"customerId":"${CUSTOMER_ID}","capabilityId":"${CAPABILITY_ID}","in":{"amount":"150.00","currency":"USD"},"destinationId":"${FLOW_WALLET_ID}","out":{"currency":"USDC"}}
JSON

data.id को QUOTE_ID के रूप में संग्रहीत करें, फिर उसे POST /v3/transfers के साथ execute करें:

curl --request POST \
  "${API_BASE}/v3/transfers" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-payin-transfer-001" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{"quoteId":"${QUOTE_ID}"}
JSON

data.id को TRANSFER_ID के रूप में संग्रहीत करें। Instructions को GET /v3/transfers/{transferId}/instructions के साथ प्राप्त करें:

curl --request GET \
  "${API_BASE}/v3/transfers/${TRANSFER_ID}/instructions" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}"

Response में data.transferId और data.instructions होते हैं। data.transferId को TRANSFER_ID और data.instructions को FUNDING_INSTRUCTIONS के रूप में संग्रहीत करें।

Ready wallet को POST /v3/sandbox/accounts/{accountId}/topup के साथ fund करें:

curl --request POST \
  "${API_BASE}/v3/sandbox/accounts/${FLOW_WALLET_ID}/topup" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"amount":"250.00","currency":"USDC"}'

POST /v3/customers/{customerId}/accounts के साथ एक customer-owned ACH account बनाएँ:

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/accounts" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-payout-account-001" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{"origin":"external","type":"bank","methods":["ach"],"country":"US","currency":"USD","details":{"routingNumber":"021000021","accountNumber":"123456789","accountType":"checking","bankName":"Example Bank","accountHolderName":"Amina Diallo"}}
JSON

data.id को PAYOUT_ACCOUNT_ID, data.status को PAYOUT_ACCOUNT_STATUS, और data.openTaskIds को PAYOUT_ACCOUNT_TASK_IDS के रूप में संग्रहीत करें। यदि PAYOUT_ACCOUNT_TASK_IDS खाली नहीं है, तो Capabilities और tasks के माध्यम से वर्तमान tasks पूरे करें।इसे GET /v3/customers/{customerId}/accounts/{accountId} के साथ पुन: प्राप्त करें:

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

data.status और data.openTaskIds से PAYOUT_ACCOUNT_STATUS और PAYOUT_ACCOUNT_TASK_IDS को refresh करें। केवल तब जारी रखें जब PAYOUT_ACCOUNT_STATUS ready हो, फिर POST /v3/quotes के साथ quote बनाएँ:

curl --request POST \
  "${API_BASE}/v3/quotes" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-payout-quote-001" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{"customerId":"${CUSTOMER_ID}","capabilityId":"${CAPABILITY_ID}","in":{"amount":"150.00","currency":"USDC","accountId":"${FLOW_WALLET_ID}"},"destinationId":"${PAYOUT_ACCOUNT_ID}","out":{"currency":"USD"}}
JSON

data.id को QUOTE_ID के रूप में संग्रहीत करें, इसे POST /v3/transfers के साथ execute करें, और लौटाए गए data.id को TRANSFER_ID के रूप में संग्रहीत करें:

curl --request POST \
  "${API_BASE}/v3/transfers" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-payout-transfer-001" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{"quoteId":"${QUOTE_ID}"}
JSON

Ready wallet पर settle होने वाला एक ACH/USD account POST /v3/customers/{customerId}/accounts के साथ बनाएँ:

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/accounts" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}" \
  --header "Idempotency-Key: quickstart-bank-account-001" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{"origin":"issued","type":"bank","method":"ach","country":"US","currency":"USD","settlement":{"accountId":"${FLOW_WALLET_ID}"}}
JSON

data.id को BANK_ACCOUNT_ID के रूप में संग्रहीत करें, फिर GET /v3/customers/{customerId}/accounts/{accountId} के साथ provisioning पढ़ें:

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

data.status को BANK_ACCOUNT_STATUS, data.details को BANK_ACCOUNT_DETAILS, और data.openTaskIds को BANK_ACCOUNT_TASK_IDS के रूप में संग्रहीत करें। किसी भी वर्तमान tasks को पूरा करें, फिर account को तब तक फिर से पढ़ें जब तक इसकी status उपयोग की अनुमति नहीं देती और data.details मौजूद नहीं है।Bank details तुरंत मौजूद नहीं हो सकतीं। शाखा तब पूरी होती है जब आप BANK_ACCOUNT_DETAILS में लौटाए गए सटीक पुन: उपयोग करने योग्य bank details प्रस्तुत कर सकते हैं। जब account अभी भी provisioning में हो तब placeholder coordinates कभी न बनाएँ या दिखाएँ।

Pay-ins और payouts के लिए, GET /v3/transfers/{transferId} के साथ TRANSFER_ID की निगरानी करें:

curl --request GET \
  "${API_BASE}/v3/transfers/${TRANSFER_ID}" \
  --header "X-API-Key: ${SWIPELUX_SANDBOX_API_KEY}"

Pay-in

पूर्ण pay-in flow बनाएँ।

Payout

Production payout handling बनाएँ।

Issued bank account

Provisioning और details संभालें।

आगे, webhooks जोड़ें। ऊपर दिया गया प्रत्येक request पहले से ही अपने पूर्ण API Reference schema और status page से जुड़ा है।

शुरू करें

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

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

लॉन्च

1. Sandbox कॉन्फ़िगर करें

2. एक customer बनाएँ

3. Outcome चुनें

4. एक eligible capability खोजें

5. Capability का अनुरोध करें

6. Sandbox में onboarding पूरा करें

7. चयनित flow बनाएँ

Pay-in

Payout

Issued bank account

​1. Sandbox कॉन्फ़िगर करें

​2. एक customer बनाएँ

​3. Outcome चुनें

​4. एक eligible capability खोजें

​5. Capability का अनुरोध करें

​6. Sandbox में onboarding पूरा करें

​7. चयनित flow बनाएँ

Pay-in

Payout

Issued bank account

1. Sandbox कॉन्फ़िगर करें

2. एक customer बनाएँ

3. Outcome चुनें

4. एक eligible capability खोजें

5. Capability का अनुरोध करें

6. Sandbox में onboarding पूरा करें

7. चयनित flow बनाएँ