De volgende inhoud gaat ervan uit dat u de noodzakelijke PCI-certificering hebt verkregen om gevoelige kaarthoudergegevens te verwerken en in te dienen in het verzoek aan onze Webservices API.
Lees dit artikel voor meer informatie.
Alle bedrijven binnen de EER (Europese Economische Ruimte) zijn verplicht om 3-D Secure te gebruiken bij het verwerken van e-commercetransacties, als onderdeel van het PSD2 -mandaat.
Handelaren die e-commercetransacties verwerken MOETEN 3DS-verificatie ondersteunen. Klik hier voor meer informatie.
De volgende inhoud mag alleen worden gebruikt door merchants die Mail Order Telephone Order (MOTO) betalingen verwerken of andere workflows die zijn vrijgesteld van het PSD2 mandaat.
Voor de PAN_ONLY authmethod hieronder beschreven vereist 3DS-authenticatie.
In dit document wordt ervan uitgegaan dat je een directe integratie met Google Pay hebt geconfigureerd en de richtlijnen van Google hebt gevolgd voor het gebruik van het Google Pay betalingstoken payload (link naar externe site) en dat je de TRU Connect gateway wilt gebruiken om de betaling te verwerken.
Over verificatiemethoden
Elke Google Pay transactie kan op twee verschillende manieren worden geverifieerd:
- PAN_ONLY - Een kaart die is opgeslagen op het Google-account van de klant.
- CRYPTOGRAM_3DS - Een apparaattoken opgeslagen op een Android-gevoed apparaat dat is geverifieerd met een 3-D Secure cryptogram.
Als je Google Pay integratie is geconfigureerd om zowel PAN_ONLY als CRYPTOGRAM_3DS authenticatiemethoden te ondersteunen , moet je voor elke transactie vaststellen welke van deze twee authenticatiemethoden is uitgevoerd. Dit is belangrijk omdat de authenticatiemethode die wordt geretourneerd door de Google Pay API de volgende stappen dicteert die je systeem moet uitvoeren om de betaling te voltooien.
Om de authenticatiemethode te controleren die is gebruikt voor een bepaalde transactie, moet je de versleuteldeBoodschap ontsleutelen die is teruggestuurd in het betalingstoken van de Google Pay API. Specifiek moet u kijken naar het veld paymentMethodDetails > authMethod en controleren of de waarde PAN _ONLY of CRYPTOGRAM_3DS is.
Als PAN_ONLY wordt geretourneerd in de authMethodmoet u de transactie eerst verifiëren met 3-D Secure. Als de kaart is geregistreerd en met succes is geverifieerd, beschikt u over de onderstaande velden, die vereist zijn in het AUTH verzoek:
Resultaatgegevens van 3-D Secure provider:
- cavv
- eci
- ingeschreven
- status
- threedversion
- threeddirectorytransactionreference
Velden moeten worden ingediend in AUTH indien beschikbaar.
Betalingsgegevens van het antwoord op Google Pay :
-
pan
Afgebeeld van:
encryptedMessage ≫ paymentMethodDetails ≫ pan -
expirydate
Afgedrukt van:
encryptedMessage ≫ paymentMethodDetails ≫ expirationMonth/expirationYear -
walletdisplayname
Afgebeeld van:
paymentMethodData ≫ info
Als je van plan bent om de factuur- en aflevergegevens van de klant van hun Google Wallet vast te leggen, moet je ook de respons van de Google API voor deze velden analyseren en ze toewijzen aan de juiste velden in het daaropvolgende AUTH verzoek.
Voordat u de AUTH!
Niet ingeschreven kaarten
Als zowel uw bedrijf als de bank van de kaarthouder gevestigd zijn binnen de Europese Economische Ruimte (EER) of het Verenigd Koninkrijk, moet uw implementatie voldoen aan de Payment Services Directive (PSD2).
PSD2 vereist dat online kaartbetalingen worden verwerkt met 3-D Secure. Als een kaart niet is geregistreerd, is de aanbevolen aanpak om de transactie te stoppen en de klant een alternatief betaalmiddel aan te bieden.
Als je rekening hebt gehouden met de juridische implicaties die hierboven zijn beschreven en als je door mag gaan, moet je systeem een AUTH -verzoek opstellen en handmatig indienen om de betaling te voltooien met een niet-ingeschreven kaart. Klik hier voor de volledige specificatie.
Niet-geauthenticeerde kaarten
Wij raden ten zeerste af de transactie door te zetten indien de status is "N" of "R":
- Als status "N" is, betekent dit dat de klant niet is geauthenticeerd.
- Als status "R" is, betekent dit dat de authenticatie is geweigerd.
AUTH Voorbeeld aanvragen
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
auth = {
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"expirydate":"07/2026",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"cavv":"Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"eci":"05",
"enrolled":"Y",
"status":"Y",
"threedversion":"2.2.0",
"threeddirectorytransactionreference":"f00e1111-0011-00a6-ab00-a00000a00000",
"walletdisplayname":"MasterCard 0511",
"orderreference":"My_Order_123",
"walletsource":"GOOGLEPAY"
}
strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php
if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);
$configData = array(
'username' => 'webservices@example.com',
'password' => 'Password1^',
);
$requestData = array(
'baseamount' => '2000',
'currencyiso3a' => 'GBP',
'expirydate' => '07/2026',
'pan' => '5100000000000511',
'requesttypedescriptions' => ["AUTH"],
'sitereference' => 'test_site12345',
'cavv' => 'Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=',
'eci' => '05',
'enrolled' => 'Y',
'status' => 'Y',
'threedversion' => '2.2.0',
'threeddirectorytransactionreference' => 'f00e1111-0011-00a6-ab00-a00000a00000',
'walletdisplayname' => 'MasterCard 0511',
'orderreference' => 'My_Order_123',
'walletsource' => 'GOOGLEPAY'
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user webservices@example.com:Password1^ <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"webservices@example.com",
"version": "1.00",
"request": [{
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"expirydate":"07/2026",
"pan":"5100000000000511",
"requesttypedescriptions":["AUTH"],
"sitereference": "test_site12345",
"cavv":"Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"eci":"05",
"enrolled":"Y",
"status":"Y",
"threedversion":"2.2.0",
"threeddirectorytransactionreference":"f00e1111-0011-00a6-ab00-a00000a00000",
"walletdisplayname":"MasterCard 0511",
"orderreference":"My_Order_123",
"walletsource":"GOOGLEPAY"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"expirydate":"07/2026",
"pan":"5100000000000511",
"requesttypedescriptions":["AUTH"],
"sitereference": "test_site12345",
"cavv":"Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"eci":"05",
"enrolled":"Y",
"status":"Y",
"threedversion":"2.2.0",
"threeddirectorytransactionreference":"f00e1111-0011-00a6-ab00-a00000a00000",
"walletdisplayname":"MasterCard 0511",
"orderreference":"My_Order_123",
"walletsource":"GOOGLEPAY"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="AUTH">
<billing>
<payment>
<expirydate>07/2026</expirydate>
<pan>5100000000000511</pan>
<wallet>
<displayname>MasterCard 0511</displayname>
<source>GOOGLEPAY</source>
</wallet>
</payment>
<amount currencycode="GBP">2000</amount>
</billing>
<merchant>
<orderreference>My_Order_123</orderreference>
</merchant>
<operation>
<sitereference>test_site12345</sitereference>
<accounttypedescription>ECOM</accounttypedescription>
</operation>
<threedsecure>
<cavv>Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=</cavv>
<eci>05</eci>
<enrolled>Y</enrolled>
<status>Y</status>
<version>2.2.0</version>
<directorytransactionreference>f00e1111-0011-00a6-ab00-a00000a00000</directorytransactionreference>
</threedsecure>
</request>
</requestblock>
AUTH Specificatie verzoekveld
| Veld | Mapping naar velden van Google paymentData | Formaat | Beschrijving | |
| Verplicht |
accounttypedescription XPath: /operation/accounttypedescription |
N/A | Alpha (20) | Submit "ECOM" voor een e-commerce transactie. |
| Verplicht |
baseamount XPath: /billing/amount |
N/A | Numeriek (13) |
Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus £10 wordt weergegeven als 1000. Deze waarde moet groter zijn dan nul. |
| Verplicht |
currencyiso3a XPath: /billing/amount/@currencycode |
N/A | Alpha (3) | De Munt van de transactie. Klik hier voor een volledige lijst van beschikbare valuta. |
| Verplicht | ingeschreven XPath: /threedsecure/enrolled |
N/A | Char (1) |
Vul 'J' in om aan te geven dat de kaart is geregistreerd. |
| Verplicht |
expirydate XPath: /billing/payment/expirydate |
encryptedMessage ≫ paymentMethodDetails ≫ expirationMonth/expirationYear |
Datum MM/JJJJ |
De op de kaart gedrukte vervaldatum. Je moet de velden expirationMonth (vervaldatum) en expirationYear (vervaldatum) van Google combineren en dit in de indeling "MM/JJJJ" indienen in het verzoek AUTH . |
| Verplicht |
pan XPath: /billing/payment/pan |
encryptedMessage ≫ paymentMethodDetails ≫ pan |
Numeriek (12-19) | Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt. |
| Verplicht |
requesttypedescriptions XPath: /@type |
N/A | Alpha (20) |
Ondersteunde Verzoektype combinaties:
|
| Verplicht |
sitereference XPath: /operation/sitereference |
N/A |
Alfanumeriek & underscore (50) |
Identificeert uw site op het Trust Payments systeem. |
| Verplicht | status XPath: /threedsecure/status |
N/A | Char (1) |
Geeft aan of de klant al dan niet op de ACS van de kaartuitgever werd geauthenticeerd:
|
| Verplicht |
walletdisplayname XPath:/billing/payment/wallet/displayname |
paymentMethodData ≫ info |
Numeriek (4) |
Dit is door de kaartuitgever verstrekte informatie die aan de klant kan worden getoond om de betalingsmethode te identificeren. Dit omvat doorgaans de laatste 4 cijfers van hun kaartnummer. Het info-object bevat twee eigenschappen die je moet meesturen in het veld walletdisplayname . Je moet de cardNetwork & cardDetails en ze combineren, bijvoorbeeld |
| Verplicht |
walletsource XPath: /billing/payment/wallet/source |
N/A | Alfa (8) | Moet worden ingediend met waarde "GOOGLEPAY". |
| Conditioneel |
billingfirstname XPath: /billing/name/first |
billingAddress ≫ name |
Alfanumeriek, inclusief symbolen (127) |
De klant Voornaam facturatie. Vereist voor handelaren in kansspelen. |
| Conditioneel |
billinglastname XPath: /billing/name/last |
billingAddress ≫ name |
Alfanumeriek, inclusief symbolen (127) |
De klant Achternaam facturatie. Vereist voor handelaren in kansspelen. |
| Conditioneel | cavv XPath: /threedsecure/cavv |
N/A | Alfanumeriek (56) |
De unieke Cardholder Authentication Verification Value (CAVV) geassocieerd met de transactie. Dien deze waarde altijd in als hij beschikbaar is.
|
| Conditioneel |
customerpostcode XPath: /customer/postcode |
shippingAddress ≫ postalCode | Alfanumeriek (25) |
De afleverpostcode of postcode van de klant. Dit moet een geldige postcode zijn voor de customercountryiso2a ingediend. Vereist indien Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is. |
| Conditioneel |
customerlastname XPath: /customer/name/last |
shippingAddress ≫ naam |
Alfanumeriek, inclusief symbolen (127) |
De achternaam op het afleveradres van de klant. Vereist indien Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is. |
| Conditioneel | eci XPath: /threedsecure/eci |
N/A | Alfanumeriek (2) |
Het beveiligingsniveau ECI (E-Commerce Indicator) van de transactie. Dien deze waarde altijd in als hij beschikbaar is. |
| Conditioneel | threedversion XPath: /threedsecure/versie |
N/A | Numeriek (6) |
Versie van 3-D Secure die wordt gebruikt om de betaling te verifiëren. (bijv. "2.2.0") Dien deze waarde altijd in als hij beschikbaar is.
|
| Conditioneel |
threeddirectorytransactionreference XPath: /threedsecure/directorytransactionreference |
N/A | Alfanumeriek (48) |
Unieke DSTransactionId teruggestuurd door uw MPI provider. Dien deze waarde altijd in als hij beschikbaar is.
|
| Optioneel |
billingcountryiso2a XPath: /billing/country |
billingAddress ≫ countryCode | Alpha (2) |
Het land op het factuuradres van de klant. Dit moet in ISO2A-formaat zijn. |
| Optioneel |
billingemail XPath: /billing/email |
N/A | E-mail (255) | Het E-mailadres facturatie adres van de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-teken). |
| Optioneel |
billingpostcode XPath: /billing/postcode |
billingAddress ≫ postalCode | Alfanumeriek (25) |
De Postcode facturatie of postcode. Dit moet een geldige postcode/ZIP-code zijn voor de billingcountryiso2a ingediend. |
| Optioneel |
billingpremise XPath: /billing/premise |
billingAddress ≫ address1 |
Alfanumeriek, inclusief symbolen (25) |
De huisnaam/het huisnummer op het factuuradres van de klant. |
| Optioneel |
billingtelephone XPath: /billing/telephone |
billingAddress ≫ phoneNumber |
Alfanumeriek, inclusief symbolen (20) |
Het telefoonnummer van de klant voor facturering. Geldige tekens:
|
| Optioneel |
billingtown XPath: /billing/town |
billingAddress ≫ plaats |
Alfanumeriek, inclusief symbolen (127) |
De ingevoerde stad voor het factuuradres van de klant. |
| Optioneel |
customercountryiso2a XPath: /customer/country |
shippingAddress ≫ countryCode | Alpha (2) |
Het land op het afleveradres van de klant. Dit moet in ISO2A-formaat zijn. |
| Optioneel |
customeremail XPath: /customer/email |
N/A | E-mail (255) | E-mailadres voor levering van de klant. Maximale lengte 255 (maximaal 64 tekens voor het "@"-symbool). |
| Optioneel |
customerfirstname XPath: /customer/name/first |
shippingAddress ≫ naam |
Alfanumeriek, inclusief symbolen (127) |
De eerste naam op het afleveradres van de klant. |
| Optioneel |
customerpremise XPath: /customer/premise |
shippingAddress ≫ address1 |
Alfanumeriek, inclusief symbolen (25) |
De huisnaam/het huisnummer op het afleveradres van de klant. |
| Optioneel |
customertelephone XPath: /customer/telephone |
shippingAddress ≫ phoneNumber |
Alfanumeriek, inclusief symbolen (20) |
Telefoonnummer voor bezorging van de klant. Geldige tekens:
|
| Optioneel |
customertown XPath: /customer/town |
shippingAddress ≫ plaats |
Alfanumeriek, inclusief symbolen (127) |
De stad op het afleveradres van de klant. |
| Optioneel |
orderreference XPath: /merchant/orderreference |
N/A |
Alfanumeriek, inclusief symbolen (25) |
Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen. |
| Optioneel |
paymenttypedescription XPath: /billing/payment/@type |
N/A | Alpha (20) | Betalingsmethode (bijv. "VISA" of "MASTERCARD"). |
AUTH Voorbeeld antwoord
Na het indienen van het AUTH verzoek, krijg je een AUTH antwoord terug:
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST09',
u 'authmethod': u 'FINAL',
u 'baseamount': u '2000',
u 'cavv': u 'Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=',
u 'currencyiso3a': u 'GBP',
u 'customeroutput': u 'RESULT',
u 'debtrepayment': u '0',
u 'eci': u '05',
u 'enrolled': u 'Y',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuercountryiso2a': u 'JP',
u 'livestatus': u '0',
u 'maskedpan': u '510000######0511',
u 'merchantcategorycode': u '1234',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '00000000',
u 'orderreference': u 'My_Order_123',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-03-22',
u 'settlestatus': u '0',
u 'splitfinalnumber': u '1',
u 'status': u 'Y',
u 'threedversion': u '2.2.0',
u 'tid': u '27882788',
u 'transactionreference': u '36-9-286248',
u 'transactionstartedtimestamp': u '2023-03-22 09:34:31',
u 'walletdisplayname': u 'MasterCard 0511',
u 'walletsource': u 'GOOGLEPAY'
}]
}
array(3) {
["requestreference"] => string(9) "A3579dkvx"
["version"] => string(4) "1.00"
["responses"] => array(1) {
[0] => array(36) {
["accounttypedescription"] => string(4) "ECOM"
["acquirerresponsecode"] => string(2) "00"
["authcode"] => string(6) "TEST09"
["authmethod"] => string(4) "FINAL"
["baseamount"] => string(4) "2000"
["cavv"] => string(28) "Q0FWVkNBVlZDQVZWQ0FWVkNBVlY="
["currencyiso3a"] => string(3) "GBP"
["debtrepayment"] => string(1) "0"
["customeroutput"] => string(6) "RESULT"
["eci"] => string(2) "02"
["enrolled"] => string(1) "Y"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuercountryiso2a"] => string(2) "JP"
["livestatus"] => string(1) "0"
["maskedpan"] => string(16) "510000######0511"
["merchantcategorycode"] => string(4) "1234"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(8) "00000000"
["operatorname"] => string(13) "webservices@example.com"
["orderreference"] => string(12) "My_Order_123"
["paymenttypedescription"] => string(10) "MASTERCARD"
["requesttypedescription"] => string(4) "AUTH"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-03-22"
["settlestatus"] => string(1) "0"
["splitfinalnumber"] => string(1) "1"
["status] => string(1) "Y"
["threedversion"] => string(5) "2.2.0"
["tid"] => string(8) "27882788"
["transactionreference"] => string(11) "36-9-286248"
["transactionstartedtimestamp"] => string(19) "2023-03-22 09:34:31"
["walletdisplayname"] => string(19) "MasterCard 0511"
["walletsource"] => string(8) "GOOGLEPAY"
}
}
}
{
"requestreference":"W23-fjgvn3d8",
"version":"1.00",
"response":[{
"accounttypedescription": "ECOM",
"acquirerresponsecode": "00",
"authcode": "5",
"authmethod": "FINAL",
"baseamount": "2000",
"cavv": "Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"currencyiso3a": "GBP",
"customeroutput": "RESULT",
"debtrepayment": "0",
"eci": "05",
"enrolled": "Y",
"errorcode": "0",
"errormessage": "Ok",
"issuercountryiso2a": "ZZ",
"livestatus": "1",
"maskedpan": "510000######0511",
"merchantcountryiso2a": "GB",
"merchantname": "Live Unittest Site <>&!_-=+@#:;,./?OK",
"merchantnumber": "98965325",
"operatorname": "webservices@merchant.com",
"orderreference": "My_Order_123",
"paymenttypedescription": "MASTERCARD",
"requesttypedescription": "AUTH",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-09-11",
"settlestatus": "0",
"status": "Y",
"threedversion": "2.2.0",
"tid": "27887756",
"transactionreference": "16-14-110",
"transactionstartedtimestamp": "2023-09-11 13:52:55",
"walletdisplayname": "MasterCard 0511",
"walletsource": "GOOGLEPAY"
}],
"secrand":"zO9"
}
<?xml version='1.0' encoding='utf-8'?>
<responseblock version="3.67">
<requestreference>Xpdpuy1q7</requestreference>
<response type="AUTH">
<acquirerresponsecode>00</acquirerresponsecode>
<authcode>11</authcode>
<billing>
<amount currencycode="GBP">2000</amount>
<payment type="MASTERCARD">
<issuercountry>ZZ</issuercountry>
<pan>510000######0511</pan>
<wallet>
<displayname>MasterCard 0511</displayname>
<source>GOOGLEPAY</source>
</wallet>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>1</live>
<merchant>
<debtrepayment>0</debtrepayment>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Merchant123</merchantname>
<merchantnumber>98965325</merchantnumber>
<operatorname>Merchant</operatorname>
<orderreference>My_Order_123</orderreference>
<tid>27887756</tid>
</merchant>
<operation>
<accounttypedescription>ECOM</accounttypedescription>
<authmethod>FINAL</authmethod>
</operation>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-09-12</settleduedate>
<settlestatus>0</settlestatus>
</settlement>
<threedsecure>
<cavv>Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=</cavv>
<eci>05</eci>
<enrolled>Y</enrolled>
<status>Y</status>
<version>2.2.0</version>
</threedsecure>
<timestamp>2023-09-12 08:32:35</timestamp>
<transactionreference>16-14-116</transactionreference>
</response>
<secrand>dOtpy</secrand>
</responseblock>
AUTH Specificatie van antwoordvelden
| Veld | Formaat | Beschrijving | |
| Geretourneerd | accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) | "ECOM" wordt teruggestuurd in het antwoord om een e-commercetransactie weer te geven. |
| Geretourneerd | authmethod XPath: /operation/authmethod |
Alpha (11) |
De authmethod specificeert hoe een transactie moet worden verwerkt door de kaartuitgever. Je zou moeten verwachten dat een van de volgende waarden wordt geretourneerd om de authmethod in dienst. Klik op de volgende links voor meer informatie:
Dit veld wordt teruggestuurd indien het in het verzoek is ingediend. |
| 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. Deze waarde moet groter zijn dan nul. |
| Geretourneerd | currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
De Munt van de transactie. Klik hier voor een volledige lijst van beschikbare munteenheden. |
| Geretourneerd | dccenabled XPath: /billing/dcc/@enabled |
Numeriek (1) | Omdat Google Pay DCC niet ondersteunt, wordt "0" teruggestuurd om aan te geven dat DCC is uitgeschakeld voor deze transactie. |
| Geretourneerd | debtrepayment XPath: /merchant/debtrepayment |
Numeriek (1) |
Geeft aan of een transactie is gemarkeerd als schuldaflossing. Klik hier voor meer informatie. |
| Geretourneerd | eci XPath: /threedsecure/eci |
Alfanumeriek (2) | Het beveiligingsniveau ECI (E-Commerce Indicator) van de transactie. Klik hier voor meer informatie over mogelijke ECI waarden. |
| Geretourneerd | errorcode XPath: /error/code |
Numeriek (1-5) |
De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
Klik hier voor een volledige lijst van errorcode en bericht waarden. |
| 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 errorcode en bericht waarden. |
| Geretourneerd | issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Het land van de kaartuitgever van de klant. |
| Geretourneerd | livestatus XPath: /live |
Numeriek (1) |
|
| Geretourneerd | maskedpan XPath: /billing/payment/pan |
Alfanumeriek, inclusief "#" (12-19) | De maskedpan veld staat voor het kaartnummer van de klant. De waarde van maskedpan veld wordt in het antwoord gemaskeerd. Het grootste deel van het nummer wordt opzettelijk verborgen door "#" tekens, bijv. 411111######0211. |
| 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) | "AUTH" wordt in het antwoord teruggezonden. |
| Geretourneerd | securityresponseaddress XPath: /security/address |
Numeriek (1) | Het resultaat van AVS en beveiligingscodecontroles. |
| Geretourneerd | securityresponsepostcode XPath: /security/postcode |
Numeriek (1) | |
| Geretourneerd | securityresponsesecuritycode XPath: /security/securitycode |
Numeriek (1) | |
| Geretourneerd | settleduedate XPath: /settlement/settleduedate |
Datum JJJJ-MM-DD | De datum waarop de transactie zal worden afgewikkeld. |
| Geretourneerd | settlestatus XPath: /settlement/settlestatus |
Numeriek (3) |
Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot deze transactie aan te geven. Klik hier voor een volledige lijst van settlestatus waarden. |
| Geretourneerd | splitfinalnumber XPath: /operation/splitfinalnumber |
Numeriek (2) | Omdat Google Pay Split Shipment niet ondersteunt, wordt "1" teruggestuurd om aan te geven dat het geld in één keer wordt overgemaakt. |
| Geretourneerd | tid XPath: /merchant/tid |
Alfanumeriek (255) | De terminal ID die gebruikt wordt om de transactie te verwerken. Dit wordt gekoppeld aan uw handelaarsnummer wanneer wij uw rekening in onze systemen instellen. |
| Geretourneerd | transactionreference XPath: /transactionreference |
Alfanumeriek, inclusief koppeltekens (25) |
Een unieke referentie voor de transactie toegewezen door Trust Payments. U hebt deze referentie nodig om een terugbetaling uit te voeren of de transactie bij te werken. |
| Geretourneerd | transactionstartedtimestamp XPath: /timestamp |
Datum tijd JJJJ-MM-DD hh:mm:ss | Het tijdstip waarop de transactie werd verwerkt. |
| Geretourneerd | walletdisplayname XPath: /billing/payment/wallet/displayname |
Alfanumeriek (255) | Het door de klant gebruikte kaarttype en de laatste vier cijfers van zijn kaartnummer (bijv. "Visa 1111"). |
| Geretourneerd | walletsource XPath: /billing/payment/wallet/source |
Alfanumeriek (20) | Wordt gebruikt om het type portemonnee te identificeren dat wordt gebruikt voor deze betaling (in dit geval "GOOGLEPAY"). |
| Conditioneel | acquirerresponsecode XPath: /acquirerresponsecode |
Alfanumeriek (255) |
Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven. Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie. |
| Conditioneel | authcode XPath: /authcode |
Alfanumeriek (255) |
De autorisatie code verstrekt door de uitgevende bank. Deze zal verschillen afhankelijk van de bank die u gebruikt. Wordt alleen geretourneerd als de transactie is toegestaan. |
| 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. |
| Conditioneel | merchantcategorycode XPath: /merchant/merchantcategorycode |
Alfanumeriek (255) |
Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team. De geretourneerde waarden zijn afhankelijk van je accountconfiguratie. |
| Conditioneel | merchantcity XPath: /merchant/merchantcity |
Alfanumeriek (127) | |
| Conditioneel | merchantcountryiso2a XPath: /merchant/merchantcountryiso2a |
Alpha (2) | |
| Conditioneel | merchantname XPath: /merchant/merchantname |
Alfanumeriek (255) | |
| Conditioneel | merchantstatecode XPath: /merchant/merchantstatecode |
Alfanumeriek (127) | |
| Conditioneel | merchantzipcode XPath: /merchant/merchantzipcode |
Alfanumeriek (10) | |
| Conditioneel | orderreference XPath: /merchant/orderreference |
Alfanumeriek, inclusief symbolen (25) |
Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen. Dit veld wordt teruggestuurd indien het in het verzoek is ingediend. |
Als CRYPTOGRAM_3DS wordt geretourneerd in de authMethodhoeft u geen 3-D secure authenticatie uit te voeren.
3-D Secure authenticatie is niet nodig voor de CRYPTOGRAM_3DS authenticatiemethode omdat het authenticatieproces al wordt afgehandeld door Google namens de kaartuitgever met behulp van de referenties die zijn opgeslagen op het Android -apparaat van de klant. Dit is in overeenstemming met de vereisten van het Strong Customer Authentication (SCA) mandaat.
Na het antwoord van Google Pay moet u in het bezit zijn van de onderstaande velden, die vereist zijn in het verzoek AUTH :
Betalingsgegevens van het antwoord op Google Pay :
-
pan
Afgebeeld van:
encryptedMessage ≫ paymentMethodDetails ≫ pan -
expirydate
Afgedrukt van:
encryptedMessage ≫ paymentMethodDetails ≫ expirationMonth/expirationYear -
walletdisplayname
Afgebeeld van:
paymentMethodData ≫ info -
tavv
Afgebeeld van:
encryptedMessage ≫ paymentMethodDetails ≫ cryptogram -
eci
Afgedrukt van:
encryptedMessage ≫ paymentMethodDetails ≫ eciIndicator
Als je van plan bent om de factuur- en aflevergegevens van de klant van hun Google Wallet vast te leggen, moet je ook de respons van de Google API voor deze velden analyseren en ze toewijzen aan de juiste velden in het daaropvolgende AUTH verzoek.
AUTH Voorbeeld aanvragen
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
auth = {
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"eci":"2",
"expirydate":"07/2026",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference":"test_site12345",
"tavv":"ALFoEd4DhmGzAIj3dUo4AoABFA==",
"tokenisedpayment":"1",
"tokentype":"GOOGLEPAY",
"walletdisplayname":"MasterCard 0511",
"walletsource":"GOOGLEPAY"
}
strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php
if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);
$configData = array(
'username' => 'webservices@example.com',
'password' => 'Password1^',
);
$requestData = array(
'accounttypedescription' => 'ECOM',
'baseamount' => '2000',
'currencyiso3a' => 'GBP',
'eci' => '2',
'expirydate' => '07/2026',
'orderreference' => 'My_Order_123',
'pan' => '5100000000000511',
'requesttypedescriptions' => array('AUTH'),
'sitereference' => 'test_site12345',
'tavv' => 'ALFoEd4DhmGzAIj3dUo4AoABFA==',
'tokenisedpayment' => '1',
'tokentype' => 'GOOGLEPAY',
'walletdisplayname' => 'MasterCard 0511',
'walletsource' => 'GOOGLEPAY'
);
$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());
?>
curl --user webservices@example.com:Password1^ <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"webservices@example.com",
"version": "1.00",
"request": [{
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"eci":"2",
"expirydate":"07/2026",
"orderreference": "My_Order_123",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"tavv":"ALFoEd4DhmGzAIj3dUo4AoABFA==",
"tokenisedpayment":"1",
"tokentype":"GOOGLEPAY",
"walletdisplayname":"MasterCard 0511",
"walletsource":"GOOGLEPAY"
}]
}'
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"eci":"2",
"expirydate":"07/2026",
"orderreference": "My_Order_123",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"tavv":"ALFoEd4DhmGzAIj3dUo4AoABFA==",
"tokenisedpayment":"1",
"tokentype":"GOOGLEPAY",
"walletdisplayname":"MasterCard 0511",
"walletsource":"GOOGLEPAY"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="AUTH">
<billing>
<payment>
<expirydate>07/2026</expirydate>
<pan tokenised="1" tokentype="GOOGLEPAY">5100000000000511</pan>
<wallet>
<displayname>MasterCard 0511</displayname>
<source>GOOGLEPAY</source>
</wallet>
</payment>
<amount currencycode="GBP">2000</amount>
</billing>
<merchant>
<orderreference>My_Order_123</orderreference>
</merchant>
<operation>
<sitereference>test_site12345</sitereference>
<accounttypedescription>ECOM</accounttypedescription>
</operation>
<threedsecure>
<eci>2</eci>
<tavv>ALFoEd4DhmGzAIj3dUo4AoABFA==</tavv>
</threedsecure>
</request>
</requestblock>
AUTH Specificatie verzoekveld
| Veld | Mapping naar velden van Google paymentData | Formaat | Beschrijving | |
| Verplicht |
accounttypedescription XPath: /operation/accounttypedescription |
N/A | Alpha (20) | Submit "ECOM" voor een e-commerce transactie. |
| Verplicht |
baseamount XPath: /billing/amount |
N/A | Numeriek (13) |
Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus £10 wordt weergegeven als 1000. Deze waarde moet groter zijn dan nul. |
| Verplicht |
currencyiso3a XPath: /billing/amount/@currencycode |
N/A | Alpha (3) | De Munt van de transactie. Klik hier voor een volledige lijst van beschikbare valuta. |
| Verplicht |
eci XPath: /threedsecure/eci |
encryptedMessage ≫ paymentMethodDetails ≫ eciIndicator | Alfanumeriek (2) | Het beveiligingsniveau ECI (E-Commerce Indicator) van de transactie. Klik hier voor meer informatie over mogelijke ECI waarden. |
| Verplicht |
expirydate XPath: /billing/payment/expirydate |
encryptedMessage ≫ paymentMethodDetails ≫ expirationMonth/expirationYear | Datum MM/JJJJ |
Je moet de velden expirationMonth (vervaldatum) en expirationYear (vervaldatum) van Google combineren en dit in de indeling "MM/JJJJ" indienen in het verzoek AUTH . |
| Verplicht |
pan XPath: /billing/payment/pan |
encryptedMessage ≫ paymentMethodDetails ≫ pan | Numeriek (12-19) | Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt. |
| Verplicht |
requesttypedescriptions XPath: /@type |
N/A | Alpha (20) |
Ondersteunde Verzoektype combinaties:
|
| Verplicht |
sitereference XPath: /operation/sitereference |
N/A |
Alfanumeriek & underscore (50) |
Identificeert uw site op het Trust Payments systeem. |
| Verplicht |
tavv XPath: /threedsecure/tavv |
encryptedMessage ≫ paymentMethodDetails ≫ cryptogram | Alfanumerieke & speciale tekens (32) | Token Authenticatie Verificatie Waarde |
| Verplicht |
tokenisedpayment XPath: /factuur/betaling/pan/@tokenised |
N/A | Numeriek (1) | Submit met een waarde "1" om aan te geven dat de transactie wordt verwerkt met behulp van een token. |
| Verplicht |
tokentype XPath: /factuur/betaling/pan/@tokentype |
N/A | Alfa (50) | Moet worden ingediend met waarde "GOOGLEPAY". |
| Verplicht |
walletdisplayname XPath:/billing/payment/wallet/displayname |
paymentMethodData ≫ info |
Numeriek (4) |
Dit is door de kaartuitgever verstrekte informatie die aan de klant kan worden getoond om de betalingsmethode te identificeren. Dit omvat doorgaans de laatste 4 cijfers van hun kaartnummer. Het info-object bevat twee eigenschappen die je moet meesturen in het veld walletdisplayname . Je moet de waarden van de eigenschappen cardNetwork & cardDetails analyseren en combineren, bijv. |
| Verplicht |
walletsource XPath: /billing/payment/wallet/source |
N/A | Alfa (8) | Moet worden ingediend met waarde "GOOGLEPAY". |
| Conditioneel |
billingfirstname XPath: /billing/name/first |
billingAddress ≫ name |
Alfanumeriek, inclusief symbolen (127) |
De klant Voornaam facturatie. Vereist voor handelaren in kansspelen. |
| Conditioneel |
billinglastname XPath: /billing/name/last |
billingAddress ≫ name |
Alfanumeriek, inclusief symbolen (127) |
De klant Achternaam facturatie. Vereist voor handelaren in kansspelen. |
| Conditioneel |
customerpostcode XPath: /customer/postcode |
shippingAddress ≫ postalCode | Alfanumeriek (25) |
De afleverpostcode of postcode van de klant. Dit moet een geldige postcode zijn voor de customercountryiso2a ingediend. Vereist indien Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is. |
| Conditioneel |
customerlastname XPath: /customer/name/last |
shippingAddress ≫ naam |
Alfanumeriek, inclusief symbolen (127) |
De achternaam op het afleveradres van de klant. Vereist indien Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is. |
| Optioneel |
billingcountryiso2a XPath: /billing/country |
billingAddress ≫ countryCode | Alpha (2) |
Het land op het factuuradres van de klant. Dit moet in ISO2A-formaat zijn. |
| Optioneel |
billingemail XPath: /billing/email |
N/A | E-mail (255) | Het E-mailadres facturatie adres van de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-teken). |
| Optioneel |
billingpostcode XPath: /billing/postcode |
billingAddress ≫ postalCode | Alfanumeriek (25) |
De Postcode facturatie of postcode. Dit moet een geldige postcode/ZIP-code zijn voor de billingcountryiso2a ingediend. |
| Optioneel |
billingpremise XPath: /billing/premise |
billingAddress ≫ address1 |
Alfanumeriek, inclusief symbolen (25) |
De huisnaam/het huisnummer op het factuuradres van de klant. |
| Optioneel |
billingtelephone XPath: /billing/telephone |
billingAddress ≫ phoneNumber |
Alfanumeriek, inclusief symbolen (20) |
Het telefoonnummer van de klant voor facturering. Geldige tekens:
|
| Optioneel |
billingtown XPath: /billing/town |
billingAddress ≫ plaats |
Alfanumeriek, inclusief symbolen (127) |
De ingevoerde stad voor het factuuradres van de klant. |
| Optioneel |
customercountryiso2a XPath: /customer/country |
shippingAddress ≫ countryCode | Alpha (2) |
Het land op het afleveradres van de klant. Dit moet in ISO2A-formaat zijn. |
| Optioneel |
customeremail XPath: /customer/email |
shippingAddress ≫ emailAddress | E-mail (255) | E-mailadres voor levering van de klant. Maximale lengte 255 (maximaal 64 tekens voor het "@"-symbool). |
| Optioneel |
customerfirstname XPath: /customer/name/first |
shippingAddress ≫ naam |
Alfanumeriek, inclusief symbolen (127) |
De eerste naam op het afleveradres van de klant. |
| Optioneel |
customerpremise XPath: /customer/premise |
shippingAddress ≫ addressLines |
Alfanumeriek, inclusief symbolen (25) |
De huisnaam/het huisnummer op het afleveradres van de klant. |
| Optioneel |
customertelephone XPath: /customer/telephone |
shippingAddress ≫ phoneNumber |
Alfanumeriek, inclusief symbolen (20) |
Telefoonnummer voor bezorging van de klant. Geldige tekens:
|
| Optioneel |
customertown XPath: /customer/town |
shippingAddress ≫ plaats |
Alfanumeriek, inclusief symbolen (127) |
De stad op het afleveradres van de klant. |
| Optioneel |
orderreference XPath: /merchant/orderreference |
N/A |
Alfanumeriek, inclusief symbolen (25) |
Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen. |
| Optioneel |
paymenttypedescription XPath: /billing/payment/@type |
N/A | Alpha (20) | Betalingsmethode (bijv. "VISA" of "MASTERCARD"). |
AUTH Voorbeeld antwoord
Na het indienen van het AUTH verzoek, krijg je een AUTH antwoord terug:
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST09',
u 'authmethod': u 'FINAL',
u 'baseamount': u '2000',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'eci': u '02',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuercountryiso2a': u 'JP',
u 'livestatus': u '0',
u 'maskedpan': u '510000######0511',
u 'merchantcategorycode': u '1234',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '00000000',
u 'orderreference': u 'My_Order_123',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-03-22',
u 'settlestatus': u '0',
u 'splitfinalnumber': u '1',
u 'tavv': u 'ALFoEd4DhmGzAIj3dUo4AoABFA==',
u 'tid': u '27882788',
u 'tokenisedpayment': u '1',
u 'tokentype': u 'GOOGLEPAY',
u 'transactionreference': u '36-9-286248',
u 'transactionstartedtimestamp': u '2023-03-22 09:34:31',
u 'walletdisplayname': u 'MasterCard 0511',
u 'walletsource': u 'GOOGLEPAY'
}]
}
array(3) {
["requestreference"] => string(9) "A3579dkvx"
["version"] => string(4) "1.00"
["responses"] => array(1) {
[0] => array(36) {
["accounttypedescription"] => string(4) "ECOM"
["acquirerresponsecode"] => string(2) "00"
["authcode"] => string(6) "TEST09"
["authmethod"] => string(4) "FINAL"
["baseamount"] => string(4) "2000"
["currencyiso3a"] => string(3) "GBP"
["dccenabled"] => string(1) "0"
["debtrepayment"] => string(1) "0"
["eci"] => string(2) "02"
["errorcode"] => string(1) "0"
["errormessage"] => string(2) "Ok"
["issuercountryiso2a"] => string(2) "JP"
["livestatus"] => string(1) "0"
["maskedpan"] => string(16) "510000######0511"
["merchantcategorycode"] => string(4) "1234"
["merchantcountryiso2a"] => string(2) "GB"
["merchantname"] => string(13) "Test Merchant"
["merchantnumber"] => string(8) "00000000"
["operatorname"] => string(13) "webservices@example.com"
["orderreference"] => string(12) "My_Order_123"
["paymenttypedescription"] => string(10) "MASTERCARD"
["requesttypedescription"] => string(4) "AUTH"
["securityresponseaddress"] => string(1) "0"
["securityresponsepostcode"] => string(1) "0"
["securityresponsesecuritycode"] => string(1) "0"
["settleduedate"] => string(10) "2023-03-22"
["settlestatus"] => string(1) "0"
["splitfinalnumber"] => string(1) "1"
["tavv"] => string(28) "ALFoEd4DhmGzAIj3dUo4AoABFA=="
["tid"] => string(8) "27882788"
["tokenisedpayment"] => string(1) "1"
["tokentype"] => string(9) "GOOGLEPAY"
["transactionreference"] => string(11) "36-9-286248"
["transactionstartedtimestamp"] => string(19) "2023-03-22 09:34:31"
["walletdisplayname"] => string(19) "MasterCard 0511"
["walletsource"] => string(8) "GOOGLEPAY"
}
}
}
{
"requestreference":"W23-fjgvn3d8",
"version":"1.00",
"response":[{
"accounttypedescription": "ECOM",
"acquirerresponsecode": "00",
"authcode": "TEST09",
"authmethod": "FINAL",
"baseamount": "2000",
"currencyiso3a": "GBP",
"dccenabled": "0",
"debtrepayment": "0",
"eci": "02",
"errorcode": "0",
"errormessage": "Ok",
"issuercountryiso2a": "JP",
"livestatus": "0",
"maskedpan": "510000######0511",
"merchantcategorycode": "1234",
"orderreference": "My_Order_123",
"merchantcountryiso2a": "GB",
"merchantname": "Test Merchant",
"merchantnumber": "00000000",
"operatorname": "webservices@example.com",
"paymenttypedescription": "MASTERCARD",
"requesttypedescription": "AUTH",
"securityresponseaddress": "0",
"securityresponsepostcode": "0",
"securityresponsesecuritycode": "0",
"settleduedate": "2023-03-22",
"settlestatus": "0",
"splitfinalnumber": "1",
"tavv": "ALFoEd4DhmGzAIj3dUo4AoABFA==",
"tid": "27882788",
"tokenisedpayment": "1",
"tokentype": "GOOGLEPAY",
"transactionreference": "36-9-286248",
"transactionstartedtimestamp": "2023-03-22 09:34:31",
"walletdisplayname": "MasterCard 0511",
"walletsource": "GOOGLEPAY"
}],
"secrand":"zO9"
}
<responseblock version="3.67">
<requestreference>A3579dkvx</requestreference>
<response type="AUTH">
<acquirerresponsecode>00</acquirerresponsecode>
<authcode>TEST09</authcode>
<billing>
<amount currencycode="GBP">2000</amount>
<dcc enabled="0"/>
<payment type="MASTERCARD">
<issuercountry>JP</issuercountry>
<pan tokenised="1" tokentype="GOOGLEPAY">510000######0511</pan>
<wallet>
<displayname>MasterCard 0511</displayname>
<source>GOOGLEPAY</source>
</wallet>
</payment>
</billing>
<error>
<code>0</code>
<message>Ok</message>
</error>
<live>0</live>
<merchant>
<debtrepayment>0</debtrepayment>
<merchantcategorycode>1234</merchantcategorycode>
<merchantcountryiso2a>GB</merchantcountryiso2a>
<merchantname>Test Merchant</merchantname>
<merchantnumber>00000000</merchantnumber>
<operatorname>webservices@example.com</operatorname>
<orderreference>My_Order_123</orderreference>
<tid>27882788</tid>
</merchant>
<operation>
<accounttypedescription>ECOM</accounttypedescription>
<authmethod>FINAL</authmethod>
<splitfinalnumber>1</splitfinalnumber>
</operation>
<security>
<address>0</address>
<postcode>0</postcode>
<securitycode>0</securitycode>
</security>
<settlement>
<settleduedate>2023-03-22</settleduedate>
<settlestatus>0</settlestatus>
</settlement>
<threedsecure>
<eci>02</tavv>
<tavv>ALFoEd4DhmGzAIj3dUo4AoABFA==</tavv>
</threedsecure>
<timestamp>2023-03-22 09:34:31</timestamp>
<transactionreference>36-9-286248</transactionreference>
</response>
<secrand>hYWFMkiiAZ0wKHFZ</secrand>
</responseblock>
AUTH Specificatie van antwoordvelden
| Veld | Formaat | Beschrijving | |
| Geretourneerd | accounttypedescription XPath: /operation/accounttypedescription |
Alpha (20) | "ECOM" wordt teruggestuurd in het antwoord om een e-commercetransactie weer te geven. |
| Geretourneerd | authmethod XPath: /operation/authmethod |
Alpha (11) |
De authmethod specificeert hoe een transactie moet worden verwerkt door de kaartuitgever. Je zou moeten verwachten dat een van de volgende waarden wordt geretourneerd om de authmethod in dienst. Klik op de volgende links voor meer informatie:
Dit veld wordt teruggestuurd indien het in het verzoek is ingediend. |
| 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. Deze waarde moet groter zijn dan nul. |
| Geretourneerd | currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
De Munt van de transactie. Klik hier voor een volledige lijst van beschikbare munteenheden. |
| Geretourneerd | dccenabled XPath: /billing/dcc/@enabled |
Numeriek (1) | Omdat Google Pay DCC niet ondersteunt, wordt "0" teruggestuurd om aan te geven dat DCC is uitgeschakeld voor deze transactie. |
| Geretourneerd | debtrepayment XPath: /merchant/debtrepayment |
Numeriek (1) |
Geeft aan of een transactie is gemarkeerd als schuldaflossing. Klik hier voor meer informatie. |
| Geretourneerd | eci XPath: /threedsecure/eci |
Alfanumeriek (2) | Het beveiligingsniveau ECI (E-Commerce Indicator) van de transactie. Klik hier voor meer informatie over mogelijke ECI waarden. |
| Geretourneerd | errorcode XPath: /error/code |
Numeriek (1-5) |
De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
Klik hier voor een volledige lijst van errorcode en bericht waarden. |
| 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 errorcode en bericht waarden. |
| Geretourneerd | issuercountryiso2a XPath: /billing/payment/issuercountry |
Alpha (2) |
Het land van de kaartuitgever van de klant. |
| Geretourneerd | livestatus XPath: /live |
Numeriek (1) |
|
| Geretourneerd | maskedpan XPath: /billing/payment/pan |
Alfanumeriek, inclusief "#" (12-19) | De maskedpan veld staat voor het kaartnummer van de klant. De waarde van maskedpan veld wordt in het antwoord gemaskeerd. Het grootste deel van het nummer wordt opzettelijk verborgen door "#" tekens, bijv. 411111######0211. |
| 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) | "AUTH" wordt in het antwoord teruggezonden. |
| Geretourneerd | securityresponseaddress XPath: /security/address |
Numeriek (1) | Het resultaat van AVS en beveiligingscodecontroles. |
| Geretourneerd | securityresponsepostcode XPath: /security/postcode |
Numeriek (1) | |
| Geretourneerd | securityresponsesecuritycode XPath: /security/securitycode |
Numeriek (1) | |
| Geretourneerd | settleduedate XPath: /settlement/settleduedate |
Datum JJJJ-MM-DD | De datum waarop de transactie zal worden afgewikkeld. |
| Geretourneerd | settlestatus XPath: /settlement/settlestatus |
Numeriek (3) |
Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot deze transactie aan te geven. Klik hier voor een volledige lijst van settlestatus waarden. |
| Geretourneerd | splitfinalnumber XPath: /operation/splitfinalnumber |
Numeriek (2) | Omdat Google Pay Split Shipment niet ondersteunt, wordt "1" teruggestuurd om aan te geven dat het geld in één keer wordt overgemaakt. |
| Geretourneerd | tavv XPath: /threedsecure/tavv |
Alfanumerieke & speciale tekens (32) | Token Authenticatie Verificatie Waarde |
| Geretourneerd | tid XPath: /merchant/tid |
Alfanumeriek (255) | De terminal ID die gebruikt wordt om de transactie te verwerken. Dit wordt gekoppeld aan uw handelaarsnummer wanneer wij uw rekening in onze systemen instellen. |
| Geretourneerd | tokenisedpayment XPath: /factuur/betaling/pan/@tokenised |
Numeriek (1) | Wordt geretourneerd met een waarde "1" om aan te geven dat de transactie is verwerkt met behulp van een token. |
| Geretourneerd | tokentype XPath: /factuur/betaling/pan/@tokentype |
Alfa (50) | Wordt geretourneerd met de waarde "GOOGLEPAY", om aan te geven dat Google Pay is gebruikt. |
| Geretourneerd | transactionreference XPath: /transactionreference |
Alfanumeriek, inclusief koppeltekens (25) |
Een unieke referentie voor de transactie toegewezen door Trust Payments. U hebt deze referentie nodig om een terugbetaling uit te voeren of de transactie bij te werken. |
| Geretourneerd | transactionstartedtimestamp XPath: /timestamp |
Datum tijd JJJJ-MM-DD hh:mm:ss | Het tijdstip waarop de transactie werd verwerkt. |
| Geretourneerd | walletdisplayname XPath: /billing/payment/wallet/displayname |
Alfanumeriek (255) | Het door de klant gebruikte kaarttype en de laatste vier cijfers van zijn kaartnummer (bijv. "Visa 1111"). |
| Geretourneerd | walletsource XPath: /billing/payment/wallet/source |
Alfanumeriek (20) | Wordt gebruikt om het type portemonnee te identificeren dat wordt gebruikt voor deze betaling (in dit geval "GOOGLEPAY"). |
| Conditioneel | acquirerresponsecode XPath: /acquirerresponsecode |
Alfanumeriek (255) |
Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven. Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie. |
| Conditioneel | authcode XPath: /authcode |
Alfanumeriek (255) |
De autorisatie code verstrekt door de uitgevende bank. Deze zal verschillen afhankelijk van de bank die u gebruikt. Wordt alleen geretourneerd als de transactie is toegestaan. |
| 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. |
| Conditioneel | merchantcategorycode XPath: /merchant/merchantcategorycode |
Alfanumeriek (255) |
Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team. De geretourneerde waarden zijn afhankelijk van je accountconfiguratie. |
| Conditioneel | merchantcity XPath: /merchant/merchantcity |
Alfanumeriek (127) | |
| Conditioneel | merchantcountryiso2a XPath: /merchant/merchantcountryiso2a |
Alpha (2) | |
| Conditioneel | merchantname XPath: /merchant/merchantname |
Alfanumeriek (255) | |
| Conditioneel | merchantstatecode XPath: /merchant/merchantstatecode |
Alfanumeriek (127) | |
| Conditioneel | merchantzipcode XPath: /merchant/merchantzipcode |
Alfanumeriek (10) | |
| Conditioneel | orderreference XPath: /merchant/orderreference |
Alfanumeriek, inclusief symbolen (25) |
Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen. Dit veld wordt teruggestuurd indien het in het verzoek is ingediend. |
