Lähetä varoja

Jokainen maksu ulos alkaa valmiista, rahoitetusta luodusta lompakosta. Kohdemalli riippuu siitä, kuka omistaa päätepisteen.

Ennen kuin aloitat

Hae lähdelompakko uudelleen. Vahvista, että sen nykyinen tila sallii maksun ja että sen käytettävissä oleva saldo kattaa aiotun lähdesumman. Tallenna sen vastauksesta johdettu ID muuttujaan SOURCE_WALLET_ID. Tarvitset myös valmiin maksu ulos -kyvyn nykyiselle asiakkaalle ja valitulle kohteelle. Olemassa olevat Tron-lompakot voivat lähettää USDT:tä toiseen Tron-lompakkoon stablecoin_transfers-tarjouksella. Syötteen ja tuotoksen on käytettävä samaa verkkoa ja samaa stablecoinia. Uusia luotuja lompakkoja ei voi luoda Tron-verkkoon.

1. Valmistele kohde

Ensimmäinen osapuoli
Kolmas osapuoli

Käytä asiakkaan omistamaa ulkoista pankkitiliä, kun asiakas omistaa päätepisteen. Luo se POST /v3/customers/{customerId}/accounts -toiminnolla ja näillä otsakkeilla:

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

Lue se GET /v3/customers/{customerId}/accounts/{accountId} -toiminnolla. Jatka vain, kun sen nykyinen tila sallii maksun. Tallenna sen acc_-ID muuttujaan PAYOUT_DESTINATION_ID.

Luo henkilö tai yritys ja heidän pankki- tai lompakkopäätepisteensä Vastaanottajat ja kohteet -kautta. Jatka vain, kun kohde on valmis.Tallenna palautettu dst_-ID muuttujaan PAYOUT_DESTINATION_ID. Älä käytä vastaanottajan rcp_-ID:tä tarjouksen kohteena.

2. Luo maksu ulos -tarjous

Käytä POST /v3/quotes -toimintoa näillä otsakkeilla:

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

Tallenna data.id muuttujaan QUOTE_ID ja esitä palautettu hinta ja maksut.

Valitse pankkireitti

Krypto-fiat-maksussa ulos voit asettaa valinnaisen institutionId-arvon edellyttääksesi asiakkaalle hyväksyttyä pankkireittiä. Jätä se pois, jos haluat käyttää automaattista reititystä.

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

Nimenomaisesti annettu institutionId ei koskaan vaihdu toiseen pankkiin. Kun valitulla pankilla ei ole valmista reittiä tälle asiakkaalle, kyvylle ja kohteelle, POST /v3/quotes palauttaa 422 bank_not_supported_for_customer osoittimella /institutionId.
institutionId on sallittu vain krypto-fiat-maksu ulos -tarjouksissa. Sen lähettäminen maksun vastaanotto-, kortti- tai stablecoin-siirtotarjouksessa palauttaa 400 validation_error.
Tarjousten ja siirtojen lukupyynnöt palauttavat valitun reitin institutionId-arvon, myös automaattisesti valitun, kun pankki voidaan tunnistaa.

SWIFT-maksut ulos

Tuotannossa USD-määräiset SWIFT-maksut ulos edellyttävät valmista SWIFT-kykyä, joka tukee maksuja ulos (swift_pooled tai swift_named), ja ne rahoitetaan USDC:llä Ethereumissa, Basessa tai Polygonissa tai USDT:llä Ethereumissa tai Polygonissa. Vastaanottajan summan maksujen jälkeen on oltava vähintään 100.00 USD. SWIFT-kohde tarvitsee pankin katuosoitteen kenttiin bankAddress, bankCity, bankState ja bankPostalCode. BIC-koodin maan on vastattava pankin maata. Swipelux ottaa edunsaajan osoitteen asiakkaan tai vastaanottajan profiilista.

Pix-maksut ulos

Pix- ja Pix Safe -tyyppiset vastaanottajan kohteet vastaanottavat BRL:ää. Pyydä maksulle ulos tarjous asiakkaan valmiilla Pix-kyvyllä (pix_pooled), rahoita se USDC:llä ja aseta out.currency arvoon BRL. USDT:llä ei voi rahoittaa BRL-maksua ulos. Pix-maksuun ulos ei voi sisältyä kehittäjämaksua. Jos lähdetilillä on kehittäjämaksuja, aseta tarjouspyynnössä fees.breakdown.developer arvoon {"fixed": "0.00", "bips": 0}. Muuten POST /v3/quotes palauttaa 400 validation_error. Swipelux hinnoittelee tarjouksen vasta, kun kohteen pankkitiedot on hyväksytty. Niiden vahvistuksen aikana POST /v3/quotes palauttaa 400 validation_error, jonka detail kertoo, että kohdetta vahvistetaan vielä, joten pyydä uusi tarjous, kun vahvistus on valmis. Jos pankkitiedot hylättiin tai kohteen määritys on kesken, detail pyytää sen sijaan ottamaan yhteyttä tukeen, ja uudet tarjoukset epäonnistuvat edelleen, kunnes tuki viimeistelee määrityksen. Jos vahvistusta ei voida tarkistaa, se palauttaa 503 quote_temporarily_unavailable; yritä myöhemmin uudelleen.

3. Suorita maksu ulos

Luo siirto POST /v3/transfers -toiminnolla. Käytä yhtä uutta avainta tälle aiotulle suoritukselle:

Request headers

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

Request body

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

Tallenna siirron data.id muuttujaan TRANSFER_ID. Onnistunut luonti käynnistää maksun; se ei todista toimitusta.

4. Seuraa toimitusta

Lue GET /v3/transfers/{transferId} luonnin jälkeen ja jokaisen tapahtuman jälkeen. Käytä uusinta data.state-, data.stateDetail- ja data.openTaskIds-arvoa päättääksesi, odottaako, toimiako vai näyttääkö lopullinen tulos. Seuraavaksi tutustu kohtaan Tarjoukset ja siirrot tarkkojen summien, turvallisen suoritustoipumisen ja siirtotehtävien osalta.

Aloita

Asiakkaiden käyttöönotto

Rakenna rahavirrat

Julkaisu

Ennen kuin aloitat

1. Valmistele kohde

2. Luo maksu ulos -tarjous

Valitse pankkireitti

SWIFT-maksut ulos

Pix-maksut ulos

3. Suorita maksu ulos

4. Seuraa toimitusta

​Ennen kuin aloitat

​1. Valmistele kohde

​2. Luo maksu ulos -tarjous

​Valitse pankkireitti

​SWIFT-maksut ulos

​Pix-maksut ulos

​3. Suorita maksu ulos

​4. Seuraa toimitusta

Ennen kuin aloitat

1. Valmistele kohde

2. Luo maksu ulos -tarjous

Valitse pankkireitti

SWIFT-maksut ulos

Pix-maksut ulos

3. Suorita maksu ulos

4. Seuraa toimitusta