Den här guiden täcker Qliro-specifik konfiguration när du ansluter Qliro till Specter via Junipeer. Innan du läser detta, se till att du har arbetat igenom den universella PSP-installationsguiden — den täcker alla grundläggande steg som gäller för varje betaltjänstleverantörsintegration:
[Ansluta betaltjänster till Junipeer →](/guides/payment-services-101)
Stegen i den guiden (flödesval, uppgifter, OSS-mappning, avräkningskontomappning, webhook-aktivering) gäller alla här. Den här artikeln dokumenterar bara vad som är specifikt för Qliro och Specter.
Uppgifter
För att ansluta Qliro till Junipeer behöver du dina Qliro API-uppgifter. Kontakta din Qliro-kontoansvarig för att få dessa om du inte redan har dem.
Qliro-specifika inställningar
Följande inställningar är tillgängliga i Qliro-anslutningskonfigurationen och är specifika för denna integration. Båda är valfria.
Avgiftsartikelnummer i Specter
Detta är SKU:n som används för att identifiera en avgiftsrad i Specter när Qliro inkluderar en avgift i transaktionen.
Om Qliro tar ut en avgift (t.ex. en betalningsavgift), behöver Junipeer veta vilket Specter-artikelnummer som ska användas när den motsvarande raden skapas
Lämna det här fältet tomt om du har aktiverat Kreditera alltid avgift eller Fånga alltid avgift i Qliro — i dessa fall hanteras avgiften helt på Qliro-sidan och behöver inte ett Specter-artikelnummer
Lämna det också tomt om du alltid vill hantera avgiften direkt i Qliro utan att den visas som en rad i Specter
Om du är osäker på om du ska fylla i detta, kontrollera med din Qliro-kontoansvarig om avgifter visas som radartikar i de avräkningsdata som Qliro skickar till Junipeer.
Betalningsreferensprefix
Om det är inställt läggs detta prefix till alla betalningsreferenser som skickas från Junipeer till Specter.
Till exempel, om ditt prefix är QLIRO-, visas en betalningsreferens på 12345 i Specter som QLIRO-12345.
Detta är användbart när du har flera betalningsleverantörer anslutna till samma Specter-konto och vill skilja Qliro-transaktioner åt vid en snabb blick. Lämna det tomt om du inte behöver denna distinktion.
Återbetalningar
Att skapa kreditfakturor (återbetalningar) i Specter via Qliro kräver Qliro API Plus-uppgifter — standard-API-uppgifter är inte tillräckliga för denna åtgärd.
Om återbetalningar misslyckas eller kreditfakturor inte skapas är det första att kontrollera om dina API Plus-uppgifter är korrekt konfigurerade. I Junipeer, navigera till dina Qliro-anslutningsinställningar och granska nycklarna under PLUS-inställningar.
Om du inte har API Plus-uppgifter, kontakta din Qliro-kontoansvarig för att få dem aktiverade på ditt konto.
Uppdatera orderstatus
För att Junipeer ska kunna uppdatera orderstatusen i Qliro (t.ex. markera en order som skickad) måste Qliro vara konfigurerat som en betalningsmetod i Specter — inte en generisk betalningstyp som fak (Faktura).
Detta är en vanlig felkonfiguration. Om Qliro inte är inställt som sin egen betalningsmetod i Specter kan Junipeer inte skicka statusuppdateringar tillbaka till Qliros handlarcenter. Ordern bearbetas och faktureras korrekt i Specter, men Qliro visar ordern som "Ej skickad" på obestämd tid — eftersom statusuppdateringssignalen aldrig når Qliro.
Symptom: Order är markerad som "levererad och fakturerad" i Specter men förblir "Ej skickad" i Qliros handlarcenter.
Orsak: Betalningsmetoden i Specter är inställd på fak eller ett annat generiskt värde istället för Qliro.
Åtgärd: I Specter, se till att Qliro är konfigurerat som en dedikerad betalningsmetod. När det är korrigerat, utlös statusuppdateringen från Junipeer igen.
Go-live
Precis som med alla PSP-integrationer går Qliro live via webhook-aktivering, inte via knappen Starta synkronisering. När din konfiguration är klar, kontakta din Junipeer-onboardingkontakt för att granska konfigurationen och aktivera webhooks.
För felsökning, se Felkoder-referensen eller kontakta support@junipeer.io.