Recipients और destinations

Customer account का उपयोग तब करें जब customer endpoint का स्वामी हो। एक recipient और destination का उपयोग तब करें जब कोई अन्य व्यक्ति या व्यवसाय funds प्राप्त करे। Recipient यह record करता है कि कौन funds प्राप्त करता है। Destination यह record करता है कि वे कहाँ प्राप्त करते हैं।

1. Recipient बनाएँ

एक individual या business को POST /v3/customers/{customerId}/recipients के साथ बनाएँ। ये headers भेजें:

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-create-001
Content-Type: application/json

{
  "type": "individual",
  "relationship": "contractor",
  "firstName": "Jason",
  "lastName": "Swipelux",
  "email": "jason@swipelux.com",
  "phone": "+14155551234",
  "address": {
    "streetLine1": "1 Market Street",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94105",
    "country": "US"
  },
  "label": "Jason contractor"
}

relationship बताता है कि recipient आपके customer से कैसे संबंधित है। POST /v3/customers/{customerId}/recipients request schema से एक value चुनें। यदि आप other भेजते हैं, तो कोई अतिरिक्त free-text field न जोड़ें; schema unknown fields को अस्वीकार करता है। Fiat destination बनाने से पहले address शामिल करें। लौटाए गए recipient data.id को RECIPIENT_ID के रूप में संग्रहीत करें और इसकी वर्तमान status को बनाए रखें।

2. Destination जोड़ें

Endpoint को POST /v3/customers/{customerId}/recipients/{recipientId}/destinations के साथ बनाएँ। इस इच्छित destination के लिए एक नई key का उपयोग करें:

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-destination-create-001
Content-Type: application/json

Bank destination
Wallet destination

{
  "type": "ach",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Jason Swipelux",
    "country": "US"
  }
}

{
  "type": "wallet",
  "currency": "USDC",
  "ownership": {
    "type": "self_custodied"
  },
  "details": {
    "network": "base",
    "address": "0x1111111111111111111111111111111111111111"
  }
}

self_custodied का उपयोग केवल तब करें जब recipient wallet को नियंत्रित करता हो। जब wallet किसी अन्य custodian द्वारा रखा गया हो तो वर्तमान API Reference variant का पालन करें। लौटाए गए destination data.id को DESTINATION_ID के रूप में संग्रहीत करें और इसकी वर्तमान status बनाए रखें।

3. Destination readiness की प्रतीक्षा करें

Quote बनाने से पहले GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} पढ़ें। केवल तब जारी रखें जब वर्तमान destination status payout की अनुमति देती है और इसकी currency, method, और network इच्छित movement से मेल खाते हैं। Recipient और destination statuses स्वतंत्र हैं। Payout quote में dst_ destination ID का उपयोग करें। rcp_ recipient ID owner record की पहचान करता है और यह quote destination नहीं है। आगे, ready destination को Send funds पर ले जाएँ।

शुरू करें

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

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

लॉन्च

Recipients और destinations

1. Recipient बनाएँ

2. Destination जोड़ें

3. Destination readiness की प्रतीक्षा करें

​1. Recipient बनाएँ

​2. Destination जोड़ें

​3. Destination readiness की प्रतीक्षा करें

1. Recipient बनाएँ

2. Destination जोड़ें

3. Destination readiness की प्रतीक्षा करें