Recipients en destinations

Gebruik een klantrekening wanneer de klant het eindpunt bezit. Gebruik een recipient en destination wanneer een andere persoon of bedrijf het geld ontvangt. De recipient registreert wie het geld ontvangt. De destination registreert waar zij het ontvangen.

1. Maak de recipient aan

Maak een individu of bedrijf aan met POST /v3/customers/{customerId}/recipients. Verstuur deze 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"
}

Voeg het adres toe voordat je een fiat-destination aanmaakt. Bewaar de geretourneerde recipient data.id als RECIPIENT_ID en behoud de huidige status.

2. Voeg een destination toe

Maak het eindpunt aan met POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Gebruik een nieuwe key voor deze beoogde destination:

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

Gebruik self_custodied alleen wanneer de recipient de wallet beheert. Volg de huidige API Reference-variant wanneer de wallet door een andere custodian wordt gehouden. Bewaar de geretourneerde destination data.id als DESTINATION_ID en behoud de huidige status.

3. Wacht op destination-readiness

Lees GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} voordat je een quote aanmaakt. Ga alleen verder wanneer de huidige destination-status de uitbetaling toestaat en de valuta, methode en netwerk overeenkomen met de beoogde beweging. Recipient- en destination-statussen zijn onafhankelijk. Gebruik de dst_ destination-ID in de uitbetalingsquote. De rcp_ recipient-ID identificeert het eigenaarsrecord en is geen quote-destination. Neem de ready destination vervolgens mee naar Geld versturen.

Aan de slag

Klanten onboarden

Geldstromen bouwen

Live gaan

Recipients en destinations

1. Maak de recipient aan

2. Voeg een destination toe

3. Wacht op destination-readiness

​1. Maak de recipient aan

​2. Voeg een destination toe

​3. Wacht op destination-readiness

1. Maak de recipient aan

2. Voeg een destination toe

3. Wacht op destination-readiness