Ugrás a fő tartalomhoz
Árazott pénzbefizetést akkor használjon, amikor az ügyfélnek adott összeget kell befizetnie. Az átutalás stablecoint rendez egy kibocsátott tárcába.

​
Mielőtt kezdi

Szüksége van egy kész pénzbefizetési képességre és egy ugyanahhoz az ügyfélhez tartozó kész kibocsátott céltárcára. A nyitott munkát végezze el a Képességek és feladatok alapján, majd olvassa be újra mindkét erőforrást. A pooled SWIFT nem támogatja a pénzbefizetéseket. SWIFT-befizetések fogadásához bocsásson ki egy névre szóló SWIFT-számlát. Lásd: Bankszámla kibocsátása.

​
1. Árajánlat létrehozása

Hozza létre az árat a POST /v3/quotes művelettel. Küldje el ezeket a fejléceket:
Request headers
Request body
Tárolja a data.id értéket QUOTE_ID-ként. Jelenítse meg a visszaadott összegeket és díjakat, ne építse újra őket az árfolyamból.

​
Minimális összegek

A banki pénzbefizetési árajánlatok minimális összeget írhatnak elő, például 20.00 USD-t pooled Wire esetén. A POST /v3/quotes 422 amount_not_deliverable hibát ad vissza, ha az összeg a minimum alatt van, vagy túl kicsi az átutalási díjak fedezéséhez.

​
2. Az árajánlat végrehajtása

Hajtsa végre az aktuális árajánlatot a lejárat előtt a POST /v3/transfers művelettel. Használjon új kulcsot ehhez a szándékolt átutaláshoz:
Request headers
Request body
Tárolja az átutalás data.id értékét TRANSFER_ID-ként, és őrizze meg az aktuális állapotát.

​
Adjon hozzá visszatérési URL-t kártyához és Apple Payhez

Kártyás vagy Apple Pay árajánlathoz ugyanabban a kérésben megadhat egy opcionális redirectUrl értéket. Miután az ügyfél befejezte a hosted checkoutot, a checkout oldal megnyitja ezt az URL-t, és visszavezeti az ügyfelet az alkalmazásába.
Request body with redirectUrl
A redirectUrl értéknek abszolút HTTPS URL-nek kell lennie, legfeljebb 2048 karakter hosszú lehet, és nem tartalmazhat beágyazott hitelesítő adatokat. Ha olyan árajánlathoz küld redirectUrl értéket, amely nem támogatja a visszatérési navigációt, a kérés validációs hibával meghiúsul, ahelyett hogy figyelmen kívül maradna. A redirectUrl címre érkezés csupán böngészőnavigáció. Nem erősíti meg, hogy a fizetés vagy az átutalás befejeződött. A befejezést a 4. lépésben szereplő átutalási állapotból és a webhook eseményekből állapítsa meg.

​
A checkout-módszer előválasztása kártyás árajánlathoz

Kártyás árajánlathoz ugyanabban a kérésben megadhat egy opcionális checkoutMethod értéket, amellyel kiválasztja, melyik fizetési lehetőséggel nyíljon meg a hosted checkout. A jelenlegi értékek: card, apple_pay, google_pay, cash_app, sepa és blik. A lista nyitott és bővülhet, ezért az átutalás olvasásakor tűrje el az ismeretlen értékeket. A checkout a kért módszerrel nyílik meg, ha az elérhető az ügyfél és az eszköze számára, és az ügyfél továbbra is választhat bármely más módszert, amelyet a checkout kínál. Hagyja el a mezőt az alapértelmezett előválasztás megtartásához.
Request body with checkoutMethod
A checkoutMethod preferencia, nem garancia. Az elérhetőség az ügyféltől, az eszközétől és a checkouttól függ, így egy módszer kérése nem teszi azt elérhetővé. Itt a sepa és a blik a kártyás checkouton belüli fizetési lehetőségek, nem Swipelux-képességek, -sínek vagy -számlák. Az előválasztás nem változtatja meg az árajánlat képességét, összegeit vagy díjait, a végleges díjakat pedig a checkout erősíti meg. Az átutalás olvasása a kért értéket adja vissza; nem erősíti meg, hogy az ügyfél melyik módszert használta. Ha nem kártyás árajánlathoz küld checkoutMethod értéket, a kérés validációs hibával meghiúsul, ahelyett hogy figyelmen kívül maradna, és az ugyanazzal az idempotenciakulccsal megismételt kérésnek ugyanazt a checkoutMethod értéket kell küldenie.

​
3. Befizetési utasítások lekérése

Olvassa be a GET /v3/transfers/{transferId}/instructions műveletet. Jelenítse meg a visszaadott data.instructions változatot annak típusának feltételezése nélkül. Ezek az adatok az átutalásra specifikusak. Soha ne használja fel újra egyik átutalás banki koordinátáit, kódját, hosted URL-jét, összegét, hivatkozását vagy lejárati idejét másik pénzbefizetéshez. Banki utasításokhoz, ha a reference.required értéke true, jelenítse meg a pontos reference.value értéket a banki koordináták mellett és tegye másolhatóvá. Mutassa a visszaadott összeget és devizát ugyanabból az utasításkészletből. A banki utasítások opcionális bankName, bankAddress, accountHolderName és accountHolderAddress mezőket is tartalmazhatnak. Minden visszaadott mezőt jelenítsen meg a többi banki koordináta mellett. A küldő bankok gyakran megkövetelik a fogadó bank címét a swift és más nemzetközi átutalásoknál, ezért mindig jelenítse meg a bankAddress mezőt, ha visszaadásra kerül.
Bank instructions
Egy kibocsátott bankszámla más: újrafelhasználható részleteket biztosít későbbi betétekhez. Lásd a Bankszámla kibocsátása útmutatót, ha ez a szándékolt élmény.

​
4. Rendezés követése

Olvassa be a GET /v3/transfers/{transferId} műveletet a végrehajtás után és minden esemény után. Az ügyfél-oldali státuszt a legfrissebb data.state alapján vezérelje. Használja a data.stateDetail és data.openTaskIds mezőket, amikor az átutalás további műveletet igényel. Ne jelölje befejezettnek várható ütemterv alapján. Ezután adjon hozzá Webhookokat és tartsa szinkronban az átutalás státuszát, amíg el nem éri egy olyan kimenetet, amelyet a termék kezel.