Vastaanottajat ja kohteet

Käytä asiakastiliä, kun asiakas omistaa päätepisteen. Käytä vastaanottajaa ja kohdetta, kun toinen henkilö tai yritys vastaanottaa varat. Vastaanottaja kirjaa, kuka vastaanottaa varat. Kohde kirjaa, missä he saavat ne.

1. Luo vastaanottaja

Luo yksityishenkilö tai yritys POST /v3/customers/{customerId}/recipients -toiminnolla. Lähetä nämä otsakkeet:

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

Sisällytä osoite ennen fiat-kohteen luomista. Tallenna palautettu vastaanottajan data.id muuttujaan RECIPIENT_ID ja säilytä sen nykyinen tila.

2. Lisää kohde

Luo päätepiste POST /v3/customers/{customerId}/recipients/{recipientId}/destinations -toiminnolla. Käytä uutta avainta tälle aiotulle kohteelle:

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

Pankkikohde
Lompakkokohde

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

Käytä self_custodied-arvoa vain, kun vastaanottaja hallitsee lompakkoa. Seuraa nykyistä API-referenssin muunnelmaa, kun lompakko on toisen säilyttäjän hallussa. Tallenna palautettu kohteen data.id muuttujaan DESTINATION_ID ja säilytä sen nykyinen tila.

3. Odota kohteen valmiutta

Lue GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} ennen tarjouksen luomista. Jatka vain, kun kohteen nykyinen tila sallii maksun ja sen valuutta, menetelmä ja verkko vastaavat aiottua liikkumista. Vastaanottajan ja kohteen tilat ovat itsenäisiä. Käytä dst_-kohteen ID:tä maksun tarjouksessa. rcp_-vastaanottajan ID tunnistaa omistajatietueen, eikä se ole tarjouskohde. Seuraavaksi vie valmis kohde kohtaan Lähetä varoja.

Aloita

Asiakkaiden käyttöönotto

Rakenna rahavirrat

Julkaisu

Vastaanottajat ja kohteet

1. Luo vastaanottaja

2. Lisää kohde

3. Odota kohteen valmiutta

​1. Luo vastaanottaja

​2. Lisää kohde

​3. Odota kohteen valmiutta

1. Luo vastaanottaja

2. Lisää kohde

3. Odota kohteen valmiutta