Koppelprofiel Ogone: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Ogone)
 
(19 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 3: Regel 3:
 
= Inleiding =
 
= Inleiding =
 
Voor sommige producten moet de klant enkel aan de balie komen om te betalen. Door dit online mogelijk te maken kan de klant deze producten vanuit huis/kantoor bestellen. Denk hierbij aan de verschillende GBA uittreksels, parkeervergunningen en bouwtekeningen.
 
Voor sommige producten moet de klant enkel aan de balie komen om te betalen. Door dit online mogelijk te maken kan de klant deze producten vanuit huis/kantoor bestellen. Denk hierbij aan de verschillende GBA uittreksels, parkeervergunningen en bouwtekeningen.
 +
 +
= Instellingen =
 +
{| class="wikitable"
 +
|-
 +
!Instelling
 +
!Omschrijving
 +
|-
 +
|Ogone ID
 +
|Het ID van het account bij ogone
 +
|-
 +
|SHA-IN versleuteling
 +
|De SHA-IN versleuteling zoals opgegeven in de configuratie van ogone
 +
|-
 +
|SHA-1-OUT Versleuteling
 +
|De SHA-1-OUT versleuteling zoals opgegeven in de configuratie van ogone
 +
|-
 +
|Hash-algoritme
 +
|Het type hash-algoritme zoals opgegeven in de configuratie van ogone
 +
<li>sha512
 +
<li>sha1
 +
|-
 +
|Terugkeer-URL
 +
|De URL van de omgeving, bijvoorbeeld: <i>mijn.gemeente.nl</i>, <i>zaaksysteem-accept.gemeente.nl</i>
 +
|-
 +
|Order omschrijving
 +
|Een omschrijving die gebruikt kan worden meer informatie te geven bij de transactie in ogone. Hiervoor kunnen ook magicstrings ingezet worden. De output wordt tot maximaal honderd tekens weergegeven bij 'Omschrijving' in het transactieoverzicht van ogone.
 +
 +
Let op: Niet alle tekens worden ondersteund. Beperk de invulling zoveel mogelijk tot normale karakters (letters, hoofdletters, cijfers, diakrieten). Wanneer de output een teken bevat die niet ondersteund wordt zal dit direct duidelijk zijn op de eerste pagina van ogone, waar een foutmelding getoond wordt en de prijs van de betaling niet wordt weergegeven.
 +
|-
 +
|Modus
 +
|Type account bij ogone
 +
<li>Acceptatie
 +
<li>Productie
 +
|-
 +
|Tekst voor knop "Anders betalen"
 +
|Vul hier de naam van de knop in die de aanvrager gebruikt als hij/zij niet online wil betalen.
 +
|}
  
 
= Beheer =
 
= Beheer =
 
De koppeling zelf wordt momenteel volledig beheerd door Mintlab, maar de gemeente heeft als eigenaar een inlog op de beheeromgeving en kan daar alle transacties inzien: [http://www.internetkassa.com/ Internetkassa] > [https://secure.ogone.com/ncol/prod/backoffice PROD-login]. Hier kan bij twijfel ingezien worden of een transactie werkelijk afgerond of geannuleerd was.<br>
 
De koppeling zelf wordt momenteel volledig beheerd door Mintlab, maar de gemeente heeft als eigenaar een inlog op de beheeromgeving en kan daar alle transacties inzien: [http://www.internetkassa.com/ Internetkassa] > [https://secure.ogone.com/ncol/prod/backoffice PROD-login]. Hier kan bij twijfel ingezien worden of een transactie werkelijk afgerond of geannuleerd was.<br>
 
<br>
 
<br>
<div style="height: 50px; width: 1000px; overflow: scroll; resize:both; border:1px outset #000;">
+
In onderstaande stappen staat aangegeven welke gegevens gewijzigd moeten worden in de configuratie van de internetkassa. Met uitzondering van het tabblad 'transactie e-mails' moeten alle gegevens ongewijzigd blijven tenzij hier vermeld.
Under construction<br>
 
<br>
 
= Beheer =
 
De koppeling kan volledig aangemaakt worden door de zaaksysteem. Doorloop hiervoor onderstaande beschrijving voor de instellingen in Ogone en het zaaksysteem.
 
=== Ogone ===
 
 
{| width=100%
 
{| width=100%
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|style="width:300px"|
 
|style="width:300px"|
 
<ol start="1">
 
<ol start="1">
<li>Ga naar: [http://www.internetkassa.com/ Internetkassa] > [https://secure.ogone.com/ncol/prod/backoffice PROD-login]</li>
+
<li>Ga naar: [http://www.internetkassa.com/ Internetkassa] > [https://secure.ogone.com/Ncol/Test/Backoffice/login/index?branding=OGONE&CSRFSP=%2fncol%2ftest%2fbackoffice%2fhome%2findex&CSRFKEY=2E5B22BBC3C4560597F0B6CBF45ED8E5CD5B3C61&CSRFTS=20211223142812]</li>
 
</ol>
 
</ol>
 
|
 
|
Regel 24: Regel 56:
 
|colspan="3"|
 
|colspan="3"|
 
<ol start="2">
 
<ol start="2">
<li>Ga naar: Configureren > Technische informatie</li>
+
<li>Ga naar: Configuratie > Technische instellingen</li>
 
</ol>
 
</ol>
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
Regel 34: Regel 66:
 
</li>
 
</li>
 
</ol>
 
</ol>
|[[bestand:Koppelprofiel ogone stap 1|thumb|Koppelprofiel ogone stap 1]]
+
|
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|
 
|
Regel 43: Regel 75:
 
</li>
 
</li>
 
</ol>
 
</ol>
|[[bestand:Koppelprofiel ogone stap 3|thumb|Tabblad: Algemene transactieparameters]]
+
|
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|
 
|
Regel 55: Regel 87:
 
</li>
 
</li>
 
</ol>
 
</ol>
|[[bestand:Koppelprofiel ogone stap 4|thumb|Tabblad: Algemene beveiligingsparameters]]
+
|[[bestand:Koppelprofiel ogone algemene beveiligingsparameters.png|thumb|Tabblad: Algemene beveiligingsparameters]]
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|
 
|
Regel 64: Regel 96:
 
</li>
 
</li>
 
</ol>
 
</ol>
|[[bestand:Koppelprofiel ogone stap 5|thumb|Tabblad: Betaalpagina]]
+
|
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|
 
|
Regel 71: Regel 103:
 
|
 
|
 
<ul>
 
<ul>
 +
<li>URL van pagina van de merchant: Vul hier de URL in van het zaaksysteem (bijvoorbeeld: <nowiki>https://zaaksysteem.gemeente.nl)</nowiki></li>
 
<li>SHA-IN versleuteling: Vul hier een unieke string in en bewaar deze tijdelijk voor de configuratie in het zaaksysteem</li>
 
<li>SHA-IN versleuteling: Vul hier een unieke string in en bewaar deze tijdelijk voor de configuratie in het zaaksysteem</li>
 
</ul>
 
</ul>
 
</li>
 
</li>
 
</ol>
 
</ol>
|[[bestand:Koppelprofiel ogone stap 6|thumb|Tabblad: Verificatie data en herkomst]]
+
|[[bestand:Koppelprofiel ogone verificatie data en herkomst.png|thumb|Tabblad: Verificatie data en herkomst]]
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|
 
|
Regel 85: Regel 118:
 
<li>Dynamische e-commerce-parameters: Zorg ervoor dat 'amount' geselecteerd is.</li>
 
<li>Dynamische e-commerce-parameters: Zorg ervoor dat 'amount' geselecteerd is.</li>
 
<li>Vinkje uit bij: <i>"Ik wil dat Ogone een "in verwerking" boodschap toont aan de klant tijdens het verwerken van de betaling."</i></li>
 
<li>Vinkje uit bij: <i>"Ik wil dat Ogone een "in verwerking" boodschap toont aan de klant tijdens het verwerken van de betaling."</i></li>
<li>Veiligheid voor de request parameters: Vul hier een unieke string in en bewaar deze tijdelijk voor de configuratie in het zaaksysteem</li>
+
<li>Veiligheid voor de request parameters: Vul hier een unieke string in en bewaar deze tijdelijk voor de 'SHA-1-OUT Versleuteling' in het zaaksysteem</li>
 +
<li>Bij: HTTP request voor statusveranderingen.
 +
  <ul>
 +
  <li>Kies voor de optie: Voor alle offline statusveranderingen (betaling, annulering...).</li>
 +
  <li>Vul hier in: <nowiki>https://{omgeving}.zaaksysteem.nl/plugins/ogone/api/process</nowiki></li>
 +
  </ul>
 +
</li>
 
</ul>
 
</ul>
 
</li>
 
</li>
 
</ol>
 
</ol>
|[[bestand:Koppelprofiel ogone stap 7|thumb|Tabblad: Transactiefeedback]]
+
|[[bestand:Koppelprofiel ogone transactiefeedback.png|thumb|Tabblad: Transactiefeedback]]
 
|- style="vertical-align:top"
 
|- style="vertical-align:top"
 
|
 
|
Regel 98: Regel 137:
 
</li>
 
</li>
 
</ol>
 
</ol>
|[[bestand:Koppelprofiel ogone stap 8|thumb|Tabblad: Transactie e-mails]]
+
|
 
|}
 
|}
  
Regel 109: Regel 148:
 
<li>Plaats de bij stap 8 gekopieerde string in het veld '#'</li>
 
<li>Plaats de bij stap 8 gekopieerde string in het veld '#'</li>
 
</ol>
 
</ol>
|[[bestand:koppelprofiel internetkassa.png|thumb|Koppelprofiel internetkassa]]
+
|[[bestand:koppelprofiel_internetkassa.png|thumb|Koppelprofiel internetkassa]]
 
|}
 
|}
</div>
 
 
= Betaalproces =
 
Het betaalproces verloopt alsvolgt:
 
<ul>
 
<li>De klant vult het webformulier in</li>
 
<li>De klant verstuurt het webformulier</li>
 
<li>De zaak wordt aangemaakt en krijgt de betaalstatus 'wachten op betaling'</li>
 
<li>De klant komt op de betalingstap van het webformulier</li>
 
<li>De klant start het betalingsproces</li>
 
<li><br><ol><li><ul>
 
<li>De klant rond de betaling af</li>
 
<li>De klant wordt teruggeleid naar het zaaksysteem</li>
 
<li>Hierop ontvangt het zaaksysteem het bericht dat de betaling succesvol was</li>
 
<li>De klant krijgt het bericht 'betaling succesvol'</li>
 
<li>De zaak krijgt de betaalstatus 'geslaagd'</li>
 
</ul></li>
 
<br>
 
<li><ul>
 
<li>De klant rond de betaling af</li>
 
<li>De klant sluit de browser voordat hij teruggeleid is naar het zaaksysteem</li>
 
<li>(de betaalstatus blijft 'wachten op betaling', want het zaaksysteem wacht nog op bericht van Ogone)</li>
 
</ul></li>
 
<br>
 
<li><ul>
 
<li>De klant annuleert de betaling</li>
 
<li>De klant wordt teruggeleid naar het zaaksysteem</li>
 
<li>Hierop ontvangt het zaaksysteem het bericht dat de betaling niet succesvol was</li>
 
<li>De klant krijgt het bericht 'betaling niet succesvol'</li>
 
<li>De zaak krijgt de betaalstatus 'niet geslaagd'</li>
 
<li>De zaak wordt verwijderd</li>
 
</ul></li>
 
<br>
 
<li><ul>
 
<li>De klant annuleert de betaling</li>
 
<li>De klant sluit de browser voordat hij teruggeleid is naar het zaaksysteem</li>
 
<li>(de betaalstatus blijft 'wachten op betaling', want het zaaksysteem wacht nog op bericht van Ogone)</li>
 
</ul></li>
 
</ol></li></ul>
 

Huidige versie van 23 dec 2021 om 13:37

Inleiding

Voor sommige producten moet de klant enkel aan de balie komen om te betalen. Door dit online mogelijk te maken kan de klant deze producten vanuit huis/kantoor bestellen. Denk hierbij aan de verschillende GBA uittreksels, parkeervergunningen en bouwtekeningen.

Instellingen

Instelling Omschrijving
Ogone ID Het ID van het account bij ogone
SHA-IN versleuteling De SHA-IN versleuteling zoals opgegeven in de configuratie van ogone
SHA-1-OUT Versleuteling De SHA-1-OUT versleuteling zoals opgegeven in de configuratie van ogone
Hash-algoritme Het type hash-algoritme zoals opgegeven in de configuratie van ogone
  • sha512
  • sha1
  • Terugkeer-URL De URL van de omgeving, bijvoorbeeld: mijn.gemeente.nl, zaaksysteem-accept.gemeente.nl
    Order omschrijving Een omschrijving die gebruikt kan worden meer informatie te geven bij de transactie in ogone. Hiervoor kunnen ook magicstrings ingezet worden. De output wordt tot maximaal honderd tekens weergegeven bij 'Omschrijving' in het transactieoverzicht van ogone.

    Let op: Niet alle tekens worden ondersteund. Beperk de invulling zoveel mogelijk tot normale karakters (letters, hoofdletters, cijfers, diakrieten). Wanneer de output een teken bevat die niet ondersteund wordt zal dit direct duidelijk zijn op de eerste pagina van ogone, waar een foutmelding getoond wordt en de prijs van de betaling niet wordt weergegeven.

    Modus Type account bij ogone
  • Acceptatie
  • Productie
  • Tekst voor knop "Anders betalen" Vul hier de naam van de knop in die de aanvrager gebruikt als hij/zij niet online wil betalen.

    Beheer

    De koppeling zelf wordt momenteel volledig beheerd door Mintlab, maar de gemeente heeft als eigenaar een inlog op de beheeromgeving en kan daar alle transacties inzien: Internetkassa > PROD-login. Hier kan bij twijfel ingezien worden of een transactie werkelijk afgerond of geannuleerd was.

    In onderstaande stappen staat aangegeven welke gegevens gewijzigd moeten worden in de configuratie van de internetkassa. Met uitzondering van het tabblad 'transactie e-mails' moeten alle gegevens ongewijzigd blijven tenzij hier vermeld.

    1. Ga naar: Internetkassa > [1]
    1. Ga naar: Configuratie > Technische instellingen
    1. Tabblad: Uw technische instellingen

    Geen handelingen vereist

    1. Tabblad: Algemene transactieparameters

    Geen handelingen vereist

    1. Tabblad: Algemene beveiligingsparameters
    • Hash-algoritme: SHA-512
    • Karaktercodering: UTF-8
    Tabblad: Algemene beveiligingsparameters
    1. Tabblad: Betaalpagina

    Geen handeling vereist

    1. Tabblad: Verificatie data en herkomst
    • URL van pagina van de merchant: Vul hier de URL in van het zaaksysteem (bijvoorbeeld: https://zaaksysteem.gemeente.nl)
    • SHA-IN versleuteling: Vul hier een unieke string in en bewaar deze tijdelijk voor de configuratie in het zaaksysteem
    Tabblad: Verificatie data en herkomst
    1. Tabblad: Transactiefeedback
    • Vinkje aan bij: "Ik wil de feedbackparameters van de transacties op de redirectie-URL's ontvangen."
    • Dynamische e-commerce-parameters: Zorg ervoor dat 'amount' geselecteerd is.
    • Vinkje uit bij: "Ik wil dat Ogone een "in verwerking" boodschap toont aan de klant tijdens het verwerken van de betaling."
    • Veiligheid voor de request parameters: Vul hier een unieke string in en bewaar deze tijdelijk voor de 'SHA-1-OUT Versleuteling' in het zaaksysteem
    • Bij: HTTP request voor statusveranderingen.
      • Kies voor de optie: Voor alle offline statusveranderingen (betaling, annulering...).
      • Vul hier in: https://{omgeving}.zaaksysteem.nl/plugins/ogone/api/process
    Tabblad: Transactiefeedback
    1. Tabblad: Transactie e-mails

    Geen handelingen vereist

    Zaaksysteem

    1. Plaats de bij stap 7 gekopieerde string in het veld '#'
    2. Plaats de bij stap 8 gekopieerde string in het veld '#'
    Koppelprofiel internetkassa