Før du starter
Du trenger en klar pay-in-capability og en klar utstedt destinasjonslommebok for samme kunde. Fullfør eventuelt åpent arbeid via Capabilities og oppgaver, og hent så begge ressursene på nytt.1. Opprett et tilbud
Opprett prisen medPOST /v3/quotes. Send disse headerne:
data.id som QUOTE_ID. Presenter de returnerte beløpene og gebyrene fremfor å bygge dem opp på nytt fra kursen.
2. Utfør tilbudet
Utfør det gjeldende tilbudet før utløp medPOST /v3/transfers. Bruk en ny nøkkel for denne tiltenkte overføringen:
data.id som TRANSFER_ID og behold gjeldende tilstand.
Legg til en retur-URL for kort og Apple Pay
For et kort- eller Apple Pay-tilbud kan du inkludere en valgfriredirectUrl i samme forespørsel. Etter at kunden har fullført den hostede checkouten, åpner checkout-siden denne URL-en for å ta kunden tilbake til appen din.
redirectUrl må være en absolutt HTTPS-URL på maksimalt 2048 tegn og kan ikke inneholde innebygde påloggingsopplysninger. Å sende redirectUrl for et tilbud som ikke støtter returnavigasjon, feiler i valideringen i stedet for å bli ignorert.
Ankomst til redirectUrl er kun nettlesernavigasjon. Den bekrefter ikke at betalingen eller overføringen ble fullført. Avgjør fullføring ut fra overføringens tilstand i trinn 4 og fra webhook-hendelser.
Forhåndsvelg checkout-metoden for et korttilbud
For et korttilbud kan du inkludere en valgfricheckoutMethod i samme forespørsel for å velge hvilket betalingsalternativ den hostede checkouten åpnes med. De gjeldende verdiene er card, apple_pay, google_pay, cash_app, sepa og blik. Listen er åpen og kan vokse, så godta verdier du ikke kjenner igjen i lesing av overføringer. Checkouten åpnes med den forespurte metoden når den er tilgjengelig for kunden og enheten deres, og kunden kan fortsatt velge en hvilken som helst annen metode checkouten tilbyr. Utelat feltet for å beholde standard forhåndsvalg.
checkoutMethod er en preferanse, ikke en garanti. Tilgjengeligheten avhenger av kunden, enheten deres og checkouten, så det å be om en metode gjør den ikke tilgjengelig. Her er sepa og blik betalingsalternativer inne i kort-checkouten, ikke Swipelux-kapabiliteter, -skinner eller -kontoer. Forhåndsvalget endrer ikke tilbudets kapabilitet, beløp eller gebyrer, og checkouten bekrefter de endelige gebyrene. Lesing av overføringen returnerer den forespurte verdien; den bekrefter ikke hvilken metode kunden brukte. Å sende checkoutMethod for et tilbud som ikke er et korttilbud, feiler i valideringen i stedet for å bli ignorert, og en gjentakelse med samme idempotensnøkkel må sende samme checkoutMethod.
3. Hent finansieringsinstruksjoner
LesGET /v3/transfers/{transferId}/instructions. Render den returnerte data.instructions-varianten uten å anta typen.
Disse opplysningene er overføringsspesifikke. Gjenbruk aldri en overførings bankkoordinater, kode, hosted URL, beløp, referanse eller utløp for en annen pay-in.
For bankinstruksjoner: når reference.required er true, vis den nøyaktige reference.value ved siden av bankkoordinatene og gjør den kopierbar. Vis det returnerte beløpet og valutaen fra samme instruksjonssett.
En utstedt bankkonto er noe annet: den gir gjenbrukbare opplysninger for senere innskudd. Se Utsted en bankkonto når det er den tiltenkte opplevelsen.
4. Følg opp oppgjøret
LesGET /v3/transfers/{transferId} etter utførelse og etter hver hendelse. Driv den kundevendte statusen fra siste data.state.
Bruk data.stateDetail og data.openTaskIds når overføringen trenger en ny handling. Ikke merk den som fullført ut fra en forventet plan.
Deretter, legg til Webhooks og hold overføringsstatusen synkronisert til den når et utfall som produktet ditt håndterer.