Koppelprofiel Ogone

Uit ZaaksysteemWiki
Versie door Admin (overleg | bijdragen) op 22 sep 2017 om 11:27 (Beheer)
Ga naar: navigatie, zoeken

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