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 kent, neem dan contact op met ons Support Team.
Verplicht	currencyiso3a	Alpha (3)	De Munt waarin de transactie zal worden verwerkt, in 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 styling te specificeren die wordt gebruikt om de Payment Pages weer te geven. Wanneer het standaard uiterlijk wordt gebruikt, wordt dit ingesteld op "default". Klik hier voor meer informatie.
Verplicht	sitesecurity	Site beveiliging hash	Gebruikt om de beveiligingshash van de aanvraagsite in de POST in te dienen.

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 voor het factuuradres ingevoerde land, in ISO2A-formaat.
Conditioneel	billingemail	E-mail (255)	Het adres E-mailadres facturatie . Dit kan dan worden gebruikt voor correspondentie met de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-teken). Vereist voor Visa Secure Data Field Mandate wanneer billingtelephone niet is voorzien.
Conditioneel	billingtelephone	Alfanumeriek, inclusief symbolen (20)	Het telefoonnummer voor de facturering. Geldige tekens: Cijfers 0-9 Ruimtes Speciale tekens: + - ( ) Vereist voor Visa Secure Data Field Mandate wanneer billingemail niet is voorzien.
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 ingevoerde land voor het adres van de klant, in ISO2A-formaat. Vereist als Klant Categorie Code (MCC) 6012 is.
Optioneel	customeremail	E-mail (255)	Het e-mailadres van de klant. Dit kan dan worden gebruikt voor correspondentie met de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-symbool).
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) Dien "100" in om de transactie onmiddellijk te vereffenen na autorisatie. Neem contact op met het Support Team 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 status van de transactie. afwikkeling status kan worden geregeld met behulp van settlestatus en settleduedate. Klik hier voor meer informatie over het afwikkeling proces.
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. Klik hier voor meer informatie.
Conditioneel	dcctype	Alpha (3)	Vereist bij het uitvoeren van DCC transacties. Klik hier voor 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 Klik hier voor meer informatie over dit gebied.
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. Wanneer u de orderreference op te nemen in de hash voor de beveiliging van uw site, 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 uw site security hash bij te werken om dit veld op te nemen, door contact op te nemen met ons Support Team.
Optioneel	paymenttypedescription	Alpha (20)	Hiermee kunt u de betalingsmethode voor de transactie kiezen wanneer u Reis B gebruikt.
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)	Gebruikt om 3-D Secure authenticatie te omzeilen in bepaalde scenario's waar dit is toegestaan. Onderhevig aan voorwaarden - klik hier voor meer informatie. Opmerking: Alleen ondersteund door bepaalde acquiring banks. Neem contact op met ons Support Team 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"

Klik hier voor meer informatie.

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 je gebruikmaakt van de PayPal-functionaliteit om het adres te overschrijven, zijn in bepaalde scenario's mogelijk andere bezorgingsvelden vereist. Klik hier voor meer informatie.
Optioneel	paypallocaleiso2a	Alpha (2)	Gebruik dit veld om de inhoud van de PayPal kassa te lokaliseren. Voor een volledige lijst van ondersteunde waarden die in dit veld kunnen worden opgegeven (bijv. paypallocaleiso2a=GB voor het VK), raadpleeg PayPal 's documentatie (link naar externe site).

Regelvelden

	Veld	Formaat	Beschrijving
Optioneel	allurlnotification	URL Domein max lengte 75	Dit is de URL waarnaar de melding wordt gestuurd na een verzoek, wanneer STR-10 is ingeschakeld.
Optioneel	declinedurlredirect	URL Domein max lengte 75	Dit is de URL waarnaar de browser van de klant wordt omgeleid na een geweigerde transactie, wanneer STR-7 is ingeschakeld.
Optioneel	declinedurlnotification	URL Domein max lengte 75	Dit is de URL waarnaar de melding wordt gestuurd na een geweigerde transactie, wanneer STR-9 is ingeschakeld.
Optioneel	ruleidentifier	Alfanumeriek en koppeltekens	Gebruikt om regels per verzoek in te schakelen (Meerdere velden ondersteund).
Optioneel	stextraurlredirectfields	Alpha	Dit wordt gebruikt om extra velden op te nemen in redirects.
Optioneel	stextraurlnotifyfields	Alpha	Dit wordt gebruikt om extra velden op te nemen in URL-kennisgevingen.
Optioneel	successfulurlredirect	URL Domein max lengte 75	Dit is de URL waarnaar de browser van de klant wordt doorgestuurd na een succesvolle transactie, wanneer STR-6 is ingeschakeld.
Optioneel	successfulurlnotification	URL Domein max lengte 75	Dit is de URL waarnaar de melding wordt gestuurd na een geslaagde 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 Andere P Store Pickup T 2 dagen Service W 3 daagse 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 in het formaat JJJJ-MM-DD zijn. 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 automatisch met waarde 0 of 1 in te dienen bij elke transactie. (U kunt contact opnemen met ons Support Team om deze wijziging door te voeren) Vereist indien aan de hierboven beschreven aflossings- en andere voorwaarden is voldaan.