Příjemci a cíle

Účet zákazníka použijte, když zákazník vlastní koncový bod. Příjemce a cíl použijte, když prostředky přijímá jiná osoba nebo firma. Příjemce zaznamenává, kdo prostředky přijímá. Cíl zaznamenává, kde je přijímá.

1. Vytvořte příjemce

Vytvořte fyzickou osobu nebo firmu pomocí POST /v3/customers/{customerId}/recipients. Odešlete tyto hlavičky:

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

{
  "type": "individual",
  "relationship": "contractor",
  "firstName": "Jason",
  "lastName": "Swipelux",
  "email": "jason@swipelux.com",
  "phone": "+14155551234",
  "address": {
    "streetLine1": "1 Market Street",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94105",
    "country": "US"
  },
  "label": "Jason contractor"
}

Před vytvořením fiat cíle uveďte adresu. Uložte vrácené data.id příjemce jako RECIPIENT_ID a uchovejte jeho aktuální stav.

2. Přidejte cíl

Vytvořte koncový bod pomocí POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Pro tento zamýšlený cíl použijte nový klíč:

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

Bankovní cíl
Peněženkový cíl

{
  "type": "ach",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Jason Swipelux",
    "country": "US"
  }
}

{
  "type": "wallet",
  "currency": "USDC",
  "ownership": {
    "type": "self_custodied"
  },
  "details": {
    "network": "base",
    "address": "0x1111111111111111111111111111111111111111"
  }
}

self_custodied používejte pouze tehdy, když příjemce peněženku ovládá. Když peněženku drží jiný kustodián, postupujte podle aktuální varianty v API Reference. Uložte vrácené data.id cíle jako DESTINATION_ID a uchovejte jeho aktuální stav.

3. Počkejte na připravenost cíle

Přečtěte GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} předtím, než vytvoříte quote. Pokračujte jen tehdy, když aktuální stav cíle umožňuje výplatu a jeho měna, metoda a síť odpovídají zamýšlenému přesunu. Stavy příjemce a cíle jsou nezávislé. Ve výplatním quote použijte ID cíle dst_. ID příjemce rcp_ identifikuje záznam vlastníka a není cílem quote. Dále vezměte připravený cíl do Odesílat prostředky.

Začínáme

Onboarding zákazníků

Vytvořte peněžní toky

Spuštění

Příjemci a cíle

1. Vytvořte příjemce

2. Přidejte cíl

3. Počkejte na připravenost cíle

​1. Vytvořte příjemce

​2. Přidejte cíl

​3. Počkejte na připravenost cíle

1. Vytvořte příjemce

2. Přidejte cíl

3. Počkejte na připravenost cíle