MB Way voor Webservices API

  Laatst bijgewerkt: 

 

MBWeg.svg

MB Way is een toonaangevend digitaal portemonnee product in Portugal. Bij het selecteren van MB Way worden klanten gevraagd om hun in Portugal geregistreerde mobiele telefoonnummer in te voeren. Dit triggert een melding om de transactie goed te keuren vanaf de MB Way app die geïnstalleerd is op hun smartphone. Als digitale portemonnee is MB Way verantwoordelijk voor het veilig opslaan van de betaalkaartgegevens van de klant, zodat deze gemakkelijk de kaart van zijn of haar voorkeur kan selecteren bij het afrekenen. Zodra de klant de transactie heeft goedgekeurd en de gewenste kaart heeft geselecteerd, wordt de transactie uiteindelijk verwerkt en geautoriseerd door de wervende banken, net als bij standaard kaarttransacties. Na autorisatie moet de kassa een bevestigingsbericht weergeven.

  Ondersteunde landen   PT
  Ondersteunde munteenheden   EUR
  Terugbetalingen

  Volledige en gedeeltelijke terugbetaling toegestaan.

  Terugboekingen

  Betalingen zijn niet onderhevig aan terugboekingen.

  Zero-authorisation

  Niet ondersteund.

  Terugkerende betalingen

  Niet ondersteund.

 

Configuratie

Neem contact op met je accountmanager om MB Way in te schakelen op je account.
Je krijgt een test sandbox account die je nodig hebt om je implementatie te testen.

 

Procesoverzicht

  1. Initieer de klant
    • De klant gaat akkoord met een betaling via MB Way op de website van de verkoper.
    • Merchant dient AUTH verzoek in om de sessie te initiëren, inclusief de successfulurlredirect en errorurlredirect.
    • Handelaar ontvangt AUTH antwoord, inclusief redirecturl.

  2. Doorverwijzen naar MB Way
    • De handelaar stuurt de browser van de klant door naar de redirecturl.
    • De klant volgt de instructies op de gehoste pagina's van MB Way om de betaling te autoriseren.
    • Indien succesvol, wordt de browser doorgestuurd naar de successfulurlredirecteen door de handelaar gehoste pagina die de bevestiging van de betaling weergeeft.
    • Als er een probleem is geweest met de betaling, wordt de browser omgeleid naar de errorurlredirect, een door de handelaar gehoste pagina die de klant een fout weergeeft.

  3. Voltooiing van de betaling
    • Op een later tijdstip neemt MB Way contact op met Trust Payments met de bevestiging dat het geld is overgemaakt.
    • Trust Payments zal een URL-kennisgeving naar het systeem van de handelaar sturen om te bevestigen dat het geld is betaald.
    • De handelaar ontvangt de kennisgeving en antwoordt om Trust Payments te informeren dat de kennisgeving met succes is ontvangen.

 

1. Initieer de klant

Als de klant ervoor kiest om met MB Way te betalen, moet je systeem een AUTH verzoek uitvoeren en, als het succesvol is, de browser van de klant omleiden naar de URL die in het antwoord terugkomt.

 

AUTH verzoek

Het onderstaande voorbeeldverzoek is voor een MB Way AUTH verzoek:

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 = {
"currencyiso3a": "EUR",
"requesttypedescription": "AUTH",
"accounttypedescription": "ECOM",
"sitereference": "test_site12345",
"baseamount": "1050",
"paymenttypedescription": "MBWAY",
"successfulurlredirect": "https://yourwebsite.com",
"errorurlredirect": "https://yourwebsite.com",
"billingfirstname": "Joe",
"billinglastname": "Bloggs",
"billingcountryiso2a": "PT",
"billingtelephone": "01234567890"
}

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

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

 

Specificatie veld

  Field Formaat Beschrijving
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Alleen "ECOM" (e-commerce) wordt ondersteund.
X1-EN.png baseamount
XPath: /billing/amount
Numeriek (13) Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus €10 wordt ingediend als 1000. Deze waarde moet groter zijn dan nul. (De maximumlengte kan variëren, afhankelijk van uw wervende bank - Neem contact op met uw bank voor meer informatie)
X2-EN.png billingprefixname
XPath: /billing/name/prefix
Alfanumeriek, inclusief
symbolen (25)

Het voorvoegsel van de factuurnaam van de klant (bv. De heer, Juffrouw, Dr.).

Ten minste één van de velden met de factureringsnaam is verplicht.

X2-EN.png billingfirstname
XPath: /billing/name/first
Alfanumeriek, inclusief
symbolen (127)

