Mottakere og destinasjoner

Bruk en kundekonto når kunden eier endepunktet. Bruk en mottaker og destinasjon når en annen person eller virksomhet mottar midlene. Mottakeren registrerer hvem som mottar midlene. Destinasjonen registrerer hvor de mottar dem.

1. Opprett mottakeren

Opprett en individ eller virksomhet med POST /v3/customers/{customerId}/recipients. Send disse headerne:

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

Inkluder adressen før du oppretter en fiat-destinasjon. Lagre den returnerte mottaker-data.id som RECIPIENT_ID og behold gjeldende status.

2. Legg til en destinasjon

Opprett endepunktet med POST /v3/customers/{customerId}/recipients/{recipientId}/destinations. Bruk en ny nøkkel for denne tiltenkte destinasjonen:

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

Bankdestinasjon
Lommebok-destinasjon

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

Bruk self_custodied kun når mottakeren kontrollerer lommeboken. Følg gjeldende variant i API-referansen når lommeboken holdes av en annen depotforvalter. Lagre den returnerte destinasjons-data.id som DESTINATION_ID og behold gjeldende status.

3. Vent på destinasjonsklarhet

Les GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} før du oppretter et tilbud. Fortsett kun når gjeldende destinasjonsstatus tillater payout-en, og valutaen, metoden og nettverket samsvarer med den tiltenkte bevegelsen. Statusen til mottaker og destinasjon er uavhengige. Bruk dst_-destinasjons-ID-en i payout-tilbudet. rcp_-mottaker-ID-en identifiserer eieroppføringen og er ikke en tilbudsdestinasjon. Deretter, ta den klare destinasjonen til Send midler.

Kom i gang

Kundeombording

Bygg pengestrømmer

Lansering

Mottakere og destinasjoner

1. Opprett mottakeren

2. Legg til en destinasjon

3. Vent på destinasjonsklarhet

​1. Opprett mottakeren

​2. Legg til en destinasjon

​3. Vent på destinasjonsklarhet

1. Opprett mottakeren

2. Legg til en destinasjon

3. Vent på destinasjonsklarhet