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.

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:

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

{
  "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:

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

{
  "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.

3. Voer de uitbetaling uit

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

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

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

3. Voer de uitbetaling uit

4. Volg de bezorging

​Voordat je begint

​1. Bereid de destination voor

​2. Maak de uitbetalingsquote

​3. Voer de uitbetaling uit

​4. Volg de bezorging

Voordat je begint

1. Bereid de destination voor

2. Maak de uitbetalingsquote

3. Voer de uitbetaling uit

4. Volg de bezorging