Konti un maki

Katrs konts pieder vienam klientam. Izvēlieties to, izmantojot divas dimensijas: kas to pārvalda un vai tas ir maks vai bankas konts. Klienta kontu saraksta, izveides, lasīšanas, atjaunināšanas un arhivēšanas darbības atrodas zem /v3/customers/{customerId}/accounts; viena konta darbības pievieno /{accountId}. Nav apgrieztās meklēšanas no accountId uz customerId. Saglabājiet customerId kopā ar katru accountId, lai vēlākie pieprasījumi varētu adresēt kontu.

Izvēlieties kontu

Konts	Izmantojiet
Izsniegts maks	Turēt kastodiālu stabilas monētas bilanci, finansēt izmaksu, saņemt iemaksu vai norēķināt izsniegtu bankas kontu.
Izsniegts bankas konts	Sniedziet klientam atkārtoti izmantojamus bankas rekvizītus, kas norēķinās izsniegtā makā.
Ārējs maks	Reģistrējiet klientam piederošu blokķēdes adresi.
Ārējs bankas konts	Reģistrējiet klientam piederošu bankas kontu paša izmaksai.

issued nozīmē, ka Swipelux izveido un pārvalda resursu. external reģistrē galapunktu, kas pieder klientam. Trešās puses galapunkts pieder saņēmējam un galamērķim, nevis klienta kontu sarakstam. Pirms sākat tirgotāja paneļa karšu vai Apple Pay First pay-in vedni, izveidojiet šim klientam Polygon maku. Vednis piedāvā tikai šo Polygon maku un bez tā nevar turpināt. Šis priekšnosacījums attiecas uz tirgotāja paneļa vedni; tiešajām API integrācijām jāizmanto tikai pašreizējam klientam un iespējai atgrieztās valūtas, tīkli, metodes un kontu tipi.

Izveidojiet kontu

Izmantojiet POST /v3/customers/{customerId}/accounts. Nosūtiet šīs galvenes ar vienu no zemāk esošajiem pieprasījuma pamattekstiem:

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

Izsniegts maks
Izsniegts bankas konts
Ārējs maks
Ārējs bankas konts

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

Izmantojiet tikai tās valūtas, tīklus, metodes un kontu tipus, kas atgriezti pašreizējam klientam un iespējai. Nekopējiet pieejamību no cita klienta vai vides.

Gaidiet, līdz konts ir izmantojams

Saglabājiet data.id, data.status un data.openTaskIds no izveidošanas atbildes. Pirms kotēt pārvedumu vai parādīt bankas rekvizītus, nolasiet jaunāko kontu ar GET /v3/customers/{customerId}/accounts/{accountId}. Izmantojiet kontu tikai tad, kad tā pašreizējais statuss atļauj nākamo operāciju. Ja uzdevumu ID ir atvērti, pabeidziet tos sadaļā Iespējas un uzdevumi. Izsniegts bankas konts nodrošinājuma laikā var atgriezt details: null. Rādiet bankas rekvizītus tikai pēc tam, kad pašreizējā lasīšana atgriež pilnu kopu. Ja details.referenceRequired ir true, parādiet precīzu details.reference kopā ar bankas koordinātām.

Uzturiet skaidras kontu lomas

Izmaksai izsniegtais maks ir avots in.accountId. Klientam piederošs bankas konts ir destinationId. Izsniegtam bankas kontam settlement.accountId ir izsniegtais maks, kas saņem atbilstošas iemaksas. Tālāk izmantojiet gatavu kontu sadaļā Saņemt līdzekļus, Sūtīt līdzekļus vai Izsniegt bankas kontu.

Sākt darbu

Klientu iekļaušana

Veidot naudas plūsmas

Palaišana

Izvēlieties kontu

Izveidojiet kontu

Gaidiet, līdz konts ir izmantojams

Uzturiet skaidras kontu lomas

​Izvēlieties kontu

​Izveidojiet kontu

​Gaidiet, līdz konts ir izmantojams

​Uzturiet skaidras kontu lomas

Izvēlieties kontu

Izveidojiet kontu

Gaidiet, līdz konts ir izmantojams

Uzturiet skaidras kontu lomas