Koppelprofiel Ogone: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Nieuwe pagina aangemaakt met '__TOC__ = Inleiding = BuitenBeter is een dienst waarmee burgers eenvoudig via een smartphone een melding kunnen indienen over de woon- of leefomgeving bij de geme...')
 
(Beheer)
(34 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 1: Regel 1:
 
__TOC__
 
__TOC__
 
  
 
= Inleiding =
 
= Inleiding =
BuitenBeter is een dienst waarmee burgers eenvoudig via een smartphone een melding kunnen indienen over de woon- of leefomgeving bij de gemeente. Het versturen van een melding betekent dat er automatisch een zaak wordt geregistreerd in het zaaksysteem en dat melder een bericht ontvangt over de voortgang van de behandeling.
+
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.
 
 
= Inrichting zaaksysteem =
 
Het inrichten van een koppeling met BuitenBeter kan geheel zelfstandig worden uitgevoerd door gebruik te maken van het koppelprofiel.
 
  
= Inrichting extern systeem =
+
= Instellingen =
= Testscenario =
+
{| 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.
  
== Koppelprofiel beheren ==
+
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.
* Als beheerder wil ik
+
|-
 +
|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.
 +
|}
  
== Meldingen behandelen ==
+
= Beheer =
* Als behandelaar wil ik
+
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>
 +
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.
 +
{| width=100%
 +
|- style="vertical-align:top"
 +
|style="width:300px"|
 +
<ol start="1">
 +
<li>Ga naar: [http://www.internetkassa.com/ Internetkassa] > [https://secure.ogone.com/ncol/prod/backoffice PROD-login]</li>
 +
</ol>
 +
|
 +
|
 +
|- style="vertical-align:top"
 +
|colspan="3"|
 +
<ol start="2">
 +
<li>Ga naar: Configureren > Technische informatie</li>
 +
</ol>
 +
|- style="vertical-align:top"
 +
|
 +
<ol start="3">
 +
<li>Tabblad: Uw technische instellingen
 +
|
 +
Geen handelingen vereist
 +
</li>
 +
</ol>
 +
|
 +
|- style="vertical-align:top"
 +
|
 +
<ol start="4">
 +
<li>Tabblad: Algemene transactieparameters
 +
|
 +
Geen handelingen vereist
 +
</li>
 +
</ol>
 +
|
 +
|- style="vertical-align:top"
 +
|
 +
<ol start="5">
 +
<li>Tabblad: Algemene beveiligingsparameters
 +
|
 +
<ul>
 +
<li>Hash-algoritme: SHA-512</li>
 +
<li>Karaktercodering: UTF-8</li>
 +
</ul>
 +
</li>
 +
</ol>
 +
|[[bestand:Koppelprofiel ogone algemene beveiligingsparameters.png|thumb|Tabblad: Algemene beveiligingsparameters]]
 +
|- style="vertical-align:top"
 +
|
 +
<ol start="6">
 +
<li>Tabblad: Betaalpagina
 +
|
 +
Geen handeling vereist
 +
</li>
 +
</ol>
 +
|
 +
|- style="vertical-align:top"
 +
|
 +
<ol start="7">
 +
<li>Tabblad: Verificatie data en herkomst
 +
|
 +
<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>
 +
</ul>
 +
</li>
 +
</ol>
 +
|[[bestand:Koppelprofiel ogone verificatie data en herkomst.png|thumb|Tabblad: Verificatie data en herkomst]]
 +
|- style="vertical-align:top"
 +
|
 +
<ol start="8">
 +
<li>Tabblad: Transactiefeedback
 +
|
 +
<ul>
 +
<li>Vinkje aan bij: <i>"Ik wil de feedbackparameters van de transacties op de redirectie-URL's ontvangen."</i></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>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>
 +
</li>
 +
</ol>
 +
|[[bestand:Koppelprofiel ogone transactiefeedback.png|thumb|Tabblad: Transactiefeedback]]
 +
|- style="vertical-align:top"
 +
|
 +
<ol start="9">
 +
<li>Tabblad: Transactie e-mails
 +
|
 +
Geen handelingen vereist
 +
</li>
 +
</ol>
 +
|
 +
|}
  
= Beheer en onderhoud =
+
=== Zaaksysteem ===
beheerders van het zaaksysteem kunnen de werking van de koppeling goed in de gaten houden. Alle berichten die worden ontvangen en verstuurd, worden opgeslagen in de transactielog. In de transactielog is terug te vinden of de verwerking van een bericht is gelukt, of dat deze mislukt is en een fout heeft gegenereerd.
+
{| width=100%
= Voorbeeldbestanden =
+
|- style="vertical-align:top"
= Overige documentatie =
+
|
 +
<ol>
 +
<li>Plaats de bij stap 7 gekopieerde string in het veld '#'</li>
 +
<li>Plaats de bij stap 8 gekopieerde string in het veld '#'</li>
 +
</ol>
 +
|[[bestand:koppelprofiel_internetkassa.png|thumb|Koppelprofiel internetkassa]]
 +
|}

Versie van 22 sep 2017 om 11:28

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 > PROD-login
    1. Ga naar: Configureren > Technische informatie
    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