Sūtīt līdzekļus

Katra izmaksa sākas no gatava, finansēta izsniegta maka. Galamērķa modelis ir atkarīgs no tā, kam pieder galapunkts.

Pirms sākat

Atkārtoti ielādējiet avota maku. Apstipriniet, ka tā pašreizējais statuss atļauj izmaksu un tā pieejamais atlikums sedz paredzēto avota summu. Saglabājiet no atbildes iegūto ID kā SOURCE_WALLET_ID. Jums nepieciešama arī gatava izmaksas iespēja pašreizējam klientam un izvēlētajam galamērķim. Esošie Tron maki var nosūtīt USDT uz citu Tron maku ar stablecoin_transfers kotāciju. Ievadei un izvadei jāizmanto tas pats tīkls un tā pati stabilā monēta. Jaunus izsniegtus makus Tron tīklā izveidot nevar.

1. Sagatavojiet galamērķi

Paša konts
Trešā puse

Izmantojiet klientam piederošu ārēju bankas kontu, kad klients ir galapunkta īpašnieks. Izveidojiet to ar POST /v3/customers/{customerId}/accounts un šīm galvenēm:

Request headers

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

Request body

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

Nolasiet to ar GET /v3/customers/{customerId}/accounts/{accountId}. Turpiniet tikai tad, kad tā pašreizējais statuss atļauj izmaksu. Saglabājiet tā acc_ ID kā PAYOUT_DESTINATION_ID.

Izveidojiet personu vai uzņēmumu un tā bankas vai maka galapunktu sadaļā Saņēmēji un galamērķi. Turpiniet tikai tad, kad galamērķis ir gatavs.Saglabājiet atgriezto dst_ ID kā PAYOUT_DESTINATION_ID. Neizmantojiet saņēmēja rcp_ ID kā kotācijas galamērķi.

2. Izveidojiet izmaksas kotāciju

Izmantojiet POST /v3/quotes ar šīm galvenēm:

Request headers

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

Request body

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

Saglabājiet data.id kā QUOTE_ID un parādiet atgriezto cenu un maksas.

Izvēlieties bankas maršrutu

Kriptovalūtas uz fiat izmaksai varat iestatīt neobligāto institutionId, lai pieprasītu klientam apstiprinātu bankas maršrutu. Izlaidiet to, lai izmantotu automātisko maršrutēšanu.

Request body with institutionId

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

Tieši norādīts institutionId nekad neizmanto citu banku kā rezerves variantu. Ja atlasītajai bankai nav gatava maršruta šim klientam, iespējai un galamērķim, POST /v3/quotes atgriež 422 bank_not_supported_for_customer ar rādītāju /institutionId.
institutionId ir derīgs tikai kriptovalūtas uz fiat izmaksu kotācijām. Ja to nosūta iemaksas, kartes vai stabilo monētu pārveduma kotācijā, tiek atgriezts 400 validation_error.
Kotāciju un pārvedumu nolasījumi atgriež atlasītā maršruta institutionId, arī automātiski atlasītā, ja banku var identificēt.

SWIFT izmaksas

Produkcijas vidē USD SWIFT izmaksām nepieciešama gatava SWIFT iespēja, kas atbalsta izmaksas (swift_pooled vai swift_named), un tās tiek finansētas ar USDC tīklā Ethereum, Base vai Polygon vai ar USDT tīklā Ethereum vai Polygon. Saņēmēja summai pēc maksām jābūt vismaz 100.00 USD. SWIFT galamērķim nepieciešama bankas ielas adrese laukos bankAddress, bankCity, bankState un bankPostalCode. BIC valstij jāsakrīt ar bankas valsti. Swipelux ņem saņēmēja adresi no klienta vai saņēmēja profila.

Pix izmaksas

Pix un Pix Safe saņēmēju galamērķi saņem BRL. Izveidojiet izmaksas kotāciju ar klienta gatavo Pix iespēju (pix_pooled), finansējiet to ar USDC un iestatiet out.currency uz BRL. USDT nevar finansēt BRL izmaksu. Pix izmaksai nevar piemērot izstrādātāja komisiju. Ja avota kontam ir izstrādātāja komisijas, kotācijas pieprasījumā iestatiet fees.breakdown.developer uz {"fixed": "0.00", "bips": 0}. Pretējā gadījumā POST /v3/quotes atgriež 400 validation_error. Swipelux nosaka kotācijas cenu tikai pēc tam, kad galamērķa bankas rekvizīti ir apstiprināti. Kamēr tie tiek pārbaudīti, POST /v3/quotes atgriež 400 validation_error ar detail, kas norāda, ka galamērķis joprojām tiek pārbaudīts, tāpēc pieprasiet jaunu kotāciju, kad pārbaude ir pabeigta. Ja bankas rekvizīti tika noraidīti vai galamērķa iestatīšana nav pabeigta, detail tā vietā lūdz sazināties ar atbalstu, un jaunas kotācijas turpina neizdoties, līdz atbalsts pabeidz iestatīšanu. Ja pārbaudes statusu nevar noskaidrot, tiek atgriezts 503 quote_temporarily_unavailable; mēģiniet vēlreiz vēlāk.

3. Izpildiet izmaksu

Izveidojiet pārvedumu ar POST /v3/transfers. Izmantojiet vienu jaunu atslēgu šai paredzētajai izpildei:

Request headers

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

Request body

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

Saglabājiet pārveduma data.id kā TRANSFER_ID. Veiksmīga izveide uzsāk izmaksu; tā nepierāda piegādi.

4. Sekojiet piegādei

Pēc izveides un pēc katra notikuma nolasiet GET /v3/transfers/{transferId}. Izmantojiet jaunāko data.state, data.stateDetail un data.openTaskIds, lai izlemtu, vai gaidīt, rīkoties vai parādīt gala rezultātu. Tālāk pārskatiet Kotācijas un pārvedumi, lai iegūtu precīzas summas, drošu izpildes atgūšanu un pārveduma uzdevumus.

Sākt darbu

Klientu iekļaušana

Veidot naudas plūsmas

Palaišana

Sūtīt līdzekļus

Pirms sākat

1. Sagatavojiet galamērķi

2. Izveidojiet izmaksas kotāciju

Izvēlieties bankas maršrutu

SWIFT izmaksas

Pix izmaksas

3. Izpildiet izmaksu

4. Sekojiet piegādei

​Pirms sākat

​1. Sagatavojiet galamērķi

​2. Izveidojiet izmaksas kotāciju

​Izvēlieties bankas maršrutu

​SWIFT izmaksas

​Pix izmaksas

​3. Izpildiet izmaksu

​4. Sekojiet piegādei

Pirms sākat

1. Sagatavojiet galamērķi

2. Izveidojiet izmaksas kotāciju

Izvēlieties bankas maršrutu

SWIFT izmaksas

Pix izmaksas

3. Izpildiet izmaksu

4. Sekojiet piegādei