Testen

De Twikey beta-omgeving maakt het mogelijk om echte betalings- en ondertekeningsflows te simuleren zonder echt geld of echte data te gebruiken. Deze handleiding behandelt alles wat nodig is om de integratie end-to-end te testen voor de livegang.

Transactieresultaten

Elke 30 minuten draait een taak die bankfeedback op openstaande transacties simuleert. Het resultaat wordt bepaald door het transactiebedrag, waardoor het eenvoudig is om specifieke statussen in de aanmaningsconfiguratie te triggeren.

Om het gedrag van een echte bank na te bootsen, is de eerste feedback altijd PAID. Het werkelijke resultaat wordt geretourneerd bij de tweede uitvoering van de taak.

Gebruik deze bedragen om de flows voor mislukte betalingen en aanmaningsstappen te verifieren.

Aanmaning

Wachtperiodes die in aanmaningsstappen zijn gedefinieerd, worden gecomprimeerd in de beta-omgeving: elke dag wordt een minuut. Hierdoor kan de volledige aanmaningsreeks worden geverifieerd zonder dagen te wachten tussen stappen. Hoe korter de geconfigureerde wachtperiode, hoe sneller de volgende aanmaningsstap wordt getriggerd.

Overschrijvingen

Een overschrijving kan worden gesimuleerd om automatische en handmatige betalingsmatching te testen. Vervang het IBAN in de header door een werkelijke rekening van een van de bankgateways en maak vervolgens een CSV-bestand aan met het volgende formaat:

twikey:BE123456789123 name;iban;bic;msg;amount John Doe;BE31798258915655;GKCCBEBB;My product;100

Opmerking: bedragen zijn in centen.

Upload het bestand via Reconciliation - Upload account info. De bestandsnaam moet uniek zijn bij elke upload.

Voor automatische factuurmatching moet het msg-veld overeenkomen met de betalingsreferentie van een bestaande factuur, en het amount moet exact overeenkomen. Wanneer aan beide voorwaarden is voldaan, wordt de factuur als betaald gemarkeerd, wat de werkelijke reconciliatieregels weerspiegelt.

B2B-mandaatacceptatie

Elke 30 minuten draait een taak die de bankacceptatie of -weigering van B2B-mandaten simuleert. Het resultaat hangt af van het laatste cijfer van het IBAN:

• Even laatste cijfer: mandaat geaccepteerd
• Oneven laatste cijfer: mandaat geweigerd

Dit geldt niet voor Belfius (BIC: GKCCBEBB) en BNP (BIC: GEBABEBB) rekeningen, die een andere flow volgen.

Voor geautomatiseerd testen geven deze IBANs voorspelbare resultaten:

Alleen verbonden banken. Voor Nederlandse B2B-ondertekening kunnen resultaten worden gesimuleerd via iDEAL/eMachtiging (zie hieronder). Voor niet-verbonden banken zijn alleen de print- en markeer-als-ondertekend-flows beschikbaar.

B2B-validatie voor niet-verbonden banken

Elke niet-verbonden B2B-rekening kan worden gebruikt - het gedrag wordt altijd bepaald door het laatste cijfer van het IBAN.

Feedback simuleren

De taak moet twee keer worden uitgevoerd om een definitief resultaat te produceren, overeenkomstig het gedrag van echte banken. Bij succesvolle validaties wordt een opvolgtaak ingepland die na 4 uur wordt uitgevoerd om het mandaat als geaccepteerd te markeren. Het gebruik van een IBAN dat eindigt op 00 slaat de vertraging over en ondertekent het mandaat onmiddellijk na de tweede taakuitvoering.

Opmerking: Door de ingeplande validatietaak kan een extra webhook worden ontvangen voor hetzelfde mandaat. Dit is verwacht gedrag in beta en komt niet voor in productie.

Ondertekenmethoden

iDEAL, eMachtiging en iDIN

Neem contact op met de customer success agent om het template te koppelen aan een testbank. Geef het template-ID en de ondertekenmethode door die getest moet worden.

Bij het gebruik van iDIN voor ondertekening of identificatie worden de klantgegevens automatisch overschreven om data te simuleren die in productie door iDIN zou worden geretourneerd. Dit gedrag kan worden uitgeschakeld of aangepast door de customer success agent.

Een vertraging kan ook worden geconfigureerd voor deze methoden. De vertraging wordt toegepast in de backend - aan de frontendzijde gaat de klant onmiddellijk door naar de verificatiepagina, en het transactieresultaat wordt bevestigd bij de volgende periodieke uitvoering.

Overige ondertekenmethoden

eID: gebruik een persoonlijke eID-kaart.

Bankkaarten (Maestro): gebruik een geldig kaartnummer, bijv. 4111111111111111. Het resultaat hangt af van de vervalmaand:

SMS: bij het uitnodigen van een klant om via SMS te ondertekenen, wordt een mock-e-mail gestuurd naar het adres dat geconfigureerd is onder Settings - Company information. Open de link in die e-mail en vervolgens:

• Voer OK in voor een succesvol resultaat
• Voer een andere waarde in om een fout te simuleren

Betaallinks en QR-codes

Bij het gebruik van de X-Purpose-header in de beta-omgeving kunnen QR-codes die gegenereerd zijn vanuit betaallinks niet worden gescand door bank-apps. Alleen betaallinks in de productieomgeving produceren geldige QR-codes voor bank-apps.

De betaallink-URL zelf werkt normaal in beta - alleen de QR-codeweergave wordt beinvloed.

iDEAL 2.0

Om iDEAL 2.0 eenmalige betalingen te testen, voeg een testprovider toe via Payment Hub - Add - Payment Provider - iDEAL 2.0:

• Merchant ID: een willekeurig nummer
• SubId: leeg laten
• Selecteer Test bank
• Optioneel direct koppelen aan een profiel, of nadien configureren op een profiel

De iDEAL-mock kan worden gebruikt voor directe betaling van facturen en betaallinks. Om deze te gebruiken voor ondertekening met eerste betaling, neem contact op met de support om het als ondertekenmethode in te schakelen.

In de iDEAL-mock betalingsflow kunnen verschillende resultaten direct worden geselecteerd.

Webhooks

De webhooklevering kan worden getest om te verifieren dat het endpoint events correct afhandelt en dat de handtekeningvalidatie werkt. Bij het activeren van webhooks via de API-instellingen zijn geen queryparameters vereist in de URL - Twikey voegt de juiste parameters toe bij het verzenden van elk verzoek, en deze varieren afhankelijk van het eventtype.

Zie de webhook-referentie voor een volledige lijst van eventtypes en hun payloads.

Incassobureau

Nadat een transactie naar het incassobureau is gestuurd, wordt elke 15 minuten feedback gesimuleerd totdat de zaak is afgesloten. Gebruik de volgende bedragen om specifieke resultaten te triggeren:

Brieven

Er worden geen echte brieven verstuurd in de beta-omgeving. In plaats daarvan wordt een kopie van de brief per e-mail gestuurd naar de gebruiker die de actie heeft getriggerd, zodat de inhoud kan worden geverifieerd voor de livegang.

WIK-brieven moeten worden vrijgegeven door de customer success agent. Na vrijgave wordt een zipbestand met de PDF's ontvangen op het e-mailadres dat geconfigureerd is onder Settings - Company information.