Účty a peněženky

Každý účet patří jednomu zákazníkovi. Vyberte jej podle dvou dimenzí: kdo jej spravuje a zda jde o peněženku nebo bankovní účet. Operace výpisu, vytvoření, čtení, aktualizace a archivace zákaznických účtů jsou pod /v3/customers/{customerId}/accounts; operace s jedním účtem přidávají /{accountId}. Zpětné vyhledání customerId podle accountId neexistuje. Uložte customerId s každým accountId, aby pozdější požadavky mohly účet adresovat.

Vyberte účet

Účet	Použití
Vydaná peněženka	Držení kustodiálního zůstatku ve stablecoinu, financování výplaty, přijetí příchozí platby nebo vypořádání vydaného bankovního účtu.
Vydaný bankovní účet	Poskytnutí opakovaně použitelných bankovních údajů zákazníkovi, které se vypořádají do vydané peněženky.
Externí peněženka	Záznam blockchainové adresy vlastněné zákazníkem.
Externí bankovní účet	Záznam bankovního účtu vlastněného zákazníkem pro výplatu první straně.

issued znamená, že Swipelux zdroj vytváří a spravuje. external zaznamenává koncový bod vlastněný zákazníkem. Koncový bod třetí strany patří pod příjemce a cíl, nikoli do seznamu účtů zákazníka. Než spustíte průvodce First pay-in v panelu obchodníka pro karty nebo Apple Pay, vytvořte pro daného zákazníka peněženku Polygon. Průvodce nabízí pouze tuto peněženku Polygon a bez ní nemůže pokračovat. Tato podmínka platí pro průvodce v panelu obchodníka; přímé integrace API musí používat pouze měny, sítě, metody a typy účtů vrácené pro aktuálního zákazníka a schopnost.

Vytvořte účet

Použijte POST /v3/customers/{customerId}/accounts. Odešlete tyto hlavičky s jedním z těl požadavku níže:

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

Vydaná peněženka
Vydaný bankovní účet
Externí peněženka
Externí bankovní účet

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

Používejte jen měny, sítě, metody a typy účtů vrácené pro aktuálního zákazníka a capability. Nekopírujte dostupnost od jiného zákazníka ani z jiného prostředí.

Počkejte, až bude účet použitelný

Uložte data.id, data.status a data.openTaskIds z odpovědi na vytvoření. Přečtěte nejnovější účet pomocí GET /v3/customers/{customerId}/accounts/{accountId} předtím, než zaquotujete převod nebo zobrazíte bankovní údaje. Použijte účet pouze tehdy, když jeho aktuální stav umožňuje další operaci. Pokud jsou ID úkolů otevřená, dokončete je přes Capabilities a úkoly. Vydaný bankovní účet může vrátit details: null během provisioningu. Prezentujte bankovní údaje až po aktuálním čtení, které vrátí kompletní sadu. Pokud details.referenceRequired je true, zobrazte přesnou details.reference spolu s bankovními souřadnicemi.

Udržujte role účtů explicitní

Pro výplatu je vydaná peněženka zdrojem v in.accountId. Bankovní účet vlastněný zákazníkem je destinationId. Pro vydaný bankovní účet je settlement.accountId vydaná peněženka, která přijímá spárované vklady. Dále použijte připravený účet v Přijímat prostředky, Odesílat prostředky nebo Vydat bankovní účet.

Začínáme

Onboarding zákazníků

Vytvořte peněžní toky

Spuštění

Účty a peněženky

Vyberte účet

Vytvořte účet

Počkejte, až bude účet použitelný

Udržujte role účtů explicitní

​Vyberte účet

​Vytvořte účet

​Počkejte, až bude účet použitelný

​Udržujte role účtů explicitní

Vyberte účet

Vytvořte účet

Počkejte, až bude účet použitelný

Udržujte role účtů explicitní