Fähigkeiten und Aufgaben

Eine Fähigkeit sagt Ihnen, ob ein Kunde ein bestimmtes Ergebnis, eine Zahlungsmethode und Richtung verwenden kann. Offene Aufgaben sagen Ihnen, was passieren muss, bevor diese Fähigkeit oder eine zugehörige Ressource fortgesetzt werden kann.

export API_BASE='https://platform.swipelux.com'
export SWIPELUX_API_KEY='replace-with-your-api-key'

Unterstützte Fähigkeiten entdecken

Lesen Sie die aktuellen Optionen des Kunden mit GET /v3/customers/{customerId}/capabilities/supported:

curl --request GET \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/capabilities/supported" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}"

Wählen Sie einen Antwort-Eintrag, der den beabsichtigten directions, method und accountType entspricht. Fahren Sie nur fort, wenn availability gleich available oder beta und eligibility.eligible gleich true ist. Wenn institutions zurückgegeben werden, wählen Sie nur eine ID aus dieser Antwort aus. Speichern Sie die ausgewählte data[].id als CAPABILITY_ID. Kopieren Sie niemals eine Fähigkeits-ID von einem anderen Kunden oder aus einer anderen Umgebung.

Pooled vs. named Kontotypen

Bank-Fähigkeiten gibt es in zwei Varianten, kodiert im Feld accountType und dem Fähigkeits-ID-Suffix (zum Beispiel ach_pooled, wire_named):

pooled: gemeinsam genutztes Swipelux-Bankkonto. Jedes Pay-in verwendet eine eindeutige Referenz, um Gelder weiterzuleiten. Wählen Sie dies für einmalige Transfers.
named: dedizierte Bankdaten für den Kunden (virtuelle IBAN, dediziertes ACH-Konto). Wiederverwendbar und mit jedem Zahler teilbar. Erforderlich für ausgegebene Bankkonten.

Standardmäßig pooled. Verwenden Sie named nur, wenn der Kunde wiederverwendbare Bankdaten benötigt. Prüfen Sie die supported-Antwort, um zu sehen, welche Varianten verfügbar sind.

Fähigkeit anfordern

Fordern Sie die ausgewählte Option mit POST /v3/customers/{customerId}/capabilities/{capabilityId} an:

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/capabilities/${CAPABILITY_ID}" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: capability-request-001" \
  --header "Content-Type: application/json" \
  --data '{}'

Verwenden Sie ein explizites institutions-Array nur, wenn Sie aus IDs auswählen müssen, die von der Supported-Capability-Antwort zurückgegeben wurden. Speichern Sie data.status als CAPABILITY_STATUS, data.openTaskIds als OPEN_TASK_IDS und jede data.applications[].id in APPLICATION_IDS.

Aktuelle Aufgaben erledigen

Listen Sie Aufgaben mit GET /v3/customers/{customerId}/tasks auf, wählen Sie IDs aus OPEN_TASK_IDS aus und lesen Sie dann jede aktuelle Aufgabe mit GET /v3/customers/{customerId}/tasks/{taskId}:

curl --request GET \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/tasks/${TASK_ID}" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}"

Verwenden Sie die neuesten data.revision und data.requirements. Rufen Sie die Aufgabe unmittelbar vor dem Absenden erneut ab, wenn sich eines von beiden geändert haben könnte.

Gehostete Aktionen

Wenn die Aufgabe verificationSessions oder tosSessions zurückgibt, speichern Sie jede Session-id und aktuelle url. Senden Sie den Kunden an die zurückgegebene URL und lesen Sie die Aufgabe dann erneut. Dies sind aufgabenbezogene Aktionen, kein separater Kundenverifizierungs-Lebenszyklus.

Dokumente hochladen

Wenn eine Anforderung ein Dokument verlangt, laden Sie es mit POST /v3/customers/{customerId}/documents hoch:

export DOCUMENT_PATH='/absolute/path/to/requested-document.pdf'

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/documents" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-document-001" \
  --form "file=@${DOCUMENT_PATH}"

Speichern Sie die zurückgegebene data.id als DOCUMENT_ID, bevor Sie die Antwort einreichen, die darauf verweist.

API-Antworten

Reichen Sie einen vollständigen Antwortsatz für die aktuelle Revision mit POST /v3/customers/{customerId}/tasks/{taskId}/submissions ein:

curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/tasks/${TASK_ID}/submissions" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: task-submission-001" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "taskRevision": 3,
  "answers": [
    {
      "requirementId": "req_from_current_task",
      "answer": {
        "type": "text",
        "value": "Current answer"
      }
    }
  ]
}
JSON

Übernehmen Sie jede Anforderungs-ID und jeden Antworttyp aus der neuesten Aufgabe. Wenn die API meldet, dass sich die Aufgabe geändert hat, rufen Sie sie erneut ab und bauen Sie die Einreichung aus der neuen Revision neu auf.

Fortfahren, wenn die Fähigkeit bereit ist

Lesen Sie die Fähigkeit erneut mit GET /v3/customers/{customerId}/capabilities/{capabilityId}:

curl --request GET \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/capabilities/${CAPABILITY_ID}" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}"

Ersetzen Sie den gespeicherten Status und die Aufgaben-IDs durch die neueste Antwort. Fahren Sie nur fort, wenn der aktuelle Fähigkeitsstatus das Konto, das Quote oder den Transfer erlaubt, den Sie erstellen möchten. Wählen Sie als Nächstes die passende Reise in Häufige Abläufe.

Erste Schritte

Kunden onboarden

Geldflüsse aufbauen

Livegang

Fähigkeiten und Aufgaben

Unterstützte Fähigkeiten entdecken

Pooled vs. named Kontotypen

Fähigkeit anfordern

Aktuelle Aufgaben erledigen

Gehostete Aktionen

Dokumente hochladen

API-Antworten

Fortfahren, wenn die Fähigkeit bereit ist

​Unterstützte Fähigkeiten entdecken

​Pooled vs. named Kontotypen

​Fähigkeit anfordern

​Aktuelle Aufgaben erledigen

​Gehostete Aktionen

​Dokumente hochladen

​API-Antworten

​Fortfahren, wenn die Fähigkeit bereit ist

Unterstützte Fähigkeiten entdecken

Pooled vs. named Kontotypen

Fähigkeit anfordern

Aktuelle Aufgaben erledigen

Gehostete Aktionen

Dokumente hochladen

API-Antworten

Fortfahren, wenn die Fähigkeit bereit ist