Funds भेजें

प्रत्येक payout एक ready, funded issued wallet से शुरू होता है। Destination model इस पर निर्भर करता है कि endpoint का स्वामी कौन है।

शुरू करने से पहले

Source wallet को पुन: प्राप्त करें। पुष्टि करें कि इसकी वर्तमान status payout की अनुमति देती है और इसका available balance इच्छित source amount को cover करता है। इसकी response से प्राप्त ID को SOURCE_WALLET_ID के रूप में संग्रहीत करें। आपको वर्तमान customer और चयनित destination के लिए एक ready payout capability भी चाहिए। मौजूदा Tron wallets एक stablecoin_transfers quote के साथ किसी अन्य Tron wallet को USDT भेज सकते हैं। Input और output को एक ही network और stablecoin का उपयोग करना होगा। आप Tron पर नए issued wallets नहीं बना सकते।

1. Destination तैयार करें

First-party
Third-party

एक customer-owned external bank account का उपयोग तब करें जब customer endpoint का स्वामी हो। इसे POST /v3/customers/{customerId}/accounts और इन headers के साथ बनाएँ:

Request headers

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

Request body

{
  "origin": "external",
  "type": "bank",
  "methods": ["ach", "wire"],
  "country": "US",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Acme Payments SAS"
  },
  "label": "Customer operating account"
}

इसे GET /v3/customers/{customerId}/accounts/{accountId} के साथ पढ़ें। केवल तब जारी रखें जब इसकी वर्तमान status payout की अनुमति देती है। इसके acc_ ID को PAYOUT_DESTINATION_ID के रूप में संग्रहीत करें।

Recipients और destinations के माध्यम से व्यक्ति या व्यवसाय और उनका bank या wallet endpoint बनाएँ। केवल तब जारी रखें जब destination ready हो।लौटाए गए dst_ ID को PAYOUT_DESTINATION_ID के रूप में संग्रहीत करें। Recipient के rcp_ ID का उपयोग quote destination के रूप में न करें।

2. Payout quote बनाएँ

इन headers के साथ POST /v3/quotes का उपयोग करें:

Request headers

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

Request body

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "in": {
    "amount": "150.00",
    "currency": "USDC",
    "accountId": "${SOURCE_WALLET_ID}"
  },
  "destinationId": "${PAYOUT_DESTINATION_ID}",
  "out": {
    "currency": "USD"
  }
}

data.id को QUOTE_ID के रूप में संग्रहीत करें और लौटाए गए price और fees प्रस्तुत करें।

Bank route चुनें

Crypto-to-fiat payout के लिए, आप customer के लिए एक approved bank route अनिवार्य करने हेतु वैकल्पिक institutionId सेट कर सकते हैं। Automatic routing का उपयोग करने के लिए इसे छोड़ दें।

Request body with institutionId

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "institutionId": "${INSTITUTION_ID}",
  "in": {
    "amount": "150.00",
    "currency": "USDC",
    "accountId": "${SOURCE_WALLET_ID}"
  },
  "destinationId": "${PAYOUT_DESTINATION_ID}",
  "out": {
    "currency": "USD"
  }
}

एक explicit institutionId कभी भी किसी अन्य bank पर fall back नहीं करता। जब चयनित bank के पास इस customer, capability और destination के लिए कोई ready route नहीं होता, तो POST /v3/quotes pointer /institutionId के साथ 422 bank_not_supported_for_customer लौटाता है।
institutionId केवल crypto-to-fiat payout quotes पर मान्य है। इसे pay-in, card या stablecoin transfer quote पर भेजने से 400 validation_error लौटता है।
जब bank की पहचान की जा सकती है, तो quote और transfer reads चयनित route का institutionId लौटाते हैं, जिसमें automatically चयनित route भी शामिल है।

SWIFT payouts

Production में, USD SWIFT payouts के लिए एक ready SWIFT capability चाहिए जो payouts को support करती हो (swift_pooled या swift_named), और इन्हें Ethereum, Base या Polygon पर USDC से, या Ethereum या Polygon पर USDT से fund किया जाता है। Fees के बाद recipient amount कम से कम 100.00 USD होना चाहिए। एक SWIFT destination को bankAddress, bankCity, bankState और bankPostalCode में bank का street address चाहिए। BIC country को bank country से मेल खाना चाहिए। Swipelux beneficiary address को customer या recipient profile से लेता है।

Pix payouts

Pix और Pix Safe recipient destinations BRL प्राप्त करते हैं। Customer की ready Pix capability (pix_pooled) के साथ payout quote करें, इसे USDC से fund करें, और out.currency को BRL पर set करें। USDT से BRL payout fund नहीं किया जा सकता। Pix payout पर developer fee नहीं लग सकती। अगर source account पर developer fees हैं, तो quote request में fees.breakdown.developer को {"fixed": "0.00", "bips": 0} पर set करें। अन्यथा, POST /v3/quotes 400 validation_error लौटाता है। Swipelux quote की pricing तभी करता है जब destination की bank details approve हो जाती हैं। जब तक उन्हें verify किया जा रहा है, POST /v3/quotes एक detail के साथ 400 validation_error लौटाता है जो बताता है कि destination अभी verify हो रहा है, इसलिए verification पूरा होने के बाद नया quote request करें। अगर bank details reject हो गई थीं या destination का setup अधूरा है, तो detail आपसे इसके बजाय support से संपर्क करने को कहता है, और support द्वारा setup पूरा करने तक नए quotes fail होते रहते हैं। अगर verification जाँचा नहीं जा सकता, तो यह 503 quote_temporarily_unavailable लौटाता है; बाद में retry करें।

3. Payout execute करें

Transfer को POST /v3/transfers के साथ बनाएँ। इस इच्छित execution के लिए एक नई key का उपयोग करें:

Request headers

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

Request body

{
  "quoteId": "${QUOTE_ID}"
}

Transfer data.id को TRANSFER_ID के रूप में संग्रहीत करें। एक सफल create payout शुरू करता है; यह delivery साबित नहीं करता।

4. Delivery track करें

Creation के बाद और प्रत्येक event के बाद GET /v3/transfers/{transferId} पढ़ें। नवीनतम data.state, data.stateDetail, और data.openTaskIds का उपयोग करके तय करें कि प्रतीक्षा करें, कार्य करें, या terminal outcome दिखाएँ। आगे, सटीक amounts, सुरक्षित execution recovery, और transfer tasks के लिए Quotes और transfers की समीक्षा करें।

शुरू करें

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

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

लॉन्च

Funds भेजें

शुरू करने से पहले

1. Destination तैयार करें

2. Payout quote बनाएँ

Bank route चुनें

SWIFT payouts

Pix payouts

3. Payout execute करें

4. Delivery track करें

​शुरू करने से पहले

​1. Destination तैयार करें

​2. Payout quote बनाएँ

​Bank route चुनें

​SWIFT payouts

​Pix payouts

​3. Payout execute करें

​4. Delivery track करें

शुरू करने से पहले

1. Destination तैयार करें

2. Payout quote बनाएँ

Bank route चुनें

SWIFT payouts

Pix payouts

3. Payout execute करें

4. Delivery track करें