Pay by Bank Webservices

  Laatst bijgewerkt: 

Dit artikel is alleen rechtstreeks via de URL te openen.

Pay by Bank ook bekend als Account to Account A2A) is een betaalmethode via bankoverschrijving. Trust Payments Pay by Bank een verwerkingspartner die is geautoriseerd door de financiële toezichthouders in het Verenigd Koninkrijk en de EER (Europese Economische Ruimte). Wanneer klanten Pay by Bank het afrekenen kiezen voor Pay by Bank , worden ze doorgestuurd naar een pagina die wordt gehost door onze verwerkingspartner, waar ze worden gevraagd hun bank te selecteren. De bank bepaalt de volgende stappen die de klant moet ondernemen om de betaling te autoriseren, maar doorgaans wordt de klant gevraagd om een vorm van SCA Strong Customer Authentication) uit te voeren, bijvoorbeeld het controleren en goedkeuren van de bestelling via een bankapp die op hun apparaat is geïnstalleerd. Zodra ze akkoord gaan met de betaling, wordt de klant uiteindelijk teruggeleid naar uw website. Geautoriseerde bedragen worden overgemaakt naar uw virtuele afwikkeling .

Ondersteunde landen GB
Ondersteunde munteenheden GBP
Terugbetalingen Niet ondersteund.
Terugboekingen Betalingen zijn niet onderhevig aan terugboekingen.
Zero-authorisation Niet ondersteund.
Terugkerende betalingen Niet ondersteund.

 

Vereisten

  • Voordat u aan de slag gaat, moet u contact opnemen met ons ondersteuningsteam en vragen of Pay by Bank voor uw account Pay by Bank ingeschakeld.
  • Als onderdeel van dit proces zullen we samen met u een URL-kennisgeving afwikkeling instellen. Dit is nodig om uw systeem te laten weten dat het geld op uw virtuele afwikkeling is bijgeschreven, zodat u goederen en diensten veilig naar klanten kunt verzenden.
  • Voor testdoeleinden zullen we eerst uw site referentie Pay by Bank configureren. De site referentie gekoppeld aan de Pay by Bank van een betrouwbare derde partij, zodat u uw oplossing kunt testen voordat deze live gaat. Zodra u klaar bent om live te gaan, kunnen we Pay by Bank uw site referentie inschakelen.

 