De klant Voornaam facturatie.

Ten minste één van de velden met de factureringsnaam is verplicht.

X2-EN.png billingmiddlename
XPath: /billing/name/middle
Alfanumeriek, inclusief
symbolen (127)

De middelste factureringsnaam of -namen van de klant.

Ten minste één van de velden met de factureringsnaam is verplicht.

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

De klant Achternaam facturatie.

Ten minste één van de velden met de factureringsnaam is verplicht.

X2-EN.png billingsuffixname
XPath: /billing/name/suffix
Alfanumeriek, inclusief
symbolen (25)

Het achtervoegsel van de factureringsnaam van de klant (bv. Bsc).

Ten minste één van de velden met de factureringsnaam is verplicht.

X1-EN.png billingcountryiso2a
XPath: /billing/country
Alpha (2)

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

Voor een lijst met landcodes die door MB Way worden ondersteund, raadpleeg je de lijst bovenaan deze pagina.

X3-EN.png billingtelephone
XPath: /factuur/telefoon
Alfanumeriek, inclusief
symbolen (20)

Telefoonnummer van de klant. Geldige tekens:

  • Cijfers 0-9
  • Ruimtes
  • Speciale tekens: + - ( )
X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

De Munt waarin de transactie zal worden verwerkt (in ISO3A-formaat).

Voor een lijst met Munt codes die door MB Way worden ondersteund, raadpleeg je de lijst bovenaan deze pagina.

X1-EN.png errorurlredirect
XPath: /merchant/errorurlredirect
URL (2048) De URL waar de klant naar wordt teruggestuurd na een fout op de pagina's gehost door MB Way.
X3-EN.png orderreference
XPath: /merchant/orderreference
Alfanumeriek, inclusief symbolen (25)

 

Aanbevolen lengte 25 tekens of minder (exacte lengte afhankelijk van de wervende bank). Niet-naleving van deze eis kan ertoe leiden dat de tekst in de transactie wordt ingekort.

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.
X1-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Deze waarde moet worden ingediend als "MBWAY".
X1-EN.png requesttypedescription
XPath: /@type
Alpha (20) De waarde in het verzoek moet "AUTH" zijn.
X1-EN.png sitereference
XPath: /operation/sitereference
Alfanumeriek
& underscore (50)
De site referentie heeft betrekking op uw individuele account die u bij de installatie hebt ontvangen. Als u uw site referentie niet kent, neem dan contact op met ons Support Team.
X1-EN.png successfulurlredirect
XPath: /merchant/successfulurlredirect
URL (2048) De URL waar de klant naar wordt teruggestuurd na een succesvolle autorisatie door MB Way.

 

AUTH antwoord

Python PHP Ruwe JSON Ruwe XML
{
u'requestreference': u'An3ug1kap',
u'version': u'1.00',
u'responses': [{
u'transactionreference': u'23-86-113',
u'merchantname': u'Test Merchant',
u'paymenttypedescription': u'MBWAY',
u'settleduedate': u'2017-03-16',
u'baseamount': u'1050',
u'transactionstartedtimestamp': u'2017-03-16 16:25:08',
u'errormessage': u'Ok',
u'settlestatus': u'10',
u'accounttypedescription': u'ECOM',
u'errorcode': u'0',
u'redirecturl': u'https://example.com',
u'acquirertransactionreference': u'12',
u'acquirersecret': u'q9gy5ppgdyd5fh60kfe2j0f26peu2xww',
u'requesttypedescription': u'AUTH',
u'acquirerresponsemessage': u'PENDING',
u'operatorname': u'webservices@example.com',
u'livestatus': u'0',
u'currencyiso3a': u'EUR'
}]
}

 

Specificatie veld

  Veld Formaat Beschrijving
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De geretourneerde waarde is "ECOM".
X2-EN.png acquirerresponsemessage
XPath: /acquirerresponsemessage
Alfanumeriek (255) Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven.
X4-EN.png acquirersecret
XPath: /acquirersecret
Alfanumeriek (64) Gebruikt door Trust Payments om het antwoord van de verwerver te verifiëren. (Uw systeem hoeft dit niet te verifiëren)
X4-EN.png acquirertransactionreference
XPath: /acquirertransactionreference
Alfanumeriek, inclusief symbolen (127) Uniek Transactiereferentie toegewezen door MB Way.
X4-EN.png baseamount
XPath: /billing/amount
Numeriek (13) Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus €10 wordt geretourneerd als 1000.
X4-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

