Geld versturen

Elke uitbetaling begint vanuit een ready, gefinancierde uitgegeven wallet. Het bestemmingsmodel hangt af van wie het eindpunt bezit.

Voordat je begint

Refetch de bron-wallet. Bevestig dat de huidige status de uitbetaling toestaat en dat het beschikbare saldo het beoogde bronbedrag dekt. Bewaar de ID uit de respons als SOURCE_WALLET_ID. Je hebt ook een ready uitbetalingscapability nodig voor de huidige klant en geselecteerde destination. Bestaande Tron-wallets kunnen USDT naar een andere Tron-wallet versturen met een stablecoin_transfers-quote. De input en output moeten hetzelfde netwerk en dezelfde stablecoin gebruiken. Je kunt geen nieuwe uitgegeven wallets op Tron aanmaken.

1. Bereid de destination voor

First-party
Third-party

Gebruik een externe bankrekening in bezit van de klant wanneer de klant het eindpunt bezit. Maak deze aan met POST /v3/customers/{customerId}/accounts en deze 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"
}

Lees hem met GET /v3/customers/{customerId}/accounts/{accountId}. Ga alleen verder wanneer de huidige status de uitbetaling toestaat. Bewaar de acc_-ID als PAYOUT_DESTINATION_ID.

Maak de persoon of het bedrijf en hun bank- of walleteindpunt aan via Recipients en destinations. Ga alleen verder wanneer de destination ready is.Bewaar de geretourneerde dst_-ID als PAYOUT_DESTINATION_ID. Gebruik niet de rcp_-ID van de recipient als quote-destination.

2. Maak de uitbetalingsquote

Gebruik POST /v3/quotes met deze headers:

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"
  }
}

Bewaar data.id als QUOTE_ID en toon de geretourneerde prijs en fees.

Kies een bankroute

Voor een crypto-naar-fiat-uitbetaling kun je de optionele institutionId instellen om een goedgekeurde bankroute voor de klant te vereisen. Laat deze weg om automatische routering te gebruiken.

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"
  }
}

Een expliciete institutionId valt nooit terug op een andere bank. Wanneer de geselecteerde bank geen ready route heeft voor deze klant, capability en destination, retourneert POST /v3/quotes 422 bank_not_supported_for_customer met de pointer /institutionId.
institutionId is alleen geldig bij crypto-naar-fiat-uitbetalingsquotes. Als je deze meestuurt bij een pay-in-, kaart- of stablecoin-transferquote, wordt 400 validation_error geretourneerd.
Reads van quotes en transfers geven de institutionId van de geselecteerde route terug, ook van een automatisch geselecteerde route, wanneer de bank kan worden geïdentificeerd.

SWIFT-uitbetalingen

In productie hebben USD SWIFT-uitbetalingen een ready SWIFT-capability nodig die uitbetalingen ondersteunt (swift_pooled of swift_named), en worden ze gefinancierd met USDC op Ethereum, Base of Polygon, of met USDT op Ethereum of Polygon. Het bedrag voor de ontvanger na fees moet minimaal 100.00 USD zijn. Een SWIFT-destination heeft het straatadres van de bank nodig in bankAddress, bankCity, bankState en bankPostalCode. Het BIC-land moet overeenkomen met het land van de bank. Swipelux haalt het adres van de begunstigde uit het profiel van de klant of recipient.

Pix-uitbetalingen

Pix- en Pix Safe-recipient-destinations ontvangen BRL. Maak de uitbetalingsquote met de ready Pix-capability van de klant (pix_pooled), financier hem met USDC en stel out.currency in op BRL. USDT kan geen BRL-uitbetaling financieren. Een Pix-uitbetaling kan geen developer fee bevatten. Als het bronaccount developer fees heeft, stel dan fees.breakdown.developer in op {"fixed": "0.00", "bips": 0} in de quote-aanvraag. Anders retourneert POST /v3/quotes 400 validation_error. Swipelux prijst de quote pas nadat de bankgegevens van de destination zijn goedgekeurd. Zolang ze worden geverifieerd, retourneert POST /v3/quotes 400 validation_error met een detail die aangeeft dat de destination nog wordt geverifieerd, dus vraag een nieuwe quote aan zodra de verificatie is voltooid. Als de bankgegevens zijn afgewezen of de setup van de destination onvolledig is, vraagt de detail je in plaats daarvan contact op te nemen met support, en blijven nieuwe quotes mislukken totdat support de setup voltooit. Als de verificatie niet kan worden gecontroleerd, retourneert het 503 quote_temporarily_unavailable; probeer het later opnieuw.

3. Voer de uitbetaling uit

Maak de transfer met POST /v3/transfers. Gebruik één nieuwe key voor deze beoogde uitvoering:

Request headers

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

Request body

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

Bewaar transfer data.id als TRANSFER_ID. Een succesvolle create start de uitbetaling; het bewijst niet dat deze is bezorgd.

4. Volg de bezorging

Lees GET /v3/transfers/{transferId} na aanmaken en na elke event. Gebruik de nieuwste data.state, data.stateDetail en data.openTaskIds om te beslissen of je wacht, handelt of een terminale uitkomst toont. Bekijk vervolgens Quotes en transfers voor exacte bedragen, veilige uitvoeringsrecovery en transfertaken.

Aan de slag

Klanten onboarden

Geldstromen bouwen

Live gaan

Voordat je begint

1. Bereid de destination voor

2. Maak de uitbetalingsquote

Kies een bankroute

SWIFT-uitbetalingen

Pix-uitbetalingen

3. Voer de uitbetaling uit

4. Volg de bezorging

​Voordat je begint

​1. Bereid de destination voor

​2. Maak de uitbetalingsquote

​Kies een bankroute

​SWIFT-uitbetalingen

​Pix-uitbetalingen

​3. Voer de uitbetaling uit

​4. Volg de bezorging

Voordat je begint

1. Bereid de destination voor

2. Maak de uitbetalingsquote

Kies een bankroute

SWIFT-uitbetalingen

Pix-uitbetalingen

3. Voer de uitbetaling uit

4. Volg de bezorging