1. Recipient बनाएँ
एक individual या business कोPOST /v3/customers/{customerId}/recipients के साथ बनाएँ। ये headers भेजें:
Request headers
Request body
relationship बताता है कि recipient आपके customer से कैसे संबंधित है। POST /v3/customers/{customerId}/recipients request schema से एक value चुनें। यदि आप other भेजते हैं, तो कोई अतिरिक्त free-text field न जोड़ें। Swipelux उन fields को ignore करता है जिन्हें request schema define नहीं करता, इसलिए वह text store नहीं होगा।
Fiat destination बनाने से पहले address शामिल करें। लौटाए गए recipient data.id को RECIPIENT_ID के रूप में संग्रहीत करें और इसकी वर्तमान status को बनाए रखें।
2. Destination जोड़ें
Endpoint कोPOST /v3/customers/{customerId}/recipients/{recipientId}/destinations के साथ बनाएँ। इस इच्छित destination के लिए एक नई key का उपयोग करें:
Request headers
- Bank destination
- Pix destination
- Pix Safe destination
- Wallet destination
pix_pooled) का ready होना ज़रूरी है। एक Pix destination किसी Pix key को भुगतान करता है: केवल digits में CPF या CNPJ, +55 के बाद 10 या 11 digits वाला phone number, email, या random key। एक Pix Safe destination ऐसे Brazilian bank account को भुगतान करता है जिसकी पहचान taxId में holder के CPF या CNPJ, bankCode में bank के 8-digit ISPB code, branch, और check digit सहित account number से होती है। Responses और webhooks taxId को उसके अंतिम चार digits छोड़कर masked रूप में लौटाते हैं।
जब आप bank destination बनाते हैं, तब Swipelux IBANs, BICs, ABA routing numbers, और CPF या CNPJ numbers जैसे bank identifiers को checksums सहित validate करता है। Malformed values 400 validation_error लौटाती हैं। ये checks केवल format की पुष्टि करते हैं, यह नहीं कि account मौजूद है या उसका मालिक कौन है।
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 पर ले जाएँ।