Send midler

Hver payout starter fra en klar, finansiert utstedt lommebok. Destinasjonsmodellen avhenger av hvem som eier endepunktet.

Før du starter

Hent kildelommeboken på nytt. Bekreft at gjeldende status tillater payout-en og at tilgjengelig saldo dekker det tiltenkte kildebeløpet. Lagre dens responsavledede ID som SOURCE_WALLET_ID. Du trenger også en klar payout-capability for gjeldende kunde og valgt destinasjon.

1. Klargjør destinasjonen

Førsteparts
Tredjeparts

Bruk en kundeeid ekstern bankkonto når kunden eier endepunktet. Opprett den med POST /v3/customers/{customerId}/accounts og disse headerne:

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

{
  "origin": "external",
  "type": "bank",
  "methods": ["ach", "wire"],
  "country": "US",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Acme Payments SAS"
  },
  "label": "Customer operating account"
}

Les den med GET /v3/customers/{customerId}/accounts/{accountId}. Fortsett kun når gjeldende status tillater payout-en. Lagre acc_-ID-en som PAYOUT_DESTINATION_ID.

Opprett personen eller virksomheten og deres bank- eller lommebok-endepunkt via Mottakere og destinasjoner. Fortsett kun når destinasjonen er klar.Lagre den returnerte dst_-ID-en som PAYOUT_DESTINATION_ID. Ikke bruk mottakerens rcp_-ID som tilbudsdestinasjon.

2. Opprett payout-tilbudet

Bruk POST /v3/quotes med disse headerne:

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

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "in": {
    "amount": "150.00",
    "currency": "USDC",
    "accountId": "${SOURCE_WALLET_ID}"
  },
  "destinationId": "${PAYOUT_DESTINATION_ID}",
  "out": {
    "currency": "USD"
  }
}

Lagre data.id som QUOTE_ID og presenter den returnerte prisen og gebyrene.

3. Utfør payout-en

Opprett overføringen med POST /v3/transfers. Bruk én ny nøkkel for denne tiltenkte utførelsen:

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

{
  "quoteId": "${QUOTE_ID}"
}

Lagre overføringens data.id som TRANSFER_ID. En vellykket opprettelse starter payout-en; den beviser ikke levering.

4. Følg opp levering

Les GET /v3/transfers/{transferId} etter opprettelse og etter hver hendelse. Bruk siste data.state, data.stateDetail og data.openTaskIds for å avgjøre om du skal vente, handle eller vise et terminalt utfall. Deretter, gå gjennom Tilbud og overføringer for nøyaktige beløp, trygg utførelsesgjenoppretting og overføringsoppgaver.

Kom i gang

Kundeombording

Bygg pengestrømmer

Lansering

Før du starter

1. Klargjør destinasjonen

2. Opprett payout-tilbudet

3. Utfør payout-en

4. Følg opp levering

​Før du starter

​1. Klargjør destinasjonen

​2. Opprett payout-tilbudet

​3. Utfør payout-en

​4. Følg opp levering

Før du starter

1. Klargjør destinasjonen

2. Opprett payout-tilbudet

3. Utfør payout-en

4. Følg opp levering