Waarschijnlijkheid van schade configureren (ProbH)

  Laatst bijgewerkt: 

  Overzicht van ProbH

  1. Dien een PROBH-verzoek in bij Trust Payments.
  2. Trust Payments gebruikt machine learning en andere technieken om de gokgeschiedenis van de klant te analyseren om de waarschijnlijkheid van schade te bepalen.
  3. Het PROBH-antwoord wordt teruggestuurd en bevat een score tussen 0 en 100% (weergegeven als een geheel getal tussen 0,000 en 1,000). Een waarde in de buurt van 0% suggereert een zeer laag risico voor de klant en een waarde in de buurt van 100% suggereert een zeer hoog risico.
  4. Als je vaststelt dat het risiconiveau te hoog is, stop je het transactieproces en laat je de klant een waarschuwing zien. Ga anders door met het verwerken van de transactie.

Hoewel een hogere schadescore duidt op een hoger risico en een lagere score op een lager risico, wil ik u erop wijzen dat Trust Payments een transactie nooit direct als hoog of laag risico zal bestempelen. Schaduwscores zijn indicatoren om rekening mee te houden bij de beslissing om door te gaan met een transactie. Om deze reden zal Trust Payments klanten nooit automatisch toestaan/blokkeren om transacties te verrichten met uw bedrijf zonder dat u uw account hiervoor expliciet hebt geconfigureerd.

Omdat elk bedrijf en elke klant anders is, moet je de trends die ProbHH aan het licht heeft gebracht bekijken en je eigen werkwijze bepalen met betrekking tot welk risiconiveau normaal/aanvaardbaar is. Sommige aanbieders hebben bijvoorbeeld een lagere tolerantie voor klantrisico's en kunnen daarom transacties sneller blokkeren. Hoewel de aard van gokken het praktisch onmogelijk maakt om alle risico's uit te sluiten, is het belangrijk dat uw bedrijf een gezonde balans vindt en de nodige stappen neemt om uw klanten voldoende te beschermen.

  PROBH-verzoek verwerken

  Het PROBH-verzoek wordt gebruikt om een Probability of Harm (ProbH)-controle uit te voeren op de klant die in het verzoek wordt geïdentificeerd.

Om een ProbH controle uit te voeren, moet je systeem een PROBH verzoek indienen en het antwoord interpreteren. Het PROBH-verzoek vereist gegevens die we zullen gebruiken om de klant te identificeren; er zijn drie methoden die we ondersteunen:

  1. Gedeeltelijke PAN - Geef het gemaskeerde kaartnummer van de klant op.
  2. Parent - Dien een verwijzing in naar de kaart van een klant die is opgeslagen op de servers van Trust Payment na een eerder verzoek.
  3. Volledige PAN - Voer het volledige kaartnummer van de klant in.

Zie hieronder voor aanvraagvoorbeelden voor de drie hierboven beschreven methoden:

Gedeeltelijk PAN
Python PHP cURL Ruwe JSON Ruwe XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

probh = {
"accounttypedescription": "HARMDETECTION",
"expirydate": "09/2024",
"maskedpan": "411111######1111",
"requesttypedescription": "PROBH",
"sitereference": "site12346"
}

strequest = securetrading.Request()
strequest.update(probh)
stresponse = st.process(strequest) #stresponse contains the transaction response

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

Ouder
Python PHP cURL Ruwe JSON Ruwe XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

probh = {
"accounttypedescription": "HARMDETECTION",
"parenttransactionreference": "1-2-345",
"requesttypedescription": "PROBH",
"sitereference": "site12346"
}

strequest = securetrading.Request()
strequest.update(probh)
stresponse = st.process(strequest) #stresponse contains the transaction response

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

Volledige PAN
Python PHP cURL Ruwe JSON Ruwe XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

probh = {
"accounttypedescription": "HARMDETECTION",
"expirydate": "09/2024",
"pan": "4111111111111111",
"requesttypedescription": "PROBH",
"sitereference": "site12346"
}

