Apple Pay directe AUTH integratie

  Laatst bijgewerkt: 

 

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.

 

Dit document gaat ervan uit dat je je eigen integratie met Apple Pay hebt geconfigureerd en een gateway nodig hebt om de betaling te verwerken. Zodra u   Richtlijnen van Apple voor het verifiëren van de tokenhandtekening en het decoderen van het token (link naar externe site)moet uw systeem de sleutelwaarden uit de paymentData, billingContact en shippingContact geretourneerde objecten en dienen deze in een AUTH verzoek in bij Trust Payments. De volledige toewijzingen van de velden die worden geretourneerd door Apple Pay naar de velden die worden ingediend in het AUTH verzoek staan hieronder.

 

AUTH verzoek

Hieronder volgt een voorbeeld van een AUTH verzoek met de hierboven beschreven vereisten:

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)

auth = {
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"eci":"2",
"expirydate":"07/2023",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"tavv":"ALFoEd4DhmGzAIj3dUo4AoABFA==",
"walletdisplayname":"MasterCard 0511",
"walletsource":"APPLEPAY"
}

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

 

Specificatie veld

  Veld Koppeling naar velden van ontcijferd token Formaat Beschrijving
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
N/A Alpha (20) Submit "ECOM" voor een e-commerce transactie.
X1-EN.png 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.

X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
N/A Alpha (3) De Munt van de transactie. Klik hier voor een volledige lijst van beschikbare valuta.
X1-EN.png eci
XPath: /threedsecure/eci
paymentData ≫ eciIndicator Alfanumeriek (2) Het beveiligingsniveau ECI (E-Commerce Indicator) van de transactie. Klik hier voor meer informatie over mogelijke ECI waarden.
X1-EN.png expirydate
XPath: /billing/payment/expirydate
paymentData ≫ applicationExpirationDate Datum MM/JJJJ

De op de kaart gedrukte vervaldatum.

Het formaat dat wordt geaccepteerd door Trust Payments verschilt van het formaat dat wordt geretourneerd door Apple. Terwijl Apple dit in het formaat "YYMMDD" retourneert, moet u dit in het formaat "MM/YYYY" indienen in het AUTH verzoek.

X1-EN.png pan
XPath: /billing/payment/pan
paymentData ≫ applicationPrimaryAccountNumber Numeriek (12-19) Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt.
X1-EN.png requesttypedescriptions
XPath: /@type
N/A Alpha (20) Ondersteunde Verzoektype combinaties:
  • [“AUTH”]
  • [“AUTH”, “RISKDEC”]
  • [“AUTH”, “SUBSCRIPTION”]
  • [“ACCOUNTCHECK”, “AUTH”]
  • [“ACCOUNTCHECK”, “SUBSCRIPTION”]
  • [“RISKDEC”, “AUTH”]
  • [“RISKDEC”, “AUTH”, “SUBSCRIPTION”]
  • [“RISKDEC”, “ACCOUNTCHECK”, “AUTH”]
  • [“RISKDEC”, “ACCOUNTCHECK”, “AUTH”, “SUBSCRIPTION”]

Klik hier voor meer informatie over verzoektypes.

X1-EN.png sitereference
XPath: /operation/sitereference
N/A Alfanumeriek
& underscore (50)
Identificeert uw site op het Trust Payments systeem.
X1-EN.png tavv
XPath: /threedsecure/tavv
paymentData ≫ onlinePaymentCryptogram Alfanumerieke & speciale tekens (32) Token Authenticatie Verificatie Waarde
X1-EN.png walletdisplayname
XPath:/billing/payment/wallet/displayname

paymentData ≫ displayName

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.
X1-EN.png walletsource
XPath: /billing/payment/wallet/source
N/A Alfa (8) Moet worden ingediend met waarde "APPLEPAY".
X2-EN.png billingfirstname
XPath: /billing/name/first
billingContact ≫ givenName Alfanumeriek, inclusief
symbolen (127)

De klant Voornaam facturatie.

Vereist voor handelaren in kansspelen.

X2-EN.png billinglastname
XPath: /billing/name/last
billingContact ≫ familyName Alfanumeriek, inclusief
symbolen (127)

