Címzettek és célpontok

Ügyfélszámlát akkor használjon, amikor az ügyfél tulajdonolja a végpontot. Címzettet és célpontot akkor használjon, amikor egy másik személy vagy vállalkozás fogadja a pénzt. A címzett rögzíti, hogy ki kapja a pénzt. A célpont rögzíti, hogy hol kapják.

1. Címzett létrehozása

Hozzon létre egy magánszemélyt vagy vállalkozást a POST /v3/customers/{customerId}/recipients művelettel. Küldje el ezeket a fejléceket:

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

Adja meg a címet, mielőtt fiat célpontot hoz létre. Tárolja a visszakapott címzett data.id értékét RECIPIENT_ID-ként, és őrizze meg az aktuális státuszát.

2. Célpont hozzáadása

Hozza létre a végpontot a POST /v3/customers/{customerId}/recipients/{recipientId}/destinations művelettel. Használjon új kulcsot ehhez a szándékolt célponthoz:

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

Bank célpont
Tárca célpont

{
  "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 értéket csak akkor használjon, ha a címzett irányítja a tárcát. Kövesse az aktuális API referencia változatát, ha a tárcát másik custodian tartja. Tárolja a visszakapott célpont data.id értékét DESTINATION_ID-ként, és őrizze meg az aktuális státuszát.

3. Várja meg a célpont készenlétét

Olvassa be a GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} műveletet árajánlat létrehozása előtt. Csak akkor folytassa, ha az aktuális célpont státusza engedi a kifizetést, és annak devizája, módszere és hálózata megfelel a szándékolt mozgásnak. A címzett és a célpont státusza független. Használja a dst_ célpont azonosítót a kifizetési árajánlatban. Az rcp_ címzett azonosító a tulajdonos rekordot jelöli, és nem árajánlat célpont. Ezután vigye a kész célpontot a Pénz küldése oldalra.

Kezdő lépések

Ügyfelek beléptetése

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

Élesítés

Címzettek és célpontok

1. Címzett létrehozása

2. Célpont hozzáadása

3. Várja meg a célpont készenlétét

​1. Címzett létrehozása

​2. Célpont hozzáadása

​3. Várja meg a célpont készenlétét

1. Címzett létrehozása

2. Célpont hozzáadása

3. Várja meg a célpont készenlétét