Destinataris i destinacions

Utilitza un compte de client quan el client sigui propietari del punt final. Utilitza un destinatari i una destinació quan una altra persona o negoci rebi els fons. El destinatari registra qui rep els fons. La destinació registra on els rep.

1. Crea el destinatari

Crea un individu o negoci amb POST /v3/customers/{customerId}/recipients. Envia aquestes capçaleres:

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

Inclou l’adreça abans de crear una destinació fiat. Emmagatzema el data.id del destinatari retornat com a RECIPIENT_ID i conserva el seu estat actual.

2. Afegeix una destinació

Crea el punt final amb POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Utilitza una nova clau per a aquesta destinació prevista:

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

Destinació bancària
Destinació de cartera

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

Utilitza self_custodied només quan el destinatari controli la cartera. Segueix la variant actual de la referència de l’API quan la cartera estigui en mans d’un altre custodi. Emmagatzema el data.id de la destinació retornada com a DESTINATION_ID i conserva el seu estat actual.

3. Espera la preparació de la destinació

Llegeix GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} abans de crear una cotització. Continua només quan l’estat actual de la destinació permeti el pagament i la seva moneda, mètode i xarxa coincideixin amb el moviment previst. Els estats del destinatari i de la destinació són independents. Utilitza l’ID de destinació dst_ a la cotització del pagament. L’ID de destinatari rcp_ identifica el registre del propietari i no és una destinació de cotització. A continuació, porta la destinació preparada a Enviar fons.

Comença aquí

Incorpora clients

Construeix fluxos de diners

Llança

Destinataris i destinacions

1. Crea el destinatari

2. Afegeix una destinació

3. Espera la preparació de la destinació

​1. Crea el destinatari

​2. Afegeix una destinació

​3. Espera la preparació de la destinació

1. Crea el destinatari

2. Afegeix una destinació

3. Espera la preparació de la destinació