URL-kennisgevingen volgende betalingen - Trust Payments

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">

Alle regel-ID’s die in je bericht staan (bijv. „STR-8”) en de URL’s die voor de melding zijn opgegeven, moeten worden opgenomen in de tekenreeks die wordt gebruikt om je beveiligingshash van de aanvraagwebsite. Als u dit niet doet, krijgt de klant de foutmelding "Ongeldige gegevens" te zien.

Meer informatie over de ruleidentifier veld en STRTrust Payments Rules).

Omgaan met URL-kennisgevingen

U moet uw systeem zo configureren dat het inkomende URL-kennisgevingen poort 443 accepteert. Als de beveiligingshash van de antwoordende site correct is, moet uw systeem zo snel mogelijk na ontvangst van een melding reageren met een HTTP 200 OK-antwoord (bijvoorbeeld „HTTP/1.0 200 OK“). (We hanteren een responstijd van 8 seconden voor het geval er een onverwachte vertraging optreedt.)

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&notificationreference=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.

Belangrijk: De namen van alle extra velden die in de melding moeten worden weergegeven, moeten worden opgenomen in de tekenreeks die wordt gebruikt om de beveiligingshash van de aanvraagwebsite. Als u dit niet doet, krijgt de klant de foutmelding “Ongeldige gegevens” te zien.

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.

Leer hoe u de beveiliging van reactiesites configureert.