Sandbox-omgeving
De Cardflo sandbox-omgeving stelt ontwikkelaars in staat om betaaloplossingen te integreren en te testen zonder live transacties te beïnvloeden.
Deze geïsoleerde ruimte weerspiegelt onze productieomgeving, waardoor grondige tests van alle Cardflo-functies mogelijk zijn, van betalingsverwerking tot webhooks en API-interacties, wat een soepele overgang naar live operaties garandeert.
- Categorie
- Ontwikkelaar
- Mogelijkheden
- 10
- Beschikbaar op
- Alle abonnementen
Het overzicht
Een sandbox-omgeving fungeert als een niet-productie-instantie van een betalingsgateway of orkestratieplatform, waardoor ontwikkelaars de gehele transactielevenscyclus kunnen modelleren zonder echte fondsen te verplaatsen. Het werkt als een replica van de live API, inclusief componenten voor autorisatie, vastlegging en afwikkeling.
Binnen deze geïsoleerde container kunnen technische teams hun integratielogica, aanvraagstructuren en authenticatieheaders controleren aan de hand van strikte validatieregels.
Door testgegevens en gesimuleerde Card Identification Numbers (BIN's) te gebruiken, kunnen handelaren evalueren hoe hun backend reageert op verschillende antwoorden, zoals succesvolle betalingen, zachte weigeringen of 3DS-authenticatieprompts.
De sandbox bevindt zich tussen de handelaarsapplicatie en de gesimuleerde acquirer, en biedt een veilige ruimte om ervoor te zorgen dat de code randgevallen afhandelt, zoals onvoldoende saldo of verlopen kaarten,
voordat wordt overgegaan naar een live productieomgeving waar fouten kunnen leiden tot verlies van inkomsten of hogere chargeback-ratio's.
Hoe het werkt
Generatie en authenticatie van referenties
Ontwikkelaars verkrijgen een specifieke set API-sleutels of Bearer-tokens die zijn bestemd voor de testomgeving. Deze referenties leiden aanvragen naar een mock-processor in plaats van naar de live betalingsschema's.
Dit zorgt ervoor dat er geen Merchant Identification Number (MID) wordt gefactureerd voor verwerkingskosten en dat er geen echte kaarthoudergegevens in de productiesystemen terechtkomen.
Gesimuleerde transactieverwerking
De handelaar stuurt een betalingsaanvraag met behulp van vooraf gedefinieerde testkaartnummers die specifieke uitkomsten activeren. Het gebruik van één BIN kan bijvoorbeeld een succesvolle autorisatie simuleren, terwijl een andere een CVV-mismatch of een harde weigering activeert.
De sandbox retourneert een identieke JSON-antwoordstructuur als de live API om compatibiliteit te garanderen.
Webhook-gebeurtenismelding
Zodra een transactiestatus verandert in de sandbox, genereert het systeem asynchrone webhooks. De handelaarsserver ontvangt deze meldingen op een aangewezen eindpunt om te controleren of hun systeem de interne database correct bijwerkt.
Deze stap is cruciaal voor het testen van automatische orderafhandeling of abonnementsbeheerlogica in realtime.
Statuswijziging en afwikkeling
Gebruikers kunnen de status van een transactie handmatig of programmatisch overzetten van geautoriseerd naar afgewikkeld of terugbetaald binnen het testdashboard.
Dit maakt de verificatie van post-aankoopworkflows mogelijk, inclusief de afhandeling van ophaalaanvragen of gedeeltelijke terugbetalingen, zodat de gebruikersinterface van de handelaar de juiste financiële status weergeeft.
Waarom het telt
Risicobeperking tijdens implementatie
Het rechtstreeks implementeren van nieuwe betalingsstromen in productie creëert een hoog operationeel risico. Door een sandbox te gebruiken, kunnen ontwikkelaars logische fouten of verkeerd gevormde API-aanvragen identificeren die anders zouden leiden tot mislukte afrekeningen.
Deze isolatie beschermt de integriteit van het live Merchant Identification Number en voorkomt onbedoelde activering van antifraude-filters die kunnen optreden tijdens agressieve tests van nieuwe kaart-aanwezig of kaart-niet-aanwezig integratielogica.
Validatie van complexe logica
Moderne betalingen omvatten vaak meerstaps processen zoals Strong Customer Authentication (SCA) of terugkerende facturering. Een sandbox maakt het rigoureus testen van door kaarthouders geïnitieerde en door handelaren geïnitieerde transacties mogelijk zonder de financiële kosten van echte transacties.
Het zorgt ervoor dat het systeem verschillende weigeringscodes en antwoordberichten van uitgevers correct interpreteert, waardoor de dunninglogica en herhalingsstrategieën kunnen worden verfijnd om de uiteindelijke conversiepercentages te optimaliseren.
Toepassingen
Initiële API-integratie
Nieuwe handelaren gebruiken de sandbox om hun interne orderbeheersystemen te koppelen aan de API-eindpunten van de betalingsgateway. Dit bevestigt dat gegevensvelden zoals valutacodes en merchant category codes correct zijn geformatteerd voor autorisatie.
Verificatie van terugkerende facturering
Abonnementsgebaseerde bedrijven testen hun dunningsequenties door het verlopen van kaarten of onvoldoende saldo te simuleren. Dit zorgt ervoor dat het systeem correct pogingen tot opnieuw proberen onderneemt en passende meldingen naar de klant stuurt voordat de service wordt opgeschort.
Foutopsporing van webhook-eindpunten
Ontwikkelaars gebruiken de testomgeving om te controleren of hun firewall- en serverconfiguraties inkomende webhook-meldingen toestaan. Dit voorkomt problemen waarbij bestellingen 'in behandeling' blijven ondanks succesvolle autorisatie op acquirer-niveau.
Testen van alternatieve betaalmethoden
Voordat lokale betaalmethoden worden ingeschakeld, kunnen handelaren de omleidingsstromen simuleren die nodig zijn voor APM's. Dit zorgt ervoor dat de gebruikerservaring consistent blijft wanneer de klant naar een externe wallet of bankportaal wordt gestuurd.
In cijfers
Typische efficiëntiewinsten waargenomen door technische teams bij het gebruik van een uitgebreide sandbox in vergelijking met handmatige documentatiebeoordeling en directe productietests.
Geschatte reductie in post-implementatiebugs gerelateerd aan betalingslogica wanneer rigoureuze sandbox-tests worden geïmplementeerd als onderdeel van de CI/CD-pijplijn.
Industriestandaard reactietijd voor mock API-eindpunten, waardoor snelle iteratie mogelijk is tijdens de softwareontwikkelingslevenscyclus.
Verwante termen
Talk to our team about a live rollout on your acquiring stack.
Wat u krijgt met Sandbox-omgeving
- Controleer API-aanvraag- en antwoordstructuren aan de hand van officiële documentatie in een veilige omgeving.
- Simuleer specifieke weigeringsredenen voor autorisatie om foutafhandeling en klantcommunicatie te valideren.
- Activeer en ontvang webhook-meldingen voor statusupdates zoals vastlegging, terugbetaling en geschil.
- Test 3-D Secure-authenticatiestromen om naleving van PSD2- en SCA-vereisten te waarborgen.
- Valideer de afhandeling van netwerktokens en accountupdater-meldingen zonder echte gegevens.
- Voer belastingstests uit op integratielogica voordat u overgaat naar productieomgevingen met een hoger volume.
- Configureer meerdere verkopersprofielen om valutaconversie en binnenlandse versus internationale verwerking te testen.
- Controleer de logboekregistratie van transactie-ID's, ARNs en tijdstempels voor interne financiële afstemming.
- Modelleer het gedrag van gedeeltelijke vastleggingen en meerdere terugbetalingen op een enkele transactie.
- Onderzoek de impact van merchant category codes op gesimuleerde autorisatiepercentages en kostenstructuren.
A short scoping call, then a written plan for your MIDs.
Vragen over Sandbox-omgeving
Verschijnen sandbox-transacties op echte bankafschriften of brengen ze schemakosten met zich mee?
Nee, transacties die binnen een sandbox-omgeving worden verwerkt, interageren niet met daadwerkelijke betalingsschema's zoals Visa of Mastercard. Ze worden afgehandeld door een mock-processor die de reactie van de uitgever simuleert.
Bijgevolg worden er geen echte fondsen verplaatst, wordt er geen kaarthouder belast en maakt de handelaar geen interchange- of schemakosten. De omgeving is volledig geïsoleerd om financiële impact te voorkomen.
Kan ik Strong Customer Authentication (SCA) en 3D Secure testen in de sandbox?
Ja, hoogwaardige sandbox-omgevingen bieden specifieke testkaarten of vlaggen om 3DS-stromen te activeren. Dit stelt ontwikkelaars in staat om de omleiding naar een gesimuleerde Access Control Server (ACS) te testen en de resulterende authenticatieresultaten, zoals succes, mislukking of omzeiling, af te handelen.
Het is een essentiële stap voor Europese handelaren om naleving van PSD2-mandaten voor elektronische betalingen te waarborgen.
Hoe simuleer ik een harde weigering versus een zachte weigering bij het testen?
Simulatie wordt meestal bereikt door verschillende testkaartnummers of transactiebedragen te gebruiken die in de documentatie zijn gespecificeerd. Een specifieke BIN kan worden toegewezen aan een 'Verloren of Gestolen' reactie (harde weigering), terwijl een andere 'Onvoldoende Saldo' (zachte weigering) kan activeren.
Het testen van deze varianten is van vitaal belang voor ontwikkelaars om de juiste herhalingslogica te implementeren en onderscheid te maken tussen permanente en tijdelijke storingen.
Zijn opgeslagen kaarthoudergegevens in de sandbox onderworpen aan PCI-DSS-naleving?
Hoewel de sandbox geen echte kaarthoudergegevens mag bevatten, blijft de beveiliging van de API-sleutels en de gesimuleerde gegevens belangrijk. De meeste sandbox-omgevingen gebruiken pseudogegevens die lijken op echte PAN's, maar die Luhn-algoritmecontroles niet doorstaan of tot niet-toegewezen bereiken behoren.
Ontwikkelaars moeten echter goede beveiligingspraktijken handhaven en nooit echte klantgegevens gebruiken binnen een testomgeving om potentiële risico's op datalekken te voorkomen.
Zullen mijn webhook-eindpunten dezelfde payload ontvangen als de productieomgeving?
De JSON- of XML-payload die naar uw webhook-URL in de sandbox wordt geleverd, moet exact overeenkomen met het productieschema. Dit omvat dezelfde velden voor transactie-ID, bedrag, valuta en statuscodes.
Het testen hiervan zorgt ervoor dat uw backend-parser correct is geconfigureerd om de live datastroom af te handelen zonder dat er codewijzigingen nodig zijn tijdens de overgang naar productie.
Kan ik het afwikkelings- en afstemmingsproces testen in de sandbox?
U kunt de overgangen simuleren die leiden tot afwikkeling, zoals het verplaatsen van een transactie van 'geautoriseerd' naar 'vastgelegd'. Sommige sandboxes stellen u in staat om mock-rapporten te genereren die lijken op de afwikkelingsbestanden die door acquirers worden geleverd.
Dit helpt bij het bouwen van geautomatiseerde afstemmingstools die interne order-ID's matchen met de transactiereferenties die door de betalingsdienstaanbieder worden geleverd.
Klaar voor snelheid?
Vertel ons over uw bedrijf. Wij matchen u met de juiste acquiring partners en de juiste route, doorgaans binnen een week.