Met deze extensie is het mogelijk om vanuit een Deployteq formulier of page een betaal proces te starten met Buckaroo. De implementatie is op basis van een POST naar de BPE-3.0-Gateway van Buckaroo, meer informatie over deze gateway van Buckaroo kan hier gevonden worden: BPE-3.0-Gateway-HTML.1.02.pdf.

Instellingen in Buckaroo

Om de implementatie te starten zijn de volgende gegevens benodigd:

Form URL
- Live URL: https://checkout.buckaroo.nl/html/
- Test URL: https://testcheckout.buckaroo.nl/html/
Websitekey
Secretkey

Hieronder een stappenplan om in Buckaroo de gewenste gegevens te verkrijgen:

Klik in functiegroep 'Service center' op de functie 'Koppelingen'.
Klik in het Panel 'Betaalprovider' in het kader 'Buckaroo' op de knop 'Configureren'.
Geef de instantie een naam, bijvoorbeeld Deployteq.
Ga naar: Mijn Buckaroo>>Websites>>Push intstellingen
- Vul de volgende gegevens in:
  - Hash-methode: SHA1
  - Munteenheid
  - Omgeving (test of productie) van de betaling
Ga naar: Mijn Buckaroo>>Websites>>Algemeen
- Neem de websitekey over
Ga naar: Configruatie>>Beveiliging>>Secret Key
- Neem de Secret Key over

formHash methode in Deployteq

Vanuit een formulier of page kunnen de klantgegevens en het gewenste bedrag worden uitgevraagd. Dit kan middels input of hidden velden in het formulier. Met behulp van de Smarty methode {{formHash}} kan een validatie SHA1 hash worden gegenereerd, deze wordt in een hexidecimaal formaat gebruikt om de betaling te starten in Buckaroo.

De formHash methode heeft de volgende eigenschappen;

algoritm
- Toelichting: De algoritme welke wordt toegepast om de gecodeerde hash te genereren. In het geval van Buckaroo is een SHA1 gewenst.
- Waarde: sha1
hashname
- Toelichting: De Buckaroo hash welke voortkomt uit de ingevulde waardes van de klant moet worden aangeboden in het veld 'Brq_signature', zodat deze aan hun zijde gevalideerd kan worden.
- Waarde: Brq_signature
fieldnames
- Toelichting: In dit veld moet komma gescheiden alle veldnamen van de inputvelden worden opgegeven welke van belang zijn voor de Buckaroo betaling. Daarbij moeten de velden op alfabetische volgorde worden opgegeven.
- Voorbeeld: Brq_amount,Brq_culture,Brq_currency,Brq_description,Brq_invoicenumber,Brq_websitekey
passphrase
- Toelichting: Dit veld bevat de secretkey van Buckaroo voor het opbouwen van de hash.
passphrasemode
- Toelichting: Het is mogelijk om de secretkey voor iedere waarde toe te voegen of eenmalig over de gehele string, alvorens deze voorzien wordt van een hash. Voor de Buckaroo integratie moet deze eenmalig over de gehele string worden toegepast.
- Waarde: once

formHash - Smarty voorbeeld

{{formHash algoritm='sha1' hashname='Brq_signature' fieldnames='Brq_amount,Brq_culture,Brq_currency,Brq_description,Brq_invoicenumber,Brq_websitekey' passphrase='<Hier komt de Secretkey>' passphrasemode='once'}}
<input type="hidden" name="Brq_websitekey" value="<Unieke_sleutel>" />
<input type="hidden" name="Brq_amount" value="15.22" />
<input type="hidden" name="Brq_description" value="Aankoop via Deployteq" />
<input type="hidden" name="Brq_currency" value="EUR" />
<input type="hidden" name="Brq_culture" value="NL" />
<input type="hidden" name="Brq_invoicenumber" value="EEC201112" />
{{/formHash}}

Voorbeeld pagina in Deployteq

In het onderstaand formulier Vanuit een formulier of page kunnen de klantgegevens en het gewenste bedrag worden uitgevraagd. Dit kan middels input of hidden velden in het formulier. Met behulp van de Smarty methode {{formHash}} sdf kan een validatie SHA1 hash worden gegenereerd om de betaling te starten in Buckaroo.

Op basis van een aantal (verborgen) velden met informatie over de transactie wordt een string gegenereerd. Deze string bestaat uit een SHA1 codering met daarover een hexadecimaal formaat, welke aangeboden moet worden in het (verborgen) veld Brg_signature. Deze wordt door de formHash smarty methode gegenereerd, zie onderstaand voorbeeld;

Voorbeeld Buckaroo pagina

<html dir="ltr">
  <head>
  <title>Testbetaling voor Buckaroo</title>
  </head>
  <body onload="document.buckaroo.action = 'https://testcheckout.buckaroo.nl/html/';">
  Vanuit dit formulier wordt een betaling gestart van €15,22 in een Buckaroo testomgeving als het e-mailadres, secretkey en websitekey is opgegeven.<br/><br/>
  <form method="post" name="buckaroo">
E-mailadres: <input type="text" name="email" /><br/><br/>
  {{formHash algoritm='sha1' hashname='Brq_signature' fieldnames='Brq_amount,Brq_culture,Brq_currency,Brq_description,Brq_invoicenumber,Brq_websitekey' passphrase='<Secretkey>'  passphrasemode='once'}}
  Geef hier uw website_key op: <input type="text" name="Brq_websitekey" /><br/>
  <input type="hidden" name="Brq_amount" value="15.22" />
  <input type="hidden" name="Brq_description" value="Aankoop via Deployteq" />
  <input type="hidden" name="Brq_currency" value="EUR" />
  <input type="hidden" name="Brq_culture" value="NL" />
  <input type="hidden" name="Brq_invoicenumber" value="EEC201112" />
  {{/formHash}}
  <input type="submit" value="Start betaling" />
</form>
  </body>
</html>

Mogelijke velden voor Buckaroo betaling

Hieronder een overzicht van alle mogelijke velden welke opgenomen kunnen worden in het Deployteq formulier en doorgestuurd worden naar Buckaroo

Parameter name	Description	Required
Brq_websitekey	The unique key of the website for which the payment is placed.	Yes
Brq_amount	The amount to pay in the format 12.34 (always use a dot as a decimal separator)	Yes
Brq_currency	The currency code (e.g. EUR, USD, GBP). Make sure the specified payment method supports the specified currency	Yes
Brq_invoicenumber	The unique invoice number that identifies the payment. This is a free text field of max. 255 characters.	Yes
Brq_signature	The digital signature. Refer to section ‘Digital signature’ for information on calculating the signature.	Yes
Brq_description	A description of the payment to aid the consumer.	No
Brq_culture	ISO culture code that specifies the language and/or country of residence of the consumer. Examples: en-US, en GB, de-DE, EN or DE. The language part of the culture code is used to apply language localization to the gateway. Currently the following languages are supported: NL, EN, DE. When the culture parameter is not supplied, the default culture en-US is used.	No
Brq_return	The return URL where the consumer is redirected after payment. If not supplied, the value specified in the Payment Plaza is used.	No
Brq_returncancel	The return URL used when the consumer cancels the payment. Fallback is the value in brq_return	No
Brq_returnerror	The return URL used when the request results in an error. Fallback is the value in brq_return	No
Brq_returnreject	The return URL used when the payment is rejected by the processor. Fallback is the value in brq_return	No
Brq_requestedservices	A comma separated list of service codes. If no specific service is passed in the field Brq_payment_method, all available services are displayed to a customer. Use this to specify which services should be shown. (Only services with an active subscription are shown)	No
Brq_uxmode	Overrides automatic user experience selection: use ‘touch’ to force touchscreen UX, use ‘normal’ to force regular (mouse) UX	No

Hoe krijg ik de Buckaroo integratie?

Wil je de implementatie gaan inzetten of wens je meer informatie, neem dan contact op met salessupport@deployteq.com of via 030-6988080