Procesoverzicht

  1. Start de betalingssessie

    • De klant gaat akkoord met een betaling via Pay by Bank op de website van de verkoper.
    • Merchant dient AUTH verzoek in om de sessie te starten, inclusief de returnurl.
    • Merchant ontvangt AUTH antwoord, inclusief redirecturl.

  2. Redirect naar inlogpagina bank

    • Merchant stuurt de browser van de klant door naar de redirecturl. Dit is een pagina gehost door een Trust Payments verwerkingspartner, die de klant vraagt zijn bank te selecteren.
    • De klant wordt vervolgens doorgestuurd naar pagina’s die door de door hem of haar gekozen bank worden gehost, waar hij of zij wordt gevraagd om in te loggen, de bestelgegevens te controleren en de transactie te autoriseren.

  3. De sessie afsluiten

    • Zodra de klant klaar is met de pagina’s van zijn bank, wordt zijn browser doorgestuurd naar de returnurl, een pagina die door de handelaar wordt gehost, via een GET-verzoek.
    • De handelaar moet de waarde van de settlestatus (zoals hieronder uitgelegd).
    • De verkoper toont de juiste succes- of foutmelding op de webpagina.
      Een succesvolle bestelling betekent niet automatisch dat het bedrag op de virtuele afwikkeling van de handelaar wordt bijgeschreven. Lever geen goederen of diensten aan de klant voordat u een afwikkeling hebt ontvangen.

  4. afwikkeling
    • Op voorwaarde dat afwikkeling naar behoren zijn ingeschakeld, ontvangt de handelaar een URL-kennisgeving Trust Payments settlestatus. Dit geeft aan dat het geld op de virtuele afwikkeling van de handelaar is bijgeschreven, in afwachting van de overboeking naar zijn bank, en dat het veilig is om de klant goederen of diensten te leveren.
    • In deze fase raden we verkopers aan om de klant een e-mail te sturen waarin ze worden geïnformeerd over de wijziging in de status van hun bestelling. Bijvoorbeeld: als settlestatus`, kan de klant worden geïnformeerd dat het door hem of haar bestelde product is verzonden.

 

Start de betalingssessie

Wanneer de klant ervoor kiest om te betalen met Pay by Bank, moet uw systeem een AUTH verzoek uitvoeren en, indien succesvol, de browser van de klant omleiden naar de URL die wordt geretourneerd in het antwoord.

Verderop in dit artikel geven we aanbevelingen voor het presenteren van Pay by Bank op je kassa en tips voor het verbeteren van de klantbetrokkenheid.

 

AUTH verzoek

Het onderstaande voorbeeldverzoek is voor een Pay by Bank 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 = {
  "requesttypedescription": "AUTH",
  "sitereference": "test_site12345",
  "accounttypedescription": "ECOM",
  "returnurl": "https://www.example.com/success",
  "baseamount": "1050",
  "currencyiso3a": "GBP",
  "paymenttypedescription": "ATA"
}

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

Vervang <DOMAIN> met een ondersteund domein. Bekijk de volledige lijst met domeinen.

 

Specificatie veld

  Veld Formaat Beschrijving
Verplicht accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Alleen "ECOM" (e-commerce) wordt ondersteund.
Verplicht baseamount
XPath: /billing/amount
Numeriek (13) Het bedrag van de transactie in basiseenheden, zonder komma of decimaalteken, 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)
Verplicht currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

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

Raadpleeg de lijst bovenaan deze pagina voor een lijst met Munt codes die worden ondersteund door Pay by Bank.

Verplicht paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Deze waarde moet worden ingediend als "ATA".
Verplicht requesttypedescription
XPath: /@type
Alpha (20) De waarde in het verzoek moet "AUTH" zijn.
Verplicht returnurl
XPath: /merchant/returnurl
URL (2048) De URL waarnaar de klant wordt doorgestuurd zodra hij klaar is op de pagina’s van zijn bank, ongeacht het resultaat.
Verplicht sitereference
XPath: /operation/sitereference
Alfanumeriek
& underscore (50)
De site referentie op uw individuele account die u bij de installatie hebt ontvangen. Als u uw site referentie niet weet, neem dan contact op met ons ondersteuningsteam.
Optioneel 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.

 

AUTH antwoord

Python PHP Ruwe JSON Ruwe XML
{
  'requestreference': 'An3ug1kap',
  'version': '1.00',
  'responses': [{
    'requesttypedescription': 'AUTH',
    'baseamount': '1050',
    'currencyiso3a': 'GBP',
    'paymenttypedescription': 'ATA',
    'errorcode': '0',
    'errormessage': 'Ok',
    'livestatus': '0',
    'merchantcountryiso2a': 'GB',
    'merchantname': 'Test Merchant',
    'operatorname': 'webservices@example.com',
    'accounttypedescription': 'ECOM',
    'redirecturl': 'https://web-app.sandbox.token.io/app/request-token/rq:xxx:yyy',
    'settleduedate': '2022-02-09',
    'settlestatus': '10',
    'transactionstartedtimestamp': '2022-02-09 15:43:49',
    'transactionreference': '1-2-345'
  }]
}

 

Specificatie veld

  Veld Formaat Beschrijving
Geretourneerd accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) De geretourneerde waarde is "ECOM".
Geretourneerd baseamount
XPath: /billing/amount
Numeriek (13) Het transactiebedrag in basiseenheden, zonder komma’s of decimalen; £10 wordt dus weergegeven als 1000.
Geretourneerd currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

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

Raadpleeg de lijst bovenaan deze pagina voor een lijst met Munt codes die worden ondersteund door Pay by Bank.

Geretourneerd 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, was de transactie niet succesvol.

Bekijk de volledige lijst van errorcode en berichtwaarden.

Geretourneerd errormessage
XPath: /error/message
Alfanumeriek (255)

Dit is het bericht dat overeenkomt met de bovenstaande code.

Bekijk de volledige lijst van errorcode en berichtwaarden.

Geretourneerd livestatus
XPath: /live
Numeriek (1)
  • 0 - Transactie verwerkt met een testrekening.
  • 1 - Transactie verwerkt met een live rekening.
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) De teruggezonden waarde is "ATA".
Geretourneerd redirecturl
XPath: /other/redirecturl
URL (255) Stuur de browser van de klant door naar deze URL, die wordt gehost door een Trust Payments verwerkingspartner, zodat de klant de betaling kan voltooien.
Geretourneerd requesttypedescription
XPath: /@type
Alpha (20) De geretourneerde waarde is "AUTH".
Geretourneerd settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-DD De datum waarop de transactie zal worden afgewikkeld.
Geretourneerd settlestatus
XPath: /settlement/settlestatus
Numeriek (3) Hiermee kunt u de status van de betaling vaststellen. Raadpleeg het gedeelte'Omgaan met AUTH hieronder voor informatie over hoe u dit veld het beste kunt interpreteren.
Geretourneerd transactionreference
XPath: /transactionreference
Alfanumeriek, inclusief
koppeltekens (25)
Een unieke referentie voor de transactie, toegewezen door Trust Payments.
Geretourneerd transactionstartedtimestamp
XPath: /timestamp
Datum tijd JJJJ-MM-DD hh:mm:ss Het tijdstip waarop de transactie werd verwerkt.
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 merchantcountryiso2a
XPath: /merchant/merchantcountryiso2a
Alpha (2)

Dit zijn gegevens die betrekking hebben op het account dat is gebruikt om de transactie te verwerken. Om deze velden aan te passen, kunt u contact op met ons supportteam.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.

 

Conditioneel merchantname
XPath: /merchant/merchantname
Alfanumeriek (255)

 

Omgaan met het AUTH

De settlestatus teruggestuurd in het antwoord AUTH wordt gebruikt om de status van de betaling Pay by Bank te bepalen:

  Als settlestatus=10,
de klant is klaar om doorgestuurd te worden

  • De browser van de klant omleiden naar de redirecturl zodat hij de transactie kan autoriseren.
  • U ontvangt pas geld zodra de klant deze autorisatie heeft ondertekend.

  Als settlestatus=3,
de betaling is geannuleerd

  • De betaling is geweigerd of er is een fout opgetreden.
  • Controleer de errorcode om de reden vast te stellen. Bijvoorbeeld: „70000“ = Afgewezen. Volledige lijst met foutcodes.
  • We raden aan om een foutmelding weer te geven en andere betaalmethoden aan te bieden, zodat de klant het opnieuw kan proberen.

 

De status van de transactie controleren


Zodra u het AUTH hebt ontvangen, kan uw systeem de status van een Pay by Bank opvragen door een TRANSACTIONQUERY in te dienen via onze Webservices . De enige velden die u in het filter moet opnemen, zijn de sitereference en transactionreference die bij de AUTH horen. Bijvoorbeeld:

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONQUERY"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"55-9-12345"}]
    }
  }]
}

  Meer informatie over verzoeken om transactiegegevens


Controleer in het antwoord de settlestatus om de transactiestatus te bepalen:

Betaling

Als settlestatus 10 is,
dan is de klant doorgestuurd naar zijn bank om de transactie te autoriseren.

 

Betaald

Als settlestatus 100,
dan staat het geld na autorisatie nu op uw virtuele afwikkeling .

 

Geannuleerd

Als settlestatus 3 is, betekent dit dat de klant de transactie niet heeft geautoriseerd (
) of dat er een fout is opgetreden.

 

 

Redirect naar inlogpagina bank

Uw systeem moet de browser van de klant omleiden naar de redirecturl, een pagina gehost door een Trust Payments verwerkingspartner, om de betaling te verwerken.

Daarbij wordt de klant doorverwezen naar pagina's van zijn bank, waar hij wordt gevraagd in te loggen op zijn rekening en de transactie te autoriseren.

  De redirecturl binnen een iframe. Hierdoor wordt de inhoud niet correct weergegeven en kan de betaling uiteindelijk niet succesvol worden afgerond.

  Tijdens het testen toont de browser de sandbox-omgeving. Om een testtransactie te voltooien, moet de gebruiker de rol van klant op zich nemen en de instructies op het scherm volgen. Dit houdt doorgaans in dat de gebruiker de door uw accountmanager verstrekte testgegevens invoert en/of de gewenste uitkomst van de transactie selecteert uit de opties die op het scherm worden weergegeven.


Voer tijdens het testen geen echte kaart- of bankgegevens in!

Zodra de klant de transactie bij zijn bank heeft geautoriseerd, wordt zijn browser doorgestuurd naar de returnurl die in het AUTH is opgenomen.

 

De sessie afsluiten

De klant keert terug van de pagina’s die door zijn bank worden gehost naar de returnurl gehost op uw site, in de vorm van een GET-verzoek met de hieronder beschreven velden:

  Veld Formaat Beschrijving
Geretourneerd orderreference Alfanumeriek, inclusief
symbolen (25)

Uw unieke bestelreferentie opgeslagen op het Trust Payments systeem.

Dit veld wordt leeg teruggestuurd indien het is weggelaten uit het AUTH verzoek.

Geretourneerd settlestatus Numeriek (3) 
 
Hiermee kunt u de status van de transactie vaststellen. Raadpleeg het gedeelte'Omgaan met returnurlhieronder voor informatie over hoe u dit veld het beste kunt interpreteren.
Geretourneerd transactionreference Alfanumeriek, inclusief
koppeltekens (25)
Unieke referentie van de transactie, beschikbaar nadat een betalingsverzoek is verwerkt. U moet dit gebruiken in een volgend TRANSACTIONQUERY verzoek met onze Webservices API om de huidige status van de betaling vast te stellen, zoals hieronder beschreven.
 

 

Het verwerken van de returnurl

De settlestatus teruggestuurd in de returnurl wordt gebruikt om de huidige status van de Pay by Bank te bepalen:

  Als settlestatus=10, heeft de klant toestemming gegeven voor de transactie

  • De transactie is door de klant goedgekeurd, maar afwikkeling nog niet voltooid.
  • Pay by Bank afwikkeling duurtafwikkeling slechts enkele minuten, maar kan ook langer duren (tot 2 dagen).
  • We raden aan om de melding "Bestelling geslaagd" weer te geven en de klant een bevestigingsmail te sturen.
  • Uw server wacht op eenURL-kennisgeving goederen of diensten worden geleverd.
  Wij raden u af om goederen of diensten aan de klant te leveren voordat het geld op uw rekening is bijgeschreven.

  Als settlestatus=100, de transactie is al afgewikkeld

  • De transactie is afgerond. U kunt de klant nu gerust goederen of diensten leveren.
  • We raden aan om een succesmelding weer te geven en de klant een bevestigingsmail te sturen.
  • Uw server moet nog steeds luisteren naar en reageren op de URL-kennisgeving zoals hieronder wordt uitgelegd).

  Als settlestatus=3, de betaling is geannuleerd

  • De betaling is geweigerd of er is een fout opgetreden.
  • We raden aan om een foutmelding weer te geven en andere betaalmethoden aan te bieden, zodat de klant het opnieuw kan proberen.

 

afwikkeling

  Houd er rekening mee dat u alleen een melding over afwikkeling ontvangt afwikkeling dit door ons Supportteam is ingesteld. Om meldingen in te schakelen, zullen zij aparte regels instellen voor uw test- en sitereferenties worden geactiveerd na de afwikkeling Pay by Bank .

Uw server moet luisteren naar afwikkeling die door Trust Payments worden verzonden. Deze worden verzonden in de vorm van POST-verzoeken, waarop uw server zo snel mogelijk moet reageren met een HTTP 200 OK-antwoord om de ontvangst te bevestigen.

  Meer informatie over URL-kennisgevingen

De belangrijkste velden die u in de kennisgeving moet controleren, zijn:

  • transactionreference — Unieke referentie toegekend door Trust Payments de transactie identificeert.
  • settlestatus — De status van de transactie:
    • Als settlestatus is, is het geld op uw virtuele afwikkeling bijgeschreven en wordt het binnenkort naar uw bank overgemaakt. U kunt de door de klant bestelde goederen of diensten nu met een gerust hart verzenden.
    • Als settlestatus is, is er een fout opgetreden waardoor afwikkeling niet is gelukt. U moet de klant laten weten dat er een probleem is geweest met zijn bestelling en hulp aanbieden om het probleem naar tevredenheid op te lossen.
Wat is een virtuele afwikkeling ?

In dit verband bedoelen we met afwikkeling virtuele afwikkeling een speciale rekening die wordt aangehouden door een Trust Payments en namens u wordt beheerd. Deze rekening wordt gebruikt om uw transactiegelden te verzamelen en vast te houden voordat ze worden overgemaakt naar de door u opgegeven bankrekening. Als de klant de transactie met succes bij zijn bank heeft geautoriseerd, wordt de transactiestatus bijgewerkt naar Status betaling = 100, zodra het geld de virtuele afwikkeling heeft bereikt.

Wanneer kan ik verwachten dat het geld op mijn bankrekening staat?

Zodra de Status betaling voor een bepaalde transactie 100 is, kunt u verwachten dat het geld binnen 24 uur wordt overgemaakt, meestal 's nachts.

Wat gebeurt er als de klant de overschrijving niet bij zijn bank goedkeurt?

Als onderdeel van het standaardpakket Pay by Bank moet de klant inloggen op zijn online bankrekening of bankapp, de aankoopgegevens controleren en de overschrijving autoriseren. Zoals bij elk afrekenproces is het heel goed mogelijk dat de klant vertraging oploopt of deze stappen niet voltooit. Het kan bijvoorbeeld zijn dat hij zijn bankpincode of wachtwoord is vergeten, of dat hij gewoon van gedachten is veranderd.

Wat de reden ook is, de klant kan het later altijd nog eens proberen, waardoor er een nieuwe transactie met een andere Transactiereferentie. Pay by Bank transacties die zijn afgebroken in Status betaling = 10 worden na 7 dagen automatisch geannuleerd.

Kan ik een lopende Pay by Bank annuleren?

Nee, hoewel de klant altijd de vrijheid heeft om van gedachten te veranderen en een andere betaalmethode te kiezen of het afrekenproces helemaal te verlaten voordat hij de overschrijving goedkeurt.

 

De klantervaring ontwerpen

Aangezien uw klanten wellicht nog niet bekend zijn met Pay by Bank en niet weten hoe dit hun afrekenproces kan vereenvoudigen, raden wij u aan dit bij het afrekenen extra onder de aandacht te brengen en te benadrukken hoe gemakkelijk Pay by Bank . Uit onderzoek blijkt namelijk dat klanten eerder geneigd zijn om nieuwe betaalmethoden te gebruiken — met name als uw klant via zijn mobiele apparaat afrekent, kan hij de aankoop afronden via de bankapp die op dat apparaat is geïnstalleerd, waardoor hij geen kaartgegevens hoeft in te voeren. Het proces is heel eenvoudig: de klant hoeft alleen maar in te loggen op zijn bankapp om de transactie te autoriseren. Meestal moet hij daarbij een pincode invoeren of de app ontgrendelen met biometrische authenticatie, zoals een ingebouwde vingerafdruklezer of gezichtsherkenning.

We raden u ook aan om klanten die ervoor hebben gekozen om via Pay by Bank te betalen, te vragen of ze ermee instemmen hun bankgegevens met Trust Payments te delen Trust Payments hun bank hierom vraagt, zodat de backoffice-processen soepeler kunnen verlopen.

 

Je transacties beheren in Portal

Net als bij elke andere betaalmethode kunnen alle Pay by Bank transacties worden bekeken en beheerd binnen Portal. Houd bij het werken met Pay by Bank transacties rekening met het volgende:

Houd er rekening mee dat Pay by Bank in Portal vaak Pay by Bank weergegeven Portal Pay by Bank’, met een groene achtergrond, maar dat het ook kan worden weergegeven alsAccount to account’.

 

Test

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

  Vereisten

U moet contact opnemen met ons Support Team en vragen dat uw test site referentie wordt geconfigureerd om rechtstreeks verbinding te maken met de sandbox-omgeving. Test frameworks en sandboxes worden individueel geregeld met elk van onze deelnemende merchants.

Bij het uitvoeren van testtransacties zal de redirect URL in het antwoord op AUTH je browser omleiden naar de sandboxomgeving om het betaalproces op Pay by Bank te simuleren. We zullen je voorzien van testgegevens die je nodig hebt om door de interface te gaan.

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