Recipient e destination

Usa un conto cliente quando il cliente possiede l’endpoint. Usa un recipient e una destination quando un’altra persona o azienda riceve i fondi. Il recipient registra chi riceve i fondi. La destination registra dove li riceve.

1. Crea il recipient

Crea un individuo o un business con POST /v3/customers/{customerId}/recipients. Invia questi header:

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

Includi l’indirizzo prima di creare una destination fiat. Salva il data.id del recipient restituito come RECIPIENT_ID e conserva il suo stato corrente.

2. Aggiungi una destination

Crea l’endpoint con POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Usa una nuova chiave per questa destination prevista:

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-destination-create-001
Content-Type: application/json

Destination bancaria
Destination wallet

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

Usa self_custodied solo quando il recipient controlla il wallet. Segui la variante corrente dell’API Reference quando il wallet e’ detenuto da un altro custode. Salva il data.id della destination restituito come DESTINATION_ID e conserva il suo stato corrente.

3. Attendi la readiness della destination

Leggi GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} prima di creare un quote. Prosegui solo quando lo stato corrente della destination consente il payout e la sua valuta, metodo e network corrispondono al movimento previsto. Gli stati di recipient e destination sono indipendenti. Usa l’ID di destination dst_ nel quote di payout. L’ID rcp_ del recipient identifica il record del proprietario e non e’ una destination di quote. Successivamente, porta la destination ready in Invia fondi.

Inizia

Onboarding dei clienti

Costruisci i flussi di denaro

Lancio

Recipient e destination

1. Crea il recipient

2. Aggiungi una destination

3. Attendi la readiness della destination

​1. Crea il recipient

​2. Aggiungi una destination

​3. Attendi la readiness della destination

1. Crea il recipient

2. Aggiungi una destination

3. Attendi la readiness della destination