Koppelprofiel Ogone: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Beheer)
(Beheer)
(25 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="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"
 
|- style="vertical-align:top"
 
|
 
|
<ol start="1">
+
<ol start="4">
<li></li>
+
<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>
 
</ol>
|[[bestand:Koppelprofiel ogone stap 1|thumb|Koppelprofiel ogone stap 1]]
+
|
 
|}
 
|}
 +
 
=== Zaaksysteem ===
 
=== Zaaksysteem ===
 
{| width=100%
 
{| width=100%
Regel 26: Regel 145:
 
|
 
|
 
<ol>
 
<ol>
<li>Plaats de bij stap X gekopieerde string in het veld 'under construction'</li>
+
<li>Plaats de bij stap 7 gekopieerde string in het veld '#'</li>
<li>Plaats de bij stap X gekopieerde string in het veld 'under construction'</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>
 

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