Payment Pages veldspecificatie - Trust Payments

De volgende velden kunnen worden opgenomen in de POST van uw website naar Payment Pages.

Vereisten:

Alle veldnamen moeten in kleine letters worden ingediend.
Dien niet meerdere velden met dezelfde naam in een enkele POST in, tenzij in de documentatie staat dat dit is toegestaan.
Wij bevelen aan dat de ingediende tekst wordt gecodeerd in UTF-8.
Speciale tekens moeten worden gecodeerd voor de URL (bv. "&" moet worden ingediend als "%26").

Verplichte velden

De volgende velden zijn vereist in elke POST naar Payment Pages:

Neem, naast het doornemen van de hieronder aangegeven verplichte velden, ook de tijd om alle secties van dit artikel te bekijken voor de velden die als Voorwaardelijk zijn aangeduid. Deze velden kunnen vereist zijn, afhankelijk van je instellingen.

	Veld	Formaat	Beschrijving
Verplicht	sitereference	Alfanumeriek & underscore (50)	Identificeert uw site op het Trust Payments systeem. Als u uw site referentie niet weet, neem dan contact op met ons ondersteuningsteam.
Verplicht	currencyiso3a	Alpha (3)	De Munt de transactie zal worden verwerkt, met gebruikmaking van ISO3A-formaat.
Verplicht	mainamount	Numeriek (14)	Het bedrag van de transactie in hoofdeenheden. Vermeld alleen de waarde van het bedrag en het decimaalteken (geen komma's). Bijv. €10,99 wordt ingediend als 10.99. Valuta's zoals Japanse Yen die geen decimaal nodig hebben, worden zonder decimaal weergegeven. Bijvoorbeeld 1000 Yen is 1000.
Verplicht	version	Numeriek (1)	Deze waarde wordt ingesteld op 2.
Verplicht	stprofile	Alfanumeriek (20) Alleen kleine letters. Leestekens en spaties zijn niet toegestaan.	Wordt gebruikt om de stijl te specificeren die wordt gebruikt voor het weergeven van de Payment Pages. Bij gebruik van de standaardweergave is dit ingesteld op 'default'. Meer informatie over het aanpassen van de weergave.
Verplicht	sitesecurity	Site beveiliging hash	Gebruikt om de verzoek sitebeveiliging hash in de POST.

Factuurvelden

U kunt ook de volgende factureringsvelden in de POST invoeren:

Als een ingediend factureringsveld langer is dan de maximaal toegestane lengte (zoals aangegeven in de onderstaande tabel), wordt een veldfout geretourneerd (errorcode 30000).

	Veld	Formaat	Beschrijving
Optioneel	billingprefixname	Alfanumeriek, inclusief symbolen (25)	Het voorvoegsel voor de factuurnaam, uit de volgende lijst: De heer, De heren, Juffrouw, Dr., Mw, Prof., Eerw., Dhr., Heer, Dame & Mx.
Conditioneel	billingfirstname	Alfanumeriek, inclusief symbolen (127)	De Voornaam facturatie. Vereist voor Visa Secure Data Field Mandate. Vereist voor handelaren in kansspelen.
Optioneel	billingmiddlename	Alfanumeriek, inclusief symbolen (127)	De facturatie middelste naam.
Conditioneel	billinglastname	Alfanumeriek, inclusief symbolen (127)	De Achternaam facturatie. Vereist voor Visa Secure Data Field Mandate. Vereist voor handelaren in kansspelen.
Optioneel	billingpremise	Alfanumeriek, inclusief symbolen (25)	Het huisnummer of de eerste regel van het factuuradres.
Optioneel	billingstreet	Alfanumeriek, inclusief symbolen (127)	De ingevoerde straat voor het factuuradres.
Optioneel	billingtown	Alfanumeriek, inclusief symbolen (127)	De stad die is ingevoerd voor het factuuradres.
Optioneel	billingcounty	Alfanumeriek, inclusief symbolen (127)	De provincie die is ingevoerd voor het factuuradres. Dit wordt weergegeven als "State code (eg. NY)” op pagina's met "us_US" locale. Voor Amerikaanse adressen wordt de staat in dit veld ingevuld. Geldige formaten: Voorkeur: Staatcode van twee tekens, bijvoorbeeld "NY". Volledige naam van de staat (geen afkortingen), bijvoorbeeld "New York".
Optioneel	billingpostcode	Alfanumeriek (25)	De Postcode facturatie of postcode. Dit moet een geldige postcode zijn voor de billingcountryiso2a ingediend.
Optioneel	billingcountryiso2a	Alpha (2)	Het land dat is ingevoerd voor het factuuradres, met behulp van ISO2A-formaat.
Conditioneel	billingemail	E-mail (255)	Het E-mailadres facturatie wordt gebruikt voor correspondentie met de klant. Toegestane tekens: Letters A-Z, a-z Cijfers 0-9 Algemene speciale tekens (behalve ) Max. lengte 64 voor de @ en 255 in totaal. Naast de hierboven genoemde vereisten voldoet ons systeem aan RFC 5322, waarin het standaardformaat voor geldige e-mailadressen wordt gedefinieerd. Meer informatie over RFC 5322 (link naar externe site) Vereist voor Visa Data Field Mandate* wanneer billingtelephone niet billingtelephone verstrekt.
Conditioneel	billingtelephone	Alfanumeriek, inclusief symbolen (20)	Het telefoonnummer voor de facturering. Geldige tekens: Cijfers 0-9 Ruimtes Speciale tekens: + - ( ) Vereist voor Visa Data Field Mandate wanneer billingemail niet billingemail opgegeven.
Optioneel	billingtelephonetype	Char (1)	Het ingevoerde type telefoonnummer. De beschikbare opties zijn: H = Thuis M = Mobiel W = Werk

Velden van klanten

U kunt ook gegevens verstrekken met betrekking tot een extra adres van de klant. Dit betreft meestal het afleveradres. Deze velden zijn hieronder opgenomen:

Als een ingediend klantveld langer is dan de maximaal toegestane lengte (zoals gedocumenteerd in de onderstaande tabel), wordt een veldfout geretourneerd (errorcode 30000).

	Veld	Formaat	Beschrijving
Optioneel	customerprefixname	Alfanumeriek, inclusief symbolen (25)	Het voorvoegsel van de klantnaam, uit de volgende lijst: De heer, De heren, Juffrouw, Dr., Mw, Prof., Eerw., Dhr., Lord, Dame & Mx.
Optioneel	customerfirstname	Alfanumeriek, inclusief symbolen (127)	De voornaam van de klant.
Optioneel	customermiddlename	Alfanumeriek, inclusief symbolen (127)	De middelste naam van de klant.
Optioneel	customerlastname	Alfanumeriek, inclusief symbolen (127)	De achternaam van de klant.
Optioneel	customerpremise	Alfanumeriek, inclusief symbolen (25)	Het huisnummer of de eerste regel van het adres van de klant.
Optioneel	customerstreet	Alfanumeriek, inclusief symbolen (127)	De ingevoerde straat voor het adres van de klant.
Optioneel	customertown	Alfanumeriek, inclusief symbolen (127)	De ingevoerde stad voor het adres van de klant.
Optioneel	customercounty	Alfanumeriek, inclusief symbolen (127)	De provincie die is ingevoerd voor het adres van de klant. Dit wordt weergegeven als "State code (eg. NY)” op pagina's met "us_US" locale. Voor Amerikaanse adressen wordt de staat in dit veld ingevuld. Geldige formaten: Voorkeur: Staatcode van twee tekens, bijvoorbeeld "NY". Volledige naam van de staat (geen afkortingen), bijvoorbeeld "New York".
Conditioneel	customerpostcode	Alfanumeriek (25)	De postcode van de klant. Dit moet een geldige postcode zijn voor de customercountryiso2a ingediend. Vereist als Klant Categorie Code (MCC) 6012 is.
Conditioneel	customercountryiso2a	Alpha (2)	Het land ingevoerd voor het adres van de klant, met behulp van ISO2A-formaat. Vereist als Klant Categorie Code (MCC) 6012 is.
Optioneel	customeremail	E-mail (255)	Het e-mailadres van de klant. Geldige tekens: Letters A-Z, a-z Cijfers 0-9 Algemene speciale tekens (behalve *) Max. lengte 64 voor de @ en 255 in totaal. Naast de hierboven genoemde vereisten voldoet ons systeem aan RFC 5322, waarin het standaardformaat voor geldige e-mailadressen wordt gedefinieerd. Meer informatie over RFC 5322 (link naar externe site)
Optioneel	customertelephone	Alfanumeriek, inclusief symbolen (20)	Het telefoonnummer van de klant. Geldige tekens: Cijfers 0-9 Ruimtes Speciale tekens: + - ( )
Optioneel	customertelephonetype	Char (1)	Het ingevoerde type telefoonnummer. De beschikbare opties zijn: H = Thuis M = Mobiel W = Werk

afwikkeling velden

Je kunt de volgende optionele velden opnemen in de POST om afwikkeling te beïnvloeden.

Veld

Formaat

Beschrijving

Optioneel

settleduedate

Datum JJJJ-MM-DD

Gebruik dit veld om afwikkeling uit te stellen tot de opgegeven datum (in het formaat JJJJ-MM-DD).
(in het formaat JJJJ-MM-DD).

Optioneel

settlestatus

Numeriek (3)

Laat leeg of geef "0" op om te kiezen voor standaard afwikkeling gedrag.

Vul "1" in om Fraude- en Duplicaatcontroles op te heffen, als deze op uw rekening zijn ingeschakeld.

Voer "2" in om afwikkeling handmatig op te schorten. De transactie blijft opgeschort totdat u de Status betaling op een later tijdstip bijwerkt met Portal.

(Alleen ondersteund door bepaalde acquirers)Voer '100' in om de transactie onmiddellijk na autorisatie af te wikkelen. Neem contact op met het ondersteuningsteam om te controleren of uw acquirer dit ondersteunt.

Charset

Om gegevens te kunnen verzenden, codeert de browser van de klant ze met een tekencodering. Onze servers moeten deze codering (of charset) kennen om de gegevens correct te kunnen decoderen. Veel browsers verstrekken deze informatie niet, in welk geval wij aannemen dat de tekencodering ISO-8859-1 is. Dit is compatibel met alle browsers, maar kan ertoe leiden dat sommige tekens (vooral niet-westerse tekens) onjuist worden geïnterpreteerd.

U kunt de browser vertellen de juiste charset op te geven door een verborgen veld "_charset_" op te nemen in uw HTML-formulier. Browsers zullen de waarde van dit veld automatisch vullen met de charset die ze gebruiken, zodat het niet nodig is om bijvoorbeeld een waarde voor dit veld op te geven:

<INPUT TYPE=hidden NAME="_charset_" />

Aanvraag velden

	Veld	Formaat	Beschrijving
Optioneel	authmethod	Alpha (11)	Om de standaard auth-methode voor uw account handmatig op te heffen. Ondersteunde waarden zijn: "PRE" - Her-autorisatie "FINAL" - Definitieve authorisatie De inhoud van authmethod heeft geen invloed op de afwikkeling van de transactie. afwikkeling kan worden beheerd met behulp van settlestatus en settleduedate. Meer informatie over het afwikkeling .
Conditioneel	credentialsonfile	Numeriek (1)	Vereist bij het opslaan van betalingsgegevens voor toekomstige transacties. Voor klanten die voor de eerste keer een transactie op uw site uitvoeren, moet u credentialsonfile=1 opnemen als de betalingsgegevens moeten worden opgeslagen voor toekomstige transacties. Meer informatie over Gevevens in Bestand.
Conditioneel	dcctype	Alpha (3)	Vereist bij het uitvoeren van DCC transacties. Meer informatie over DCC.
Optioneel	locale	Alfanumeriek met inbegrip van underscores (5)	Standaard wordt Payment Pages in het Engels aan de klant getoond, tenzij dit met de onderstaande waarden wordt opgeheven: cy_GB = Welsh, Verenigd Koninkrijk da_DK = Deens, Denemarken de_DE = Duits, Duitsland en_US = Engels, Verenigde Staten en_GB = Engels, Verenigd Koninkrijk es_ES = Spaans, Spanje fr_FR = Frans, Frankrijk it_IT = Italiaans, Italië nl_NL = Nederlands, Nederland no_NO = Noors, Noorwegen sv_SE = Zweeds, Zweden Meer informatie over lokalisatie.
Optioneel	orderreference	Alfanumeriek, inclusief symbolen (25) Aanbevolen lengte 25 tekens of minder (exacte lengte afhankelijk van wervende bank). Niet-naleving van dit voorschrift kan ertoe leiden dat de tekst in de transactie wordt ingekort.	Uw eigen referentie voor de transactie. Dit kan nuttig zijn bij het koppelen van transacties aan orders binnen uw systeem. Bij het opnemen van de orderreference op te nemen in uw sitebeveiligingshash, worden alleen alfanumerieke tekens en de volgende speciale tekens ondersteund: ~ ! # $ % ^ & * ( ) _ { } [ ] < > , ?
Optioneel	operatorname	Alfanumeriek (255)	Je kunt dit veld gebruiken om de naam vast te leggen van de operator die de betaling uitvoert via Payment Pages. Dit wordt opgeslagen in onze records en kan later worden bekeken in Portal. Indien deze waarde niet in de POST wordt opgegeven, wordt deze standaardwaarde "paymentpages". Deze waarde wordt niet weergegeven op de Payment Pages (mits het rekeningtype "ECOM" is). Als u ervoor kiest om de operatorname, raden wij u aan de beveiligingshash van uw site bij te werken aan te passen zodat dit veld wordt opgenomen, door contact op te nemen met ons ondersteuningsteam.
Optioneel	paymenttypedescription	Alpha (20)	Hiermee kunt u de betaalmethode voor de transactie kiezen wanneer u gebruikmaakt van Journey B.
Optioneel	requesttypedescriptions	Alpha (20)	Wordt gebruikt om verzoektypes te specificeren die moeten worden verwerkt wanneer Geavanceerd Bericht is ingeschakeld op uw account.
Optioneel	scaexemptionindicator	Numeriek (1)	Wordt gebruikt om 3-D Secure te omzeilen in bepaalde scenario's waarin dit is toegestaan. Onder voorbehoud van voorwaarden – lees meer over SCA . Opmerking: Alleen ondersteund door bepaalde acquirerende banken. Neem contact op met ons ondersteuningsteam voor meer informatie. Neem contact op met uw acquiring bank en controleer of u vrijstellingen mag toepassen voordat u uw verzoeken daartoe aanpast. Geef een van de volgende waarden op: 1 - Lage waarde 2 - Transactierisicoanalyse 3 - Vertrouwde handelaar 4 - Beveiligde zakelijke betaling 5 - Gedelegeerde authenticatie

Aangepaste velden

U kunt aangepaste velden doorgeven in uw POST. De veldnamen hoeven geen specifiek geval te zijn en worden niet opgeslagen in de database. Er is geen extra configuratie nodig.

Aangepaste velden kunnen worden teruggestuurd naar je systeem nadat een transactie is verwerkt, door ze op te nemen in een omleiding en/of door een URL-kennisgeving te configureren.

Hoewel voor aangepaste velden geen specificatie van geldige waarden bestaat, is het belangrijk ervoor te zorgen dat de waarde niet kan worden gekaapt als onderdeel van een kwaadaardige aanval. Waar mogelijk bevelen wij het volgende aan:

Gebruik waar mogelijk standaardletters en -cijfers binnen de ASCII-tekenset zonder speciale tekens, vooral bij de veldnamen.
Bestandsverwijzingen die u definieert, moeten een volledig pad gebruiken in plaats van een relatief pad.
Houd de velden en waarden zo kort mogelijk.

Aanvullende overwegingen

De maximaal toegestane lengte van aangepaste veldnamen die kunnen worden ingediend is 100 tekens. Aangepaste veldnamen die deze limiet overschrijden, worden afgekapt of veroorzaken een fout.
Veldnamen mogen niet eindigen op "_html".

Aanpassingsvelden

Veld

Formaat

Beschrijving

Optioneel

stdefaultprofile

Alfa en onderstrepingen (20)

Ondersteunde waarden:

"st_paymentcardonly"
"st_cardonly"
"st_iframe_cardonly"

Leer hoe u de lay-out kunt wijzigen.

Conditioneel

strequiredfields

Alpha

Geef aan welke velden de klant moet invoeren (meerdere velden ondersteund).

Vereist voor Visa Secure Data Field Mandate.

Meer informatie over het mandaat Meer informatie over strequiredfields

Apple Pay velden

U kunt de volgende optionele velden in uw POST invoeren om te wijzigen hoe de klant om zijn adresgegevens wordt gevraagd op de Payment Pages:

Veld

Formaat

Beschrijving

Optioneel

billingcontactdetailsoverride

Numeriek (1)

Het factuuradres voor de betaling:

"0" - Gebruikt gegevens die zijn ingevoerd (of gepost) op de Payment Pages.
"1" - Gebruikt gegevens die zijn opgegeven op de Apple Pay account van de klant.

Indien dit niet wordt ingevuld, wordt het op Payment Pages ingevoerde (of geposte) adres gebruikt.

Optioneel

customercontactdetailsoverride

Numeriek (1)

Het (leverings)adres van de klant voor de betaling:

"0" - Gebruikt gegevens die zijn ingevoerd (of gepost) op de Payment Pages.
"1" - Gebruikt gegevens die zijn opgegeven op de Apple Pay account van de klant.

Indien dit niet wordt ingevuld, wordt het op Payment Pages ingevoerde (of geposte) adres gebruikt.

PayPal-velden

	Veld	Formaat	Beschrijving
Optioneel	paypaladdressoverride	Numeriek (1)	Geef aan hoe het afleveradres wordt ingevoerd bij het verwerken van betalingen met PayPal. Wanneer u gebruikmaakt van de functie voor het overschrijven van het PayPal-adres, kunnen in bepaalde scenario's andere aflevervelden vereist zijn. Bekijk onze PayPal-documentatie.
Optioneel	paypallocaleiso2a	Alpha (2)	Gebruik dit veld om de inhoud die wordt weergegeven bij het afrekenen via PayPal te lokaliseren. Voor een volledige lijst met ondersteunde waarden die in dit veld kunnen worden ingevuld (bijv. paypallocaleiso2a=GB voor het Verenigd Koninkrijk), raadpleeg je de documentatie van PayPal (link naar externe site).

Regelvelden

	Veld	Formaat	Beschrijving
Optioneel	allurlnotification	URL Maximale lengte domein 75	Dit is de URL van de melding wordt verzonden na elk verzoek, wanneer STR-10 is ingeschakeld.
Optioneel	declinedurlredirect	URL Maximale lengte domein 75	Dit is de URL waarnaar de browser van de klant wordt doorverwezen na een geweigerde transactie, wanneer STR-7 is ingeschakeld.
Optioneel	declinedurlnotification	URL Maximale lengte domein 75	Dit is de URL van de melding wordt verzonden na een geweigerde transactie, wanneer STR-9 is ingeschakeld.
Optioneel	ruleidentifier	Alfanumeriek en koppeltekens	Gebruikt om regels per verzoek in te schakelen (meerdere velden worden ondersteund).
Optioneel	stextraurlredirectfields	Alpha	Dit wordt gebruikt om extra velden op te nemen in omleidingen.
Optioneel	stextraurlnotifyfields	Alpha	Dit wordt gebruikt om extra velden op te nemen in URL-meldingen meldingen.
Optioneel	successfulurlredirect	URL Maximale lengte domein 75	Dit is de URL waarnaar de browser van de klant wordt omgeleid na een succesvolle transactie, wanneer STR-6 is ingeschakeld.
Optioneel	successfulurlnotification	URL Maximale lengte domein 75	Dit is de URL van de melding wordt verzonden na een succesvolle transactie, wanneer STR-8 is ingeschakeld.

Protect Plus velden

De volgende optionele velden kunnen op de Payment Pages worden geplaatst om de Protect Plus controles:

Veld

Formaat

Beschrijving

Optioneel

billingdob

Datum JJJJ-MM-DD

De geboortedatum van de klant. Moet in het formaat JJJJ-MM-DD staan.

Optioneel

customershippingmethod

Char (1)

De verzendmethode. Kan een van de volgende waarden zijn:

C Lage kosten
D Aangewezen door Klant
I Internationaal
Militairen
N Volgende dag/nacht
O Overige
P Afhalen in winkel
T 2 dagen service
W 3 dagen service

Klant Categorie Code (MCC) 6012 velden

Visa en Mastercard hebben alle in het VK gevestigde verkopers met een Klant Categorie Code (MCC) van 6012 verplicht om de aanvullende velden te versturen. Als deze velden niet worden meegestuurd, kan de klant een ongeldige aanvraagfout te zien krijgen.

Meer informatie over MCC 6012

Velden voor schuldaflossing

Visa en Mastercard hebben alle handelaren die schuldaflossingen verwerken opgedragen de volgende velden in de POST in te dienen (wanneer de gegevens beschikbaar zijn gesteld).

Dit mandaat is van toepassing op handelaren met een Trust Payments acquiring account. Als u een andere acquiring bank gebruikt, moet u contact opnemen met ons Support Team om na te gaan of dit mandaat van toepassing is op uw oplossing.

Vereiste: Uw Klant Categorie Code moet ofwel 6012, 6051 of 7299 zijn.

Uw Klant Categorie Code (MCC) is een viercijferig nummer dat u is toegewezen door uw koper. Het wordt gebruikt om het bedrijf te classificeren aan de hand van het type producten of diensten dat het levert. Als u niet zeker bent van de waarde van uw Klant Categorie Code, neem dan contact op met ons ondersteuningsteam.

	Veld	Formaat	Beschrijving
Conditioneel	customeraccountnumbertype	Alfa (7)	Ofwel "CARD" of "ACCOUNT". Vereist indien aan de hierboven beschreven aflossings- en andere voorwaarden is voldaan.
Conditioneel	customeraccountnumber	Numeriek (20)	Indien het type rekeningnummer "ACCOUNT" is, het rekeningnummer van de rekeninghouder. Indien het type rekeningnummer "CARD" is, het kaartnummer van de rekeninghouder. Vereist indien aan de hierboven beschreven aflossings- en andere voorwaarden is voldaan.
Conditioneel	customerdob	Datum JJJJ-MM-DD	De geboortedatum van de rekeninghouder. Moet worden opgegeven in het formaat JJJJ-MM-DD. Vereist indien aan de hierboven beschreven aflossings- en andere voorwaarden is voldaan.
Conditioneel	customerlastname	Alfanumeriek inclusief symbolen (127)	De achternaam van de rekeninghouder. Vereist indien aan de hierboven beschreven aflossings- en andere voorwaarden is voldaan.
Conditioneel	customerpostcode	Alfanumeriek (25)	De postcode van de rekeninghouder. Vereist indien aan de hierboven beschreven aflossings- en andere voorwaarden is voldaan.
Conditioneel	debtrepayment	Numeriek (1)	Geeft aan of de transactie is gemarkeerd als schuldaflossing: 1 - Transactie is gemarkeerd als schuldaflossing. 0 - Transactie is niet gemarkeerd als schuldaflossing. Opmerking: Uw site kan worden geconfigureerd om deze vlag standaard bij elke transactie automatisch in te dienen met waarde 0 of 1. (U kunt contact opnemen met ons ondersteuningsteam om deze wijziging door te voeren) Vereist indien aan de hierboven beschreven aflossings- en andere voorwaarden is voldaan.