Mielőtt kezdi
Frissítse le a forrás tárcát. Erősítse meg, hogy az aktuális státusza engedi a kifizetést és a rendelkezésre álló egyenlege fedezi a szándékolt forrásösszeget. Tárolja a válaszból származó azonosítótSOURCE_WALLET_ID-ként.
Szüksége van egy kész kifizetési képességre is az aktuális ügyfélhez és kiválasztott célponthoz.
A meglévő Tron tárcák egy stablecoin_transfers árajánlattal küldhetnek USDT-t egy másik Tron tárcába. A bemenetnek és a kimenetnek ugyanazt a hálózatot és stablecoint kell használnia. Tronon nem hozhat létre új kibocsátott tárcákat.
1. A célpont előkészítése
- Saját tulajdonú
- Harmadik fél
Használjon egy ügyfél tulajdonában lévő külső bankszámlát, amikor az ügyfél tulajdonolja a végpontot. Hozza létre a Olvassa be a
POST /v3/customers/{customerId}/accounts művelettel és ezekkel a fejlécekkel:Request headers
Request body
GET /v3/customers/{customerId}/accounts/{accountId} művelettel. Csak akkor folytassa, ha az aktuális státusza engedi a kifizetést. Tárolja a acc_ azonosítót PAYOUT_DESTINATION_ID-ként.2. A kifizetési árajánlat létrehozása
Használja aPOST /v3/quotes műveletet ezekkel a fejlécekkel:
Request headers
Request body
data.id értéket QUOTE_ID-ként, és jelenítse meg a visszaadott árat és díjakat.
Banki útvonal kiválasztása
Kripto–fiat kifizetésnél megadhatja az opcionálisinstitutionId mezőt, hogy az ügyfél számára jóváhagyott banki útvonalat követeljen meg. Hagyja el az automatikus útvonalválasztás használatához.
Request body with institutionId
- A kifejezetten megadott
institutionIdsoha nem vált át másik bankra. Ha a kiválasztott banknak nincs kész útvonala ehhez az ügyfélhez, képességhez és célponthoz, aPOST /v3/quotes422bank_not_supported_for_customerhibát ad vissza a/institutionIdmutatóval. - Az
institutionIdcsak kripto–fiat kifizetési árajánlatokon érvényes. Ha pénzbefizetési, kártyás vagy stablecoin-átutalási árajánlaton küldi,400validation_errorhibát kap. - Az árajánlatok és átutalások olvasása visszaadja a kiválasztott útvonal
institutionIdértékét, az automatikusan kiválasztottét is, ha a bank azonosítható.
SWIFT-kifizetések
Éles környezetben az USD SWIFT-kifizetésekhez olyan kész SWIFT-képesség szükséges, amely támogatja a kifizetéseket (swift_pooled vagy swift_named), a fedezetük pedig USDC Ethereumon, Base-en vagy Polygonon, illetve USDT Ethereumon vagy Polygonon. A címzett díjak utáni összegének legalább 100.00 USD-nek kell lennie.
Egy SWIFT-célponthoz meg kell adni a bank utcai címét a bankAddress, bankCity, bankState és bankPostalCode mezőkben. A BIC országának egyeznie kell a bank országával. A Swipelux a kedvezményezett címét az ügyfél- vagy címzettprofilból veszi át.
Pix-kifizetések
A Pix és Pix Safe címzetti célpontok BRL-t fogadnak. A kifizetési árajánlatot az ügyfél kész Pix-képességével (pix_pooled) kérje le, a fedezetet USDC-ben biztosítsa, és az out.currency értékét állítsa BRL-re. BRL-kifizetés fedezetére USDT nem használható.
Egy Pix-kifizetés nem tartalmazhat fejlesztői díjat. Ha a forrásszámlán fejlesztői díjak vannak beállítva, az árajánlat-kérésben állítsa a fees.breakdown.developer értékét {"fixed": "0.00", "bips": 0}-ra. Ellenkező esetben a POST /v3/quotes 400 validation_error hibát ad vissza.
A Swipelux csak azután árazza be az árajánlatot, hogy a célpont banki adatait jóváhagyták. Amíg az ellenőrzés tart, a POST /v3/quotes 400 validation_error hibát ad vissza egy olyan detail értékkel, amely szerint a célpont ellenőrzése még folyamatban van, ezért az ellenőrzés lezárulta után kérjen új árajánlatot. Ha a banki adatokat elutasították, vagy a célpont beállítása hiányos, a detail arra kéri, hogy forduljon az ügyfélszolgálathoz, és az új árajánlatok addig sikertelenek maradnak, amíg az ügyfélszolgálat be nem fejezi a beállítást. Ha az ellenőrzés állapota nem kérdezhető le, 503 quote_temporarily_unavailable hibát ad vissza; ilyenkor próbálja újra később.
3. A kifizetés végrehajtása
Hozza létre az átutalást aPOST /v3/transfers művelettel. Használjon egy új kulcsot ehhez a szándékolt végrehajtáshoz:
Request headers
Request body
data.id értékét TRANSFER_ID-ként. Egy sikeres létrehozás elindítja a kifizetést; nem bizonyítja a kézbesítést.
4. A kézbesítés követése
Olvassa be aGET /v3/transfers/{transferId} műveletet a létrehozás után és minden esemény után. A legfrissebb data.state, data.stateDetail és data.openTaskIds alapján döntse el, hogy vár, cselekszik, vagy végleges kimenetet jelenít meg.
Ezután nézze át az Árajánlatok és átutalások oldalt a pontos összegekért, a biztonságos végrehajtási helyreállításért és az átutalási feladatokért.