De Munt waarin de transactie werd verwerkt (in ISO3A-formaat).

Voor een lijst met Munt codes die door MB Way worden ondersteund, raadpleeg je de lijst bovenaan deze pagina.

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 (errorcode) niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X2-EN.png errordata
XPath: /error/data
Alfanumeriek (255) Aanvullende informatie om te helpen bij het oplossen van de fout.
X4-EN.png errormessage
XPath: /error/message
Alfanumeriek (255) Dit is het bericht dat overeenkomt met de bovenstaande code.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.

X4-EN.png livestatus
XPath: /live
Numeriek (1)
  • 0 - Transactie verwerkt met een testrekening.
  • 1 - Transactie verwerkt met een live rekening.
X2-EN.png merchantname
XPath: /merchant/merchantname
Alfanumeriek (255)

Dit zijn gegevens die verband houden met de rekening die is gebruikt om de transactie te verwerken.

Om deze velden te wijzigen, gelieve neem contact op met ons Support Team.

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) Deze geretourneerde waarde is "MBWAY".
X4-EN.png redirecturl
XPath: /other/redirecturl
URL (255) Stuur de browser van de klant door naar deze URL zodat ze de betaling kunnen voltooien op pagina's gehost door MB Way.
X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) De geretourneerde waarde is "AUTH".
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) Hiermee kunt u de status van de betaling bepalen. Raadpleeg het gedeelte " Omgaan met het antwoord " hieronder voor informatie over hoe u dit veld het best kunt interpreteren.
X4-EN.png transactionreference
XPath: /transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor de transactie, toegewezen door Trust Payments.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop de transactie werd verwerkt.

 

Behandeling van het antwoord

De settlestatus die wordt teruggestuurd in het antwoord AUTH wordt gebruikt om de status van de MB Way betaling te bepalen:

Als de settlestatus "10" is, is de betaling in behandeling. afwikkeling

  • Het geld is nog niet op uw bankrekening gestort.
  • De volgende stap is om de browser van de klant door te sturen naar de redirecturl om de betaling te voltooien.

Het geld wordt pas op je rekening gestort als de klant wordt doorgestuurd naar de pagina's van MB Way om de betaling te voltooien. Lees verder voor meer informatie.

  • Wanneer er een update is over settle-status van de AUTH, zult u een URL-notificatie ontvangen om u te informeren dat de status betaling is bijgewerkt tot "3" of "100".
  • Nadere informatie over de kennisgevingen is hieronder te vinden.

Indien de settlestatus "3" is, is de betaling geannuleerd

Naast het bovenstaande bevelen wij ook aan na de betaling aanvullende controles te verrichten.

 

2. Doorverwijzen naar MB Way

Uw systeem moet de browser van de klant omleiden naar de redirecturlDit is een pagina gehost door MB Way, om de betaling te verwerken. Op een later tijdstip wordt de klant teruggeleid naar de successfulurlredirect of de errorurlredirect in het AUTH verzoek.

  Als de klant wordt doorverwezen naar de successfulurlredirect:

De klant heeft de vereiste stappen op de pagina's van MB Way succesvol doorlopen.
Aanbevolen acties: Bevestiging weergeven dat de betaling succesvol was.

  Als de klant wordt doorverwezen naar de errorurlredirect:

De klant heeft een probleem ondervonden waardoor hij de betaling niet heeft kunnen voltooien.
Aanbevolen acties: Informeer de klant dat er een probleem was met de betaling, waarbij voldoende transactiedetails worden weergegeven zodat de klant de betalingspoging kan navragen.

  Tijdens het testen krijg je de zandbak te zien die door MB Way wordt aangeboden. Om een testtransactie te voltooien, moet u de instructies op het scherm volgen. Neem contact op met uw accountmanager voor testgegevens die u kunt invoeren in de zandbak.

 

3. Voltooiing van de betaling

Zodra de klant terugkeert van de MB Way hosted pagina naar de successfulurlredirect of errorurlredirect gehoste pagina op uw site, moet u respectievelijk een bevestigingsbericht of foutbericht weergeven.

Controleer of er regels voor URL-omleidingen zijn ingeschakeld in de MyST Regelbeheer op uw site referentie(s), aangezien deze in strijd kunnen zijn met en voorrang kunnen hebben op de successfulurlredirect en errorurlredirect velden in het AUTH verzoek.

