Tilit ja lompakot

Jokainen tili kuuluu yhdelle asiakkaalle. Valitse se kahden ulottuvuuden avulla: kuka hallinnoi sitä ja onko se lompakko vai pankkitili. Asiakastilien listaus-, luonti-, luku-, päivitys- ja arkistointitoiminnot ovat polun /v3/customers/{customerId}/accounts alla; yksittäisen tilin toiminnot lisäävät /{accountId}. accountId-arvosta ei voi hakea customerId-arvoa. Tallenna customerId jokaisen accountId-arvon rinnalle myöhempiä pyyntöjä varten.

Valitse tili

Tili	Käytä sitä
Luotu lompakko	Pidä säilytettävää vakaakolikkosaldoa, rahoita maksu ulos, vastaanota maksu tai selvitä luotu pankkitili.
Luotu pankkitili	Anna asiakkaalle uudelleenkäytettävät pankkitilitiedot, jotka selviävät luotuun lompakkoon.
Ulkoinen lompakko	Kirjaa asiakkaan omistama lohkoketjuosoite.
Ulkoinen pankkitili	Kirjaa asiakkaan omistama pankkitili ensimmäisen osapuolen maksua ulos varten.

issued tarkoittaa, että Swipelux luo ja hallinnoi resurssia. external kirjaa asiakkaan omistaman päätepisteen. Kolmannen osapuolen päätepiste kuuluu vastaanottajan ja kohteen alle, ei asiakkaan tililuetteloon. Luo asiakkaalle Polygon-lompakko ennen kuin aloitat kauppiaspaneelin korttien tai Apple Payn First pay-in -ohjatun toiminnon. Toiminto tarjoaa vain kyseisen Polygon-lompakon eikä voi jatkua ilman sitä. Tämä edellytys koskee kauppiaspaneelin ohjattua toimintoa; suorien API-integraatioiden on käytettävä vain nykyiselle asiakkaalle ja ominaisuudelle palautettuja valuuttoja, verkkoja, menetelmiä ja tilityyppejä.

Luo tili

Käytä POST /v3/customers/{customerId}/accounts -toimintoa. Lähetä nämä otsakkeet yhden alla olevista pyyntörungoista kanssa:

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

Luotu lompakko
Luotu pankkitili
Ulkoinen lompakko
Ulkoinen pankkitili

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

Käytä vain valuuttoja, verkkoja, menetelmiä ja tilityyppejä, jotka palautetaan nykyiselle asiakkaalle ja kyvylle. Älä kopioi saatavuutta toiselta asiakkaalta tai ympäristöstä.

Odota, että tili on käyttökelpoinen

Tallenna data.id, data.status ja data.openTaskIds luontivastauksesta. Lue uusin tili GET /v3/customers/{customerId}/accounts/{accountId} -toiminnolla ennen kuin luot tarjouksen siirrolle tai näytät pankkitilitietoja. Käytä tiliä vain, kun sen nykyinen tila sallii seuraavan toiminnon. Jos tehtävän ID:t ovat avoinna, suorita ne Kyvyt ja tehtävät -kautta. Luotu pankkitili voi palauttaa details: null valmistelun aikana. Näytä pankkitilitiedot vain sen jälkeen, kun nykyinen luku palauttaa täydellisen joukon. Jos details.referenceRequired on true, näytä tarkka details.reference pankkikoordinaattien kanssa.

Pidä tilien roolit selkeinä

Maksua ulos varten luotu lompakko on lähde in.accountId-kentässä. Asiakkaan omistama pankkitili on destinationId. Luodussa pankkitilissä settlement.accountId on luotu lompakko, joka vastaanottaa yhteensopivat talletukset. Seuraavaksi käytä valmista tiliä Vastaanota varoja, Lähetä varoja tai Luo pankkitili -virrassa.

Aloita

Asiakkaiden käyttöönotto

Rakenna rahavirrat

Julkaisu

Tilit ja lompakot

Valitse tili

Luo tili

Odota, että tili on käyttökelpoinen

Pidä tilien roolit selkeinä

​Valitse tili

​Luo tili

​Odota, että tili on käyttökelpoinen

​Pidä tilien roolit selkeinä

Valitse tili

Luo tili

Odota, että tili on käyttökelpoinen

Pidä tilien roolit selkeinä