Gelder senden

Jeder Payout beginnt aus einer bereiten, finanzierten ausgegebenen Wallet. Das Zielmodell hängt davon ab, wer den Endpunkt besitzt.

Bevor Sie beginnen

Rufen Sie die Quell-Wallet erneut ab. Bestätigen Sie, dass ihr aktueller Status den Payout erlaubt und ihr verfügbares Guthaben den beabsichtigten Quellbetrag deckt. Speichern Sie ihre aus der Antwort abgeleitete ID als SOURCE_WALLET_ID. Sie benötigen außerdem eine bereite Payout-Fähigkeit für den aktuellen Kunden und das ausgewählte Ziel. Bestehende Tron-Wallets können USDT mit einem stablecoin_transfers-Quote an eine andere Tron-Wallet senden. Eingang und Ausgang müssen dasselbe Netzwerk und denselben Stablecoin verwenden. Neue ausgegebene Wallets auf Tron können Sie nicht erstellen.

1. Das Ziel vorbereiten

Erstpartei
Drittpartei

Verwenden Sie ein kundeneigenes externes Bankkonto, wenn der Kunde den Endpunkt besitzt. Legen Sie es mit POST /v3/customers/{customerId}/accounts und diesen Headern an:

Request headers

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

Request body

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

Lesen Sie es mit GET /v3/customers/{customerId}/accounts/{accountId}. Fahren Sie nur fort, wenn sein aktueller Status den Payout erlaubt. Speichern Sie seine acc_-ID als PAYOUT_DESTINATION_ID.

Legen Sie die Person oder das Unternehmen und deren Bank- oder Wallet-Endpunkt über Empfänger und Ziele an. Fahren Sie nur fort, wenn das Ziel bereit ist.Speichern Sie die zurückgegebene dst_-ID als PAYOUT_DESTINATION_ID. Verwenden Sie nicht die rcp_-ID des Empfängers als Quote-Ziel.

2. Das Payout-Quote erstellen

Verwenden Sie POST /v3/quotes mit diesen Headern:

Request headers

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

Request body

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "in": {
    "amount": "150.00",
    "currency": "USDC",
    "accountId": "${SOURCE_WALLET_ID}"
  },
  "destinationId": "${PAYOUT_DESTINATION_ID}",
  "out": {
    "currency": "USD"
  }
}

Speichern Sie data.id als QUOTE_ID und präsentieren Sie den zurückgegebenen Preis und die Gebühren.

Eine Bankroute wählen

Bei einem Krypto-zu-Fiat-Payout können Sie die optionale institutionId setzen, um eine genehmigte Bankroute für den Kunden vorzuschreiben. Lassen Sie sie weg, um das automatische Routing zu verwenden.

Request body with institutionId

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "institutionId": "${INSTITUTION_ID}",
  "in": {
    "amount": "150.00",
    "currency": "USDC",
    "accountId": "${SOURCE_WALLET_ID}"
  },
  "destinationId": "${PAYOUT_DESTINATION_ID}",
  "out": {
    "currency": "USD"
  }
}

Eine explizite institutionId weicht nie auf eine andere Bank aus. Wenn die ausgewählte Bank keine bereite Route für diesen Kunden, diese Fähigkeit und dieses Ziel hat, gibt POST /v3/quotes 422 bank_not_supported_for_customer mit dem Pointer /institutionId zurück.
institutionId ist nur bei Krypto-zu-Fiat-Payout-Quotes gültig. Wird es bei einem Pay-in-, Karten- oder Stablecoin-Transfer-Quote gesendet, wird 400 validation_error zurückgegeben.
Quote- und Transfer-Lesevorgänge geben die institutionId der ausgewählten Route zurück, auch einer automatisch ausgewählten, sofern die Bank identifiziert werden kann.

SWIFT-Payouts

In der Produktion benötigen USD-SWIFT-Payouts eine bereite SWIFT-Fähigkeit, die Payouts unterstützt (swift_pooled oder swift_named), und werden mit USDC auf Ethereum, Base oder Polygon oder mit USDT auf Ethereum oder Polygon finanziert. Der Empfängerbetrag nach Gebühren muss mindestens 100.00 USD betragen. Ein SWIFT-Ziel benötigt die Straßenadresse der Bank in bankAddress, bankCity, bankState und bankPostalCode. Das BIC-Land muss mit dem Land der Bank übereinstimmen. Swipelux übernimmt die Adresse des Begünstigten aus dem Kunden- oder Empfängerprofil.

Pix-Payouts

Pix- und Pix Safe-Empfängerziele empfangen BRL. Erstellen Sie das Quote für den Payout mit der bereiten Pix-Fähigkeit des Kunden (pix_pooled), finanzieren Sie ihn mit USDC und setzen Sie out.currency auf BRL. USDT kann keinen BRL-Payout finanzieren. Ein Pix-Payout kann keine Entwicklergebühr enthalten. Wenn für das Quellkonto Entwicklergebühren gelten, setzen Sie in der Quote-Anfrage fees.breakdown.developer auf {"fixed": "0.00", "bips": 0}. Andernfalls gibt POST /v3/quotes 400 validation_error zurück. Swipelux bepreist das Quote erst, nachdem die Bankdaten des Ziels genehmigt wurden. Solange sie geprüft werden, gibt POST /v3/quotes 400 validation_error mit einem detail zurück, das besagt, dass das Ziel noch geprüft wird. Fordern Sie daher nach Abschluss der Prüfung ein neues Quote an. Wenn die Bankdaten abgelehnt wurden oder die Einrichtung des Ziels unvollständig ist, bittet Sie das detail stattdessen, den Support zu kontaktieren, und neue Quotes schlagen weiterhin fehl, bis der Support die Einrichtung abschließt. Wenn die Prüfung nicht abgefragt werden kann, wird 503 quote_temporarily_unavailable zurückgegeben; versuchen Sie es später erneut.

3. Payout ausführen

Erstellen Sie den Transfer mit POST /v3/transfers. Verwenden Sie einen neuen Schlüssel für diese beabsichtigte Ausführung:

Request headers

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

Request body

{
  "quoteId": "${QUOTE_ID}"
}

Speichern Sie die Transfer-data.id als TRANSFER_ID. Eine erfolgreiche Erstellung startet den Payout; sie belegt nicht die Zustellung.

4. Zustellung verfolgen

Lesen Sie GET /v3/transfers/{transferId} nach der Erstellung und nach jedem Ereignis. Verwenden Sie die neuesten data.state, data.stateDetail und data.openTaskIds, um zu entscheiden, ob Sie warten, handeln oder ein Endergebnis anzeigen sollen. Prüfen Sie als Nächstes Quotes und Transfers für exakte Beträge, sichere Ausführungswiederherstellung und Transfer-Aufgaben.

Erste Schritte

Kunden onboarden

Geldflüsse aufbauen

Livegang

Bevor Sie beginnen

1. Das Ziel vorbereiten

2. Das Payout-Quote erstellen

Eine Bankroute wählen

SWIFT-Payouts

Pix-Payouts

3. Payout ausführen

4. Zustellung verfolgen

​Bevor Sie beginnen

​1. Das Ziel vorbereiten

​2. Das Payout-Quote erstellen

​Eine Bankroute wählen

​SWIFT-Payouts

​Pix-Payouts

​3. Payout ausführen

​4. Zustellung verfolgen

Bevor Sie beginnen

1. Das Ziel vorbereiten

2. Das Payout-Quote erstellen

Eine Bankroute wählen

SWIFT-Payouts

Pix-Payouts

3. Payout ausführen

4. Zustellung verfolgen