Zodra een betaling is geautoriseerd, zal het geld op een later tijdstip worden verrekend, zoals bepaald door MB Way.

  Het afwikkeling proces voor MB Way wijkt af van het standaard proces dat gevolgd wordt bij betaalmethodes met kaarten.

  De afwikkeling kennisgeving mag niet onmiddellijk na de verwerking van de AUTH

In het onwaarschijnlijke geval dat de betaling na 7 dagen nog steeds in behandeling is op afwikkeling (settlestatus "10"), wordt dit ingepland voor onderzoek en nemen we contact met u op voor meer informatie.

Voordat u begint met testen, raden wij u aan contact op te nemen met ons Support Team en te verzoeken dat regels worden ingeschakeld op uw account, die URL-kennisgevingen naar uw systeem sturen in de volgende scenario's:

  • Wanneer een betaling is goedgekeurd.
  • Als de fondsen vereffend zijn.

 

Configuratie van de autorisatie melding

Wij raden u aan ten minste de volgende velden op te nemen in uw autorisatie kennisgeving:

  • Antwoordbericht aankoper (acquirerresponsemessage)
  • Basisbedrag (baseamount) (b.v. €10,50 is "1050")*.
  • Hoofdbedrag (mainamount) (b.v. €10,50 is "10.50")*
  • Land facturatie (billingcountryiso2a)
  • Munt (currencyiso3a)
  • Foutcode (errorcode)
  • Live Status (livestatus)
  • Referentie bestelling (orderreference)
  • Betalingstype (paymenttypedescription)
  • Verzoektype (requesttypedescription)
  • Status betaling (settlestatus)
  • Site referentie (sitereference)
  • Transactiereferentie (transactionreference)
  • Tijdstempel start transactie (transactionstartedtimestamp)

*Kies uw voorkeursformaat.

 

Configuratie van de afwikkeling melding

Wij raden u aan de volgende velden op te nemen in uw afwikkeling kennisgeving:

  • Status betaling (settlestatus)
  • Site referentie (sitereference)
  • Transactiereferentie (transactionreference)

 

Controleer de kennisgeving

U moet de inhoud van elke ontvangen kennisgeving controleren en dienovereenkomstig reageren door de procedures te volgen die in onze URL-kennisgevingen documentatie. In het bijzonder moet u kijken naar de bijgewerkte settlestatus waarde:

  • Op autorisatie: Als de settlestatus "0", "1" of "10" is, is de betaling geautoriseerd en hoeft u op dit moment geen verdere actie te ondernemen. Waarden van "2" of "3" geven echter aan dat de fondsen niet gepland voor vereffening (respectievelijk opgeschort en geannuleerd).
  • Op afwikkeling: Als de settlestatus is bijgewerkt tot "100", betekent dit dat het geld is vereffend. Als dit is bijgewerkt tot "3", is er een probleem geweest en is de betaling geannuleerd.

Geannuleerde transacties (settlestatus "3") kunnen op een later tijdstip worden afgewikkeld. In situaties waarin de klant de stappen heeft voltooid die nodig zijn om de betaling uit te voeren, wordt de settlestatus bijgewerkt tot "100" om aan te geven dat de fondsen naar uw rekening zijn overgemaakt.

Als u contact hebt opgenomen met het Support Team om afwikkeling meldingen te configureren (zoals hierboven beschreven), wordt u op de hoogte gebracht wanneer dit gebeurt.

 

Test

U moet uw oplossing testen voordat u live betalingen kunt gaan verwerken. Testtransacties worden verwerkt via uw test site referentie.

  Vereisten

Je dient contact op te nemen met ons Support Team en je MB Way test account gegevens door te geven. Wij configureren dan je test site referentie om direct verbinding te maken met de MB Way testomgeving.

Bij het uitvoeren van testtransacties zal de redirect URL in het AUTH antwoord je browser omleiden naar de MB Way testomgeving om een betaling te simuleren. Verder is het proces precies hetzelfde als het verwerken van live betalingen.

 

Terugbetalingen

Na het verwerken van een betaling met MB Way is het mogelijk om de klant terug te betalen door een REFUND verzoek in te dienen.

Restituties voor MB Way worden onmiddellijk verrekend (settlestatus "100").

 

Vereisten

  • U kunt een betaling pas terugstorten wanneer de AUTH is vereffend (settlestatus op "100" staat).
  • U kunt niet een hoger bedrag terugbetalen dan oorspronkelijk was verrekend.

Het REFUND verzoek en antwoord voor MB Way betalingen volgen dezelfde veldspecificatie als beschreven in onze standaard REFUND documentatie. Klik hier voor meer informatie.

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