strequest = securetrading.Request()
strequest.update(probh)
stresponse = st.process(strequest) #stresponse contains the transaction response

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

PROBH Verzoek Veldspecificatie
  Veld Formaat Beschrijving
  Verplicht accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Alleen "HARMDETECTION" (e-commerce) wordt ondersteund.
  Verplicht requesttypedescription
XPath: /@type
Alpha (20) De waarde in het verzoek moet "PROBH" zijn.
  Verplicht sitereference
XPath: /operation/sitereference
Alfanumeriek & underscore (50) De site referentie heeft betrekking op uw individuele account die u bij de installatie hebt ontvangen. Als u uw site referentie niet kent, neem dan contact op met ons Support Team.
  Conditioneel currencyiso3a
XPath: /billing/amount/@currencycode
ISO3A

De Munt die hoort bij het baseamount.

Alleen vereist als het baseamount wordt opgegeven.

  Conditioneel expirydate
XPath: /billing/payment/expirydate
Datum MM/JJJJ

De op de kaart gedrukte vervaldatum.

Dit veld is vereist bij het indienen van een volledige of gedeeltelijke PAN om de controles te voltooien.

  Conditioneel maskedpan
XPath: /billing/payment/maskedpan
Alfanumeriek, inclusief "#" (12-19)

Dit is het lange nummer dat op de voorkant van de kaart van de klant staat, gedeeltelijk gemaskeerd met "#"-tekens.

Het veld pan of maskedpan is vereist, tenzij u in plaats daarvan het veld parenttransactionreference opgeeft om eerder opgeslagen betalingsgegevens te gebruiken om de controles te voltooien.

  Conditioneel pan
XPath: /billing/payment/pan
Numeriek (12-19)

Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt.

Het veld pan of maskedpan is vereist, tenzij u in plaats daarvan het veld parenttransactionreference opgeeft om eerder opgeslagen betalingsgegevens te gebruiken om de controles te voltooien.

  Conditioneel parenttransactionreference
XPath: /operation/parenttransactionreference
Alfanumeriek
en koppeltekens (25)

Hiermee kunt u de transactionreference van een eerder verzoek waar de betalingsgegevens van een vorige klant zijn opgeslagen (we noemen dit proces tokenisatie). Dit betekent dat je systeem terugkerende klanten niet hoeft te vragen om hun betalingsgegevens opnieuw in te voeren voordat de ProbHH-controle wordt uitgevoerd.

Dit veld is vereist als de kaartgegevens niet zijn opgenomen in het PROBH-verzoek.

  Optioneel baseamount
XPath: /billing/amount
Numeriek (11) Dit bedrag dat door de klant wordt gestort, wordt opgegeven in basiseenheden, zonder komma's of decimalen, bijv. €10 wordt opgegeven als 1000. Deze waarde moet groter zijn dan nul.
  Optioneel paymenttypedescription
XPath: /billing/payment/@type
Alpha (20)

Het kaarttype van de klant. Deze waarde wordt opgeslagen en getoond in Portal. De volgende waarden kunnen worden opgegeven:

  • DELTA
  • ELECTRON
  • MAESTRO
  • MASTERCARD
  • MASTERCARDDEBIT
  • PURCHASING
  • VISA
  • VPAY

  Behandeling van PROBH-antwoord

Er zijn drie belangrijke resultaten na het indienen van een PROBH-verzoek:

  1. Score - Harm score werd succesvol gegenereerd met recente gegevens en teruggestuurd in het antwoord. De score ligt tussen 0,000 en 1,000.
  2. Geen Score - Er is geen indicatie voor schade door gokken als we kijken naar de gegevens van Trust Payments gokken handelaren en schuldsaneringsbureaus over het afgelopen jaar.
  3. Fout - Het PROBH verzoek is mislukt en er kon geen schadescore worden teruggegeven. U moet de errorcode en errormessage in het antwoord om de oorzaak van de mislukking te achterhalen (bijv. problemen met de syntaxis of ontbreken van verplichte velden in het verzoek).

Zie hieronder voor antwoordvoorbeelden voor alle drie de hierboven beschreven resultaten:

Score
Python PHP Ruwe JSON Ruwe XML
{
'requestreference': 'A0bxh87wt',
'version': '1.00',
'responses': [{
'accounttypedescription': 'HARMDETECTION',
'acquirerresponsemessage': 'OK',
'baseamount': '1050',
'currencyiso3a': 'GBP',
'errorcode': '0',
'errormessage': 'Ok',
'harmscore': '0.59',
'harmscoreforecast': '0',
'livestatus': '1',
'maskedpan': '411111######1111',
'merchantname': 'My Shop',
'merchantnumber': '1234567890',
'operatorname': 'webservices@example.com',
'paymenttypedescription': 'VISA',
'requesttypedescription': 'PROBH',
'settleduedate': '2023-05-25',
'settlestatus': '0',
'transactionreference': '1-2-345',
'transactionstartedtimestamp': '2023-05-25 12:16:53'
}]
}

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

Geen score
Python PHP Ruwe JSON Ruwe XML
{
'requestreference': 'A0bxh87wt',
'version': '1.00',
'responses': [{
'accounttypedescription': 'HARMDETECTION',
'acquirerresponsemessage': 'NOT_FOUND',
'baseamount': '1050',
'currencyiso3a': 'GBP',
'errorcode': '0',
'errormessage': 'Ok',
'harmscoreforecast': '0',
'livestatus': '1',
'maskedpan': '411111######1111',
'merchantname': 'My Shop',
'merchantnumber': '1234567890',
'operatorname': 'webservices@example.com',
'paymenttypedescription': 'VISA',
'requesttypedescription': 'PROBH',
'settleduedate': '2023-05-25',
'settlestatus': '0',
'transactionreference': '1-2-345',
'transactionstartedtimestamp': '2023-05-25 12:16:53'
}]
}

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

Fout geretourneerd
Python PHP Ruwe JSON Ruwe XML
{
'requestreference': 'A0bxh87wt',
'version': '1.00',
'responses': [{
'accounttypedescription': 'HARMDETECTION',
'baseamount': '1050',
'currencyiso3a': 'GBP',
'errorcode': '60010',
'errormessage': 'Bank System Error',
'livestatus': '1',
'maskedpan': '411111######1111',
'merchantname': 'My Shop',
'merchantnumber': '1234567890',
'operatorname': 'webservices@example.com',
'paymenttypedescription': 'VISA',
'requesttypedescription': 'PROBH',
'settleduedate': '2023-05-25',
'settlestatus': '0',
'transactionreference': '1-2-345',
'transactionstartedtimestamp': '2023-05-25 12:16:53'
}]
}

Vervang <DOMAIN> met een ondersteund domein. Klik hier voor een volledige lijst.

PROBH Antwoordveldspecificatie
  Veld Formaat Beschrijving
  Geretourneerd accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) "HARMDETECTION" wordt geretourneerd in het antwoord.
  Geretourneerd baseamount
XPath: /billing/amount
Numeriek (13) Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus £10 wordt weergegeven als 1000.
  Geretourneerd currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

  Geretourneerd errorcode
XPath: /error/code
Numeriek (1-5) De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
  • Als de foutcode "0" is, is de transactie geslaagd.
  • Als de foutcode niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode berichtwaarden.

  Geretourneerd errormessage
XPath: /error/message
Alfanumeriek (255) Dit geeft een korte uitleg over de oorzaak van de fout.

Voor succesvolle transacties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errormessage waarden.

  Geretourneerd livestatus
XPath: /live
Numeriek (1)
  • 0 - Aanvraag verwerkt met een testaccount.
  • 1 - Aanvraag verwerkt met een live account.
  Geretourneerd maskedpan
