Skip to main content
Á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.

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

Hozza létre az árat a POST /v3/quotes művelettel. Küldje el ezeket a fejléceket:
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.

​
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:
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.
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.
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. 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.