Je kunt URL-kennisgevingen (webhooks) configureren om automatisch naar je systeem te worden verzonden wanneer transacties op je site worden verwerkt.
configureren URL-kennisgeving
URL-kennisgevingen kunnen worden ingeschakeld/uitgeschakeld door je HTTPS POST aan te passen zoals in de volgende voorbeelden wordt getoond:
<!--This enables the successful URL notification rule-->
<input type=hidden name="ruleidentifier" value="STR-8">
<!--Successful URL notification destination-->
<input type=hidden name="successfulurlnotification" value="http://yourwebsite.com/successful"><!--This enables the declined URL notification rule-->
<input type=hidden name="ruleidentifier" value="STR-9">
<!--Declined URL notification destination-->
<input type=hidden name="declinedurlnotification" value="http://yourwebsite.com/declined">Elke regelidentificatie in je bericht (bijv. "STR-8") en de URL's die zijn ingediend voor de melding moeten worden opgenomen in de string die wordt gebruikt om je hash voor de beveiliging van de aanvraagsite te genereren. Als je dit niet doet, krijgt de klant een foutmelding "Ongeldige gegevens" te zien.
Omgaan met URL-kennisgevingen
Je moet je systeem configureren om de inkomende URL-kennisgevingen op poort 443 te accepteren. Als de hash voor de beveiliging van de antwoordsite correct is, moet je systeem binnen 8 seconden na ontvangst van een melding reageren met een HTTP 200 OK-antwoord (bijvoorbeeld "HTTP/1.0 200 OK").
Er wordt één melding per verzoek verstuurd, maar als uw systeem niet reageert, blijft Trust Payments tot 48 uur lang opnieuw meldingen versturen totdat een bevestiging is ontvangen.
Als we binnen 48 uur geen bevestiging ontvangen, sturen we een e-mail met verdere details naar het standaard e-mailadres dat is gekoppeld aan uw site referentie (neem contact op met ons Support Team om dit adres bij te werken).
Formaat van URL-kennisgeving
De van Trust Payments verzonden melding zal een geldige HTTP/1.1 Content-type header bevatten die door uw systeem wordt geaccepteerd. Bijvoorbeeld:
Content-type: application/x-www-form-urlencoded; charset=UTF-8
De opgenomen veldnamen en gegevens worden geëncodeerd.
Indien de mededeling bijvoorbeeld de velden "baseamount", "errorcode" en "orderreference" bevat met respectievelijk de waarden "2499", "0" en "customerorder1", dan kan de mededeling er als volgt uitzien (het veld notificationreference wordt altijd geretourneerd):
baseamount=2499&errorcode=0¬ificationreference=1-A60356&orderreference=customerorder1
Geretourneerde velden
URL-kennisgevingen met behulp van systeemregels (STR-x) zullen standaard de volgende informatievelden bevatten:
- transactionreference
- requestreference
- orderreference
- sitereference
- errorcode
- settlestatus
- paymenttypedescription
De kennisgeving zal ook de hash voor de beveiliging van de locatie van het antwoord bevatten (hierop wordt hieronder nader ingegaan).
Als u extra velden wilt toevoegen, kunt u uw HTTPS POST bijwerken om stextraurlnotifyfields toe te voegen. Het volgende voorbeeld bevat de Voornaam facturatie, achternaam en e-mailadres in een URL-kennisgeving, naast de standaardvelden die hierboven zijn vermeld:
<form method="POST" action="<DOMAIN>/process/payments/choice">
...
<input type="hidden" name="ruleidentifier" value="STR-8">
<input type="hidden" name="allurlnotification" value="http://www.yourwebsite.com/all">
<input type="hidden" name="stextraurlnotifyfields" value="billingfirstname">
<input type="hidden" name="stextraurlnotifyfields" value="billinglastname">
<input type="hidden" name="stextraurlnotifyfields" value="billingemail">
...
<input type="submit" value="Pay">
</form>Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.
Je ontvangt ook een gehashte responsesitesecurity waarde in URL-kennisgevingen die naar je systeem wordt gestuurd. We raden u sterk aan de teruggestuurde responsesitesecurity hash te herberekenen om er zeker van te zijn dat deze niet is gewijzigd door een klant of derde partij en dat de velden zijn verzonden door Trust Payments.