XPath: /billing/payment/pan
Alfanumeriek, inclusief "#" (12-19)

Het gemaskeerde kaartnummer van de klant. Het grootste deel van het nummer is opzettelijk verborgen door "#" tekens, bijv. 411111######0211.

  Geretourneerd merchantname
XPath: /merchant/merchantname
Alfanumeriek (255) De Naam verkoper verbonden aan de rekening die gebruikt wordt om de transactie te verwerken. Verstrekt door de overnemende bank.
  Geretourneerd merchantnumber
XPath: /merchant/merchantnumber
Alfanumeriek (32) Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank.
  Geretourneerd operatorname
XPath: /merchant/operatorname
Alfanumeriek (255) De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
  Geretourneerd paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Betalingsmethode (bijv. "VISA" of "MASTERCARD").
  Geretourneerd requesttypedescription
XPath: /@type
Alpha (20) "PROBH" wordt teruggestuurd in het antwoord.
  Geretourneerd settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-DD De datum waarop de transactie zal worden afgewikkeld.
  Geretourneerd settlestatus
XPath: /settlement/settlestatus
Numeriek (3)

De Status betaling.

  Geretourneerd transactionreference
XPath: /transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor het verzoek, toegewezen door Trust Payments.
  Geretourneerd transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop het verzoek is verwerkt.
  Conditioneel acquirerresponsecode
XPath: /acquirerresponsecode
Alfanumeriek (255)

Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven.


Wordt alleen geretourneerd na succesvolle verzoeken.

  Conditioneel harmscore
XPath: /harmscore
Numeriek (4)

Een score tussen 0 en 100%, in het PROBH-antwoord weergegeven als een decimaal tussen 0 en 1,0.

Een waarde in de buurt van 0% suggereert een zeer laag risico voor de klant en een waarde in de buurt van 100% suggereert een zeer hoog risico.

Je kunt deze schadescore gebruiken als hulpmiddel om beter geïnformeerde beslissingen te nemen om je klanten te beschermen tegen schadelijk gokgedrag.


Als de harmscore niet wordt geretourneerd, suggereert dit twee mogelijkheden:

  1. We hebben niet genoeg informatie om een betrouwbare schadescore voor deze klant te genereren. Dit komt meestal omdat ze weinig of geen geschiedenis hebben van gokken of schuldsanering in het afgelopen jaar. In dit scenario wordt de errorcode teruggestuurd 0 (wat wijst op succes) en de acquirerresponsecode is "NOT_FOUND".
  2. Als er een fout is opgetreden, wordt de errorcode NIET 0 zijn. Controleer in dit scenario de errorcode en errormessage met onze volledige lijst en reageer dienovereenkomstig.
  Conditioneel harmscoreforecast
XPath: /harmscoreforecast
Numeriek (1)

Als recent gokgedrag niet beschikbaar is voor de klant, kijken we verder terug in hun gokgeschiedenis en halen in plaats daarvan een schadescore op die we in het verleden hebben gegenereerd (als er een kan worden gevonden). We verlagen de schadescores kunstmatig om te zorgen dat statistieken die ooit een hoge schadescore genereerden, na verloop van tijd minder invloedrijk worden.

Er kunnen twee waarden worden geretourneerd:

  • "1" (Ja) - De geretourneerde schadescore is niet recentelijk gegenereerd en is daarom verlaagd om dit weer te geven.
  • "0" (Nee) - Harm score is recent gegenereerd en wordt daarom ongewijzigd geretourneerd.

Wordt niet geretourneerd als er een fout is opgetreden.

  Conditioneel errordata
XPath: /error/data
Alfanumeriek (255)

Aanvullende informatie om te helpen bij het oplossen van de fout.


Wordt alleen geretourneerd als er een fout is opgetreden.

 

Terug: Inleiding Volgende: Schadescores bijhouden

Was dit artikel nuttig?
0 van de 0 vonden dit nuttig