De klant Achternaam facturatie.

Vereist voor handelaren in kansspelen.

X2-EN.png customerpostcode
XPath: /customer/postcode
shippingContact ≫ 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.

X2-EN.png customerlastname
XPath: /customer/name/last
shippingContact ≫ familyName Alfanumeriek, inclusief
symbolen (127)

De achternaam op het afleveradres van de klant.

Vereist indien Klant Categorie Code (MCC) 6012 is en Betalingstype VISA is.

X3-EN.png billingcountryiso2a
XPath: /billing/country
billingContact ≫ countryCode Alpha (2)

Het land op het factuuradres van de klant. Dit moet in ISO2A-formaat zijn.

Klik hier voor een volledige lijst van landcodes.

X3-EN.png billingemail
XPath: /billing/email
billingContact ≫ emailAddress E-mail (255) Het E-mailadres facturatie adres van de klant. Maximale lengte van 255 (maximaal 64 tekens vóór het "@"-teken).
X3-EN.png billingpostcode
XPath: /billing/postcode
billingContact ≫ postalCode Alfanumeriek (25)

De Postcode facturatie of postcode. Dit moet een geldige postcode/ZIP-code zijn voor de billingcountryiso2a ingediend.

X3-EN.png billingpremise
XPath: /billing/premise
billingContact ≫ addressLines Alfanumeriek, inclusief
symbolen (25)
De huisnaam/het huisnummer op het factuuradres van de klant.
X3-EN.png billingtelephone
XPath: /billing/telephone
billingContact ≫ phoneNumber Alfanumeriek, inclusief
symbolen (20)
Het telefoonnummer van de klant voor facturering. Geldige tekens:
  • Cijfers 0-9
  • Ruimtes
  • Speciale tekens: + - ( )
X3-EN.png billingtown
XPath: /billing/town
factureringContact ≫ plaats Alfanumeriek, inclusief
symbolen (127)
De ingevoerde stad voor het factuuradres van de klant.
X3-EN.png customercountryiso2a
XPath: /customer/country
shippingContact ≫ countryCode Alpha (2)

Het land op het afleveradres van de klant. Dit moet in ISO2A-formaat zijn.

Klik hier voor een volledige lijst van landcodes.

X3-EN.png customeremail
XPath: /customer/email
shippingContact ≫ emailAdres E-mail (255) E-mailadres voor levering van de klant. Maximale lengte 255 (maximaal 64 tekens voor het "@"-symbool).
X3-EN.png customerfirstname
XPath: /customer/name/first
shippingContact ≫ givenName Alfanumeriek, inclusief
symbolen (127)

De eerste naam op het afleveradres van de klant.

X3-EN.png customerpremise
XPath: /customer/premise
shippingContact ≫ addressLines Alfanumeriek, inclusief
symbolen (25)
De huisnaam/het huisnummer op het afleveradres van de klant.
X3-EN.png customertelephone
XPath: /customer/telephone
shippingContact ≫ phoneNumber Alfanumeriek, inclusief
symbolen (20)
Telefoonnummer voor bezorging van de klant. Geldige tekens:
  • Cijfers 0-9
  • Ruimtes
  • Speciale tekens: + - ( )
X3-EN.png customertown
XPath: /customer/town
verzendingContact ≫ plaats Alfanumeriek, inclusief
symbolen (127)
De stad op het afleveradres van de klant.
X3-EN.png orderreference
XPath: /merchant/orderreference
N/A Alfanumeriek, inclusief
symbolen (25)

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

X3-EN.png paymenttypedescription
XPath: /billing/payment/@type
N/A Alpha (20) Betalingsmethode (bijv. "VISA" of "MASTERCARD").

 

AUTH antwoord

Na het indienen van het AUTH verzoek, krijg je een AUTH antwoord terug:

Python PHP Ruwe JSON Ruwe XML
{
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 'APPLEPAY',
u 'transactionreference': u '36-9-286248',
u 'transactionstartedtimestamp': u '2023-03-22 09:34:31',
u 'walletdisplayname': u 'MasterCard 0511',
u 'walletsource': u 'APPLEPAY'
}]
}

 

Specificatie veld

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) "ECOM" wordt teruggestuurd in het antwoord om een e-commercetransactie weer te geven.
X4-EN.png 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.

X4-EN.png 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.
X4-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

X4-EN.png dccenabled
XPath: /billing/dcc/@enabled
Numeriek (1) Omdat Apple Pay geen ondersteuning biedt voor DCCwordt "0" teruggestuurd om aan te geven dat DCC is uitgeschakeld voor deze transactie.
X4-EN.png debtrepayment
XPath: /merchant/debtrepayment
Numeriek (1)

Geeft aan of een transactie is gemarkeerd als schuldaflossing. Klik hier voor meer informatie.

X4-EN.png eci
XPath: /threedsecure/eci
Alfanumeriek (2) Het beveiligingsniveau ECI (E-Commerce Indicator) van de transactie. Klik hier voor meer informatie over mogelijke ECI waarden.
X4-EN.png 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, is de transactie niet geslaagd.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png 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 berichtwaarden.

X4-EN.png issuercountryiso2a
XPath: /billing/payment/issuercountry
Alpha (2)

Het land van de kaartuitgever van de klant.
Dit is in ISO2A-formaat.

Klik hier voor een volledige lijst van landcodes.

X4-EN.png livestatus
XPath: /live
Numeriek (1)
  • 0 - Transactie verwerkt met een testrekening.
  • 1 - Transactie verwerkt met een live rekening.
X4-EN.png 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.
X4-EN.png operatorname
XPath: /merchant/operatorname
Alfanumeriek (255) De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Betalingsmethode (bijv. "VISA" of "MASTERCARD").
X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) "AUTH" wordt in het antwoord teruggezonden.
X4-EN.png securityresponseaddress
XPath: /security/address
Numeriek (1) Het resultaat van AVS en beveiligingscodecontroles.

Klik hier voor meer informatie.

X4-EN.png securityresponsepostcode
XPath: /security/postcode
Numeriek (1)
X4-EN.png securityresponsesecuritycode
XPath: /security/securitycode
Numeriek (1)
X4-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-DD De datum waarop de transactie zal worden afgewikkeld.
X4-EN.png 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.

X4-EN.png splitfinalnumber
XPath: /operation/splitfinalnumber
Numeriek (2) Omdat Apple Pay Split Shipment niet ondersteunt, wordt "1" teruggestuurd om aan te geven dat het geld in één keer wordt overgemaakt.
X4-EN.png tavv
XPath: /threedsecure/tavv
Alfanumerieke & speciale tekens (32) Token Authenticatie Verificatie Waarde
X4-EN.png 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.
X4-EN.png tokenisedpayment
XPath: /billing/payment/pan/@tokenised
Numeriek (1) Deze wordt teruggestuurd met waarde 1 om aan te geven dat de transactie is verwerkt met behulp van een token.
X4-EN.png tokentype
XPath: /billing/payment/pan/@tokentype
Alfanumeriek (50) Wordt gebruikt om het type token te identificeren dat voor deze betaling wordt gebruikt (in dit geval "APPLEPAY").
X4-EN.png 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.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop de transactie werd verwerkt.
X4-EN.png 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").
X4-EN.png walletsource
XPath: /billing/payment/wallet/source
Alfanumeriek (20) Wordt gebruikt om het type portemonnee te identificeren dat voor deze betaling wordt gebruikt (in dit geval "APPLEPAY").
X2-EN.png 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.

X2-EN.png 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.

X2-EN.png 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.

X2-EN.png 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.

X2-EN.png merchantcity
XPath: /merchant/merchantcity
Alfanumeriek (127)
X2-EN.png merchantcountryiso2a
XPath: /merchant/merchantcountryiso2a
Alpha (2)
X2-EN.png merchantname
XPath: /merchant/merchantname
Alfanumeriek (255)
X2-EN.png merchantstatecode
XPath: /merchant/merchantstatecode
Alfanumeriek (127)
X2-EN.png merchantzipcode
XPath: /merchant/merchantzipcode
Alfanumeriek (10)
X2-EN.png 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.

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