Saņemt līdzekļus

Izmantojiet kotētu iemaksu, kad klientam jāfinansē konkrēta summa. Pārvedums norēķinās stabilo monētu izsniegtā makā.

Pirms sākat

Jums nepieciešama gatava iemaksas iespēja un gatavs izsniegts galamērķa maks tam pašam klientam. Pabeidziet atvērtos darbus sadaļā Iespējas un uzdevumi, pēc tam atkārtoti ielādējiet abus resursus.

1. Izveidojiet kotāciju

Izveidojiet cenu ar POST /v3/quotes. Nosūtiet šīs galvenes:

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

{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "externalId": "payin-order-123",
  "in": {
    "amount": "150.00",
    "currency": "USD"
  },
  "destinationId": "${SETTLEMENT_WALLET_ID}",
  "out": {
    "currency": "USDC"
  }
}

Saglabājiet data.id kā QUOTE_ID. Parādiet atgrieztās summas un maksas, nevis pārveidojiet tās no likmes.

2. Izpildiet kotāciju

Izpildiet pašreizējo kotāciju pirms termiņa beigām ar POST /v3/transfers. Izmantojiet jaunu atslēgu šim paredzētajam pārvedumam:

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

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

Saglabājiet pārveduma data.id kā TRANSFER_ID un saglabājiet tā pašreizējo stāvokli.

Pievienojiet atgriešanās URL kartei un Apple Pay

Kartes vai Apple Pay kotācijai tajā pašā pieprasījumā varat iekļaut neobligātu redirectUrl. Kad klients pabeidz mitināto norēķināšanos, norēķināšanās lapa atver šo URL, lai atgrieztu klientu jūsu lietotnē.

{
  "quoteId": "${QUOTE_ID}",
  "redirectUrl": "https://your-app.example/payments/complete"
}

redirectUrl jābūt absolūtam HTTPS URL, kas nepārsniedz 2048 rakstzīmes, un tas nedrīkst saturēt iegultus akreditācijas datus. Ja redirectUrl tiek nosūtīts kotācijai, kas neatbalsta atgriešanās navigāciju, pieprasījums neiztur validāciju, nevis tiek ignorēts. Nonākšana redirectUrl ir tikai pārlūka navigācija. Tā neapstiprina, ka maksājums vai pārvedums ir pabeigts. Nosakiet pabeigšanu no pārveduma stāvokļa 4. solī un no webhook notikumiem.

Iepriekš atlasiet norēķināšanās metodi kartes kotācijai

Kartes kotācijai tajā pašā pieprasījumā varat iekļaut neobligātu checkoutMethod, lai izvēlētos, ar kuru finansēšanas iespēju atveras mitinātā norēķināšanās. Pašreizējās vērtības ir card, apple_pay, google_pay, cash_app, sepa un blik. Saraksts ir atvērts un var paplašināties, tāpēc pārveduma nolasījumos pieļaujiet vērtības, kuras neatpazīstat. Norēķināšanās atveras ar pieprasīto metodi, ja tā ir pieejama klientam un viņa ierīcei, un klients joprojām var izvēlēties jebkuru citu metodi, ko piedāvā norēķināšanās. Izlaidiet lauku, lai saglabātu noklusējuma iepriekšējo atlasi.

{
  "quoteId": "${QUOTE_ID}",
  "checkoutMethod": "apple_pay"
}

checkoutMethod ir preference, nevis garantija. Pieejamība ir atkarīga no klienta, viņa ierīces un norēķināšanās, tāpēc metodes pieprasīšana nepadara to pieejamu. Šeit sepa un blik ir finansēšanas iespējas kartes norēķināšanās ietvaros, nevis Swipelux iespējas, maksājumu ceļi vai konti. Iepriekšējā atlase nemaina kotācijas iespēju, summas vai maksas, un norēķināšanās apstiprina galīgās maksas. Pārveduma nolasījumi atgriež pieprasīto vērtību; tie neapstiprina, kuru metodi klients izmantoja. Ja checkoutMethod tiek nosūtīts kotācijai, kas nav kartes kotācija, pieprasījums neiztur validāciju, nevis tiek ignorēts, un atkārtojumam ar to pašu idempotences atslēgu jānosūta tas pats checkoutMethod.

3. Iegūstiet finansēšanas instrukcijas

Nolasiet GET /v3/transfers/{transferId}/instructions. Attēlojiet atgriezto data.instructions variantu, nepieņemot pieņēmumus par tā tipu. Šīs detaļas ir specifiskas pārvedumam. Nekad neizmantojiet cita pārveduma bankas koordinātas, kodu, mitināto URL, summu, atsauci vai termiņu jaunai iemaksai. Bankas instrukcijām, kad reference.required ir true, parādiet precīzu reference.value blakus bankas koordinātām un padariet to kopējamu. Parādiet atgriezto summu un valūtu no tās pašas instrukciju kopas. Izsniegts bankas konts ir citādāks: tas nodrošina atkārtoti izmantojamus rekvizītus vēlākām iemaksām. Skatiet Izsniegt bankas kontu, ja tā ir paredzētā pieredze.

4. Sekojiet norēķinam

Pēc izpildes un pēc katra notikuma nolasiet GET /v3/transfers/{transferId}. Vadiet klientam redzamo statusu no jaunākā data.state. Izmantojiet data.stateDetail un data.openTaskIds, kad pārvedumam nepieciešama papildu darbība. Nemarķējiet to kā pabeigtu, pamatojoties uz gaidīto grafiku. Tālāk pievienojiet Webhook izsaukumus un uzturiet pārveduma statusu sinhronizētu, līdz tas sasniedz rezultātu, ko jūsu produkts apstrādā.

Sākt darbu

Klientu iekļaušana

Veidot naudas plūsmas

Palaišana

Saņemt līdzekļus

Pirms sākat

1. Izveidojiet kotāciju

2. Izpildiet kotāciju

Pievienojiet atgriešanās URL kartei un Apple Pay

Iepriekš atlasiet norēķināšanās metodi kartes kotācijai

3. Iegūstiet finansēšanas instrukcijas

4. Sekojiet norēķinam

​Pirms sākat

​1. Izveidojiet kotāciju

​2. Izpildiet kotāciju

​Pievienojiet atgriešanās URL kartei un Apple Pay

​Iepriekš atlasiet norēķināšanās metodi kartes kotācijai

​3. Iegūstiet finansēšanas instrukcijas

​4. Sekojiet norēķinam

Pirms sākat

1. Izveidojiet kotāciju

2. Izpildiet kotāciju

Pievienojiet atgriešanās URL kartei un Apple Pay

Iepriekš atlasiet norēķināšanās metodi kartes kotācijai

3. Iegūstiet finansēšanas instrukcijas

4. Sekojiet norēķinam