Pénz fogadása

Á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:

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

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "externalId": "payin-order-123",
  "in": {
    "amount": "150.00",
    "currency": "USD"
  },
  "destinationId": "${SETTLEMENT_WALLET_ID}",
  "out": {
    "currency": "USDC"
  }
}

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:

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

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

Tárolja az átutalás data.id értékét TRANSFER_ID-ként, és őrizze meg az aktuális állapotát.

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.

Kezdő lépések

Ügyfelek beléptetése

Pénzáramlások kiépítése

Élesítés

Mielőtt kezdi

1. Árajánlat létrehozása

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

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

4. Rendezés követése

​Mielőtt kezdi

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

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

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

​4. Rendezés követése

Mielőtt kezdi

1. Árajánlat létrehozása

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

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

4. Rendezés követése