Számlák és tárcák

Minden számla egy ügyfélhez tartozik. Két dimenzió alapján válassza: ki kezeli, és tárca vagy bankszámla.

Számla választása

Számla	Használat
Kibocsátott tárca	Custodial stablecoin egyenleg tartása, kifizetés finanszírozása, pénzbefizetés fogadása vagy kibocsátott bankszámla rendezése.
Kibocsátott bankszámla	Az ügyfélnek újrafelhasználható banki adatokat ad, amelyek egy kibocsátott tárcába rendeződnek.
Külső tárca	Az ügyfél tulajdonában lévő blockchain cím rögzítése.
Külső bankszámla	Az ügyfél tulajdonában lévő bankszámla rögzítése saját tulajdonú kifizetéshez.

Az issued jelentése, hogy a Swipelux hozza létre és kezeli az erőforrást. Az external egy ügyfél tulajdonában lévő végpontot rögzít. Egy harmadik fél végpontja a címzett és célpont alá tartozik, nem az ügyfél számlalistájába.

A számla létrehozása

Használja a POST /v3/customers/{customerId}/accounts műveletet. Küldje el ezeket a fejléceket az alábbi kérés-törzsek egyikével:

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

Kibocsátott tárca
Kibocsátott bankszámla
Külső tárca
Külső bankszámla

{
  "origin": "issued",
  "type": "wallet",
  "currency": "USDC",
  "network": "base",
  "label": "Settlement wallet"
}

{
  "origin": "issued",
  "type": "bank",
  "method": "ach",
  "country": "US",
  "currency": "USD",
  "settlement": {
    "accountId": "${SETTLEMENT_WALLET_ID}"
  },
  "label": "USD account"
}

{
  "origin": "external",
  "type": "wallet",
  "currency": "USDC",
  "network": "polygon",
  "details": {
    "address": "0x4997b0a68bebc1b0d80a93567ba7002be92b8b11"
  },
  "label": "Customer Polygon wallet"
}

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

Csak olyan devizákat, hálózatokat, módszereket és számlatípusokat használjon, amelyeket az aktuális ügyfélhez és képességhez visszaadtak. Ne másoljon elérhetőséget másik ügyféltől vagy környezetből.

Várjon, amíg a számla használható lesz

Tárolja a data.id, data.status és data.openTaskIds értékeket a létrehozási válaszból. Olvassa be a legfrissebb számlát a GET /v3/customers/{customerId}/accounts/{accountId} művelettel, mielőtt átutalást áraz vagy banki adatokat jelenít meg. Csak akkor használja a számlát, ha az aktuális státusza engedi a következő műveletet. Ha vannak nyitott feladatazonosítók, végezze el őket a Képességek és feladatok alapján. Egy kibocsátott bankszámla details: null értéket adhat vissza a provisioning alatt. Csak akkor jelenítse meg a banki adatokat, ha egy aktuális olvasás visszaadja a teljes készletet. Ha a details.referenceRequired értéke true, mutassa a pontos details.reference értéket a banki koordinátákkal együtt.

Tartsa a számlaszerepeket explicitnek

Kifizetéshez a kibocsátott tárca a forrás az in.accountId-ban. Egy ügyfél tulajdonában lévő bankszámla a destinationId. Kibocsátott bankszámlához a settlement.accountId az a kibocsátott tárca, amely a párosított betéteket fogadja. Ezután használjon egy kész számlát a Pénz fogadása, Pénz küldése vagy Bankszámla kibocsátása folyamatban.

Kezdő lépések

Ügyfelek beléptetése

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

Élesítés

Számlák és tárcák

Számla választása

A számla létrehozása

Várjon, amíg a számla használható lesz

Tartsa a számlaszerepeket explicitnek

​Számla választása

​A számla létrehozása

​Várjon, amíg a számla használható lesz

​Tartsa a számlaszerepeket explicitnek

Számla választása

A számla létrehozása

Várjon, amíg a számla használható lesz

Tartsa a számlaszerepeket explicitnek