Send midler

Hver payout starter fra en klar, finansiert utstedt lommebok. Destinasjonsmodellen avhenger av hvem som eier endepunktet.

Før du starter

Hent kildelommeboken på nytt. Bekreft at gjeldende status tillater payout-en og at tilgjengelig saldo dekker det tiltenkte kildebeløpet. Lagre dens responsavledede ID som SOURCE_WALLET_ID. Du trenger også en klar payout-capability for gjeldende kunde og valgt destinasjon. Eksisterende Tron-lommebøker kan sende USDT til en annen Tron-lommebok med et stablecoin_transfers-tilbud. Inn og ut må bruke samme nettverk og stablecoin. Du kan ikke opprette nye utstedte lommebøker på Tron.

1. Klargjør destinasjonen

Førsteparts
Tredjeparts

Bruk en kundeeid ekstern bankkonto når kunden eier endepunktet. Opprett den med POST /v3/customers/{customerId}/accounts og disse headerne:

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

Les den med GET /v3/customers/{customerId}/accounts/{accountId}. Fortsett kun når gjeldende status tillater payout-en. Lagre acc_-ID-en som PAYOUT_DESTINATION_ID.

Opprett personen eller virksomheten og deres bank- eller lommebok-endepunkt via Mottakere og destinasjoner. Fortsett kun når destinasjonen er klar.Lagre den returnerte dst_-ID-en som PAYOUT_DESTINATION_ID. Ikke bruk mottakerens rcp_-ID som tilbudsdestinasjon.

2. Opprett payout-tilbudet

Bruk POST /v3/quotes med disse headerne:

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

Lagre data.id som QUOTE_ID og presenter den returnerte prisen og gebyrene.

Velg en bankrute

For en payout fra krypto til fiat kan du angi den valgfrie institutionId for å kreve en godkjent bankrute for kunden. Utelat den for å bruke automatisk ruting.

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

En eksplisitt institutionId faller aldri tilbake til en annen bank. Når den valgte banken ikke har noen klar rute for denne kunden, capability-en og destinasjonen, returnerer POST /v3/quotes 422 bank_not_supported_for_customer med pekeren /institutionId.
institutionId er bare gyldig på payout-tilbud fra krypto til fiat. Å sende den på et pay-in-, kort- eller stablecoin-overføringstilbud returnerer 400 validation_error.
Lesing av tilbud og overføringer gjengir institutionId for den valgte ruten, også en automatisk valgt rute, når banken kan identifiseres.

SWIFT-payouts

I produksjon krever USD SWIFT-payouts en klar SWIFT-capability som støtter payouts (swift_pooled eller swift_named), og de finansieres med USDC på Ethereum, Base eller Polygon, eller med USDT på Ethereum eller Polygon. Mottakerbeløpet etter gebyrer må være minst 100.00 USD. En SWIFT-destinasjon trenger bankens gateadresse i bankAddress, bankCity, bankState og bankPostalCode. BIC-landet må samsvare med bankens land. Swipelux henter mottakerens adresse fra kunde- eller mottakerprofilen.

Pix-payouts

Pix- og Pix Safe-mottakerdestinasjoner mottar BRL. Be om tilbud på payout-en med kundens klare Pix-capability (pix_pooled), finansier den med USDC, og sett out.currency til BRL. USDT kan ikke finansiere en BRL-payout. En Pix-payout kan ikke ha et utviklergebyr. Hvis kildekontoen har utviklergebyrer, setter du fees.breakdown.developer til {"fixed": "0.00", "bips": 0} i tilbudsforespørselen. Ellers returnerer POST /v3/quotes 400 validation_error. Swipelux priser tilbudet først etter at bankopplysningene for destinasjonen er godkjent. Mens de verifiseres, returnerer POST /v3/quotes 400 validation_error med en detail som sier at destinasjonen fortsatt verifiseres, så be om et nytt tilbud når verifiseringen er fullført. Hvis bankopplysningene ble avvist eller oppsettet av destinasjonen er ufullstendig, ber detail deg i stedet kontakte støtte, og nye tilbud fortsetter å mislykkes til støtte har fullført oppsettet. Hvis verifiseringen ikke kan kontrolleres, returneres 503 quote_temporarily_unavailable; prøv igjen senere.

3. Utfør payout-en

Opprett overføringen med POST /v3/transfers. Bruk én ny nøkkel for denne tiltenkte utførelsen:

Request headers

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

Request body

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

Lagre overføringens data.id som TRANSFER_ID. En vellykket opprettelse starter payout-en; den beviser ikke levering.

4. Følg opp levering

Les GET /v3/transfers/{transferId} etter opprettelse og etter hver hendelse. Bruk siste data.state, data.stateDetail og data.openTaskIds for å avgjøre om du skal vente, handle eller vise et terminalt utfall. Deretter, gå gjennom Tilbud og overføringer for nøyaktige beløp, trygg utførelsesgjenoppretting og overføringsoppgaver.

Kom i gang

Kundeombording

Bygg pengestrømmer

Lansering

Før du starter

1. Klargjør destinasjonen

2. Opprett payout-tilbudet

Velg en bankrute

SWIFT-payouts

Pix-payouts

3. Utfør payout-en

4. Følg opp levering

​Før du starter

​1. Klargjør destinasjonen

​2. Opprett payout-tilbudet

​Velg en bankrute

​SWIFT-payouts

​Pix-payouts

​3. Utfør payout-en

​4. Følg opp levering

Før du starter

1. Klargjør destinasjonen

2. Opprett payout-tilbudet

Velg en bankrute

SWIFT-payouts

Pix-payouts

3. Utfør payout-en

4. Følg opp levering