Empfänger und Ziele

Verwenden Sie ein Kundenkonto, wenn dem Kunden der Endpunkt gehört. Verwenden Sie einen Empfänger und ein Ziel, wenn eine andere Person oder ein anderes Unternehmen die Gelder empfängt. Der Empfänger dokumentiert, wer Gelder empfängt. Das Ziel dokumentiert, wo sie sie empfangen.

1. Empfänger anlegen

Legen Sie eine Einzelperson oder ein Unternehmen mit POST /v3/customers/{customerId}/recipients an. Senden Sie diese 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"
}

Fügen Sie die Adresse hinzu, bevor Sie ein Fiat-Ziel anlegen. Speichern Sie die zurückgegebene Empfänger-data.id als RECIPIENT_ID und behalten Sie ihren aktuellen Status.

2. Ein Ziel hinzufügen

Legen Sie den Endpunkt mit POST /v3/customers/{customerId}/recipients/{recipientId}/destinations an. Verwenden Sie einen neuen Schlüssel für dieses beabsichtigte Ziel:

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

Bank-Ziel
Wallet-Ziel

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

Verwenden Sie self_custodied nur, wenn der Empfänger die Wallet kontrolliert. Folgen Sie der aktuellen API-Referenz-Variante, wenn die Wallet von einem anderen Verwahrer gehalten wird. Speichern Sie die zurückgegebene Ziel-data.id als DESTINATION_ID und behalten Sie ihren aktuellen Status.

3. Auf Zielbereitschaft warten

Lesen Sie GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId}, bevor Sie ein Quote erstellen. Fahren Sie nur fort, wenn der aktuelle Zielstatus den Payout erlaubt und seine Währung, Methode und Netzwerk mit der beabsichtigten Bewegung übereinstimmen. Empfänger- und Zielstatus sind unabhängig voneinander. Verwenden Sie die dst_-Ziel-ID im Payout-Quote. Die rcp_-Empfänger-ID identifiziert den Eigentümer-Datensatz und ist keine Quote-Ziel. Nehmen Sie als Nächstes das bereite Ziel zu Gelder senden.

Erste Schritte

Kunden onboarden

Geldflüsse aufbauen

Livegang

Empfänger und Ziele

1. Empfänger anlegen

2. Ein Ziel hinzufügen

3. Auf Zielbereitschaft warten

​1. Empfänger anlegen

​2. Ein Ziel hinzufügen

​3. Auf Zielbereitschaft warten

1. Empfänger anlegen

2. Ein Ziel hinzufügen

3. Auf Zielbereitschaft warten