DocsUw integratie testen
Stel uw testomgeving in en gebruik testgegevens
Gebruik voor het live gaan een Cost+ sandbox-website om te controleren of uw integratie correct werkt. Er is geen aparte sandbox-URL — u gebruikt hetzelfde productie-API-eindpunt (https://api.costplus.online/v1) met een API-sleutel van een sandbox-website.
Uw test-API-sleutel ophalen
- Log in op het handelaarsportaal
- Navigeer naar Websites
- Maak een nieuwe website aan en selecteer Sandbox als type, of selecteer een bestaande sandbox-website
- Klik op Integration om uw API-sleutel te vinden
- Gebruik deze API-sleutel in uw integratie — alle transacties worden gesimuleerd
Of het sandbox- of productiemodus betreft wordt volledig bepaald door het websitetype in het handelaarsportaal, niet door de API-URL. De API-sleutel van een sandbox-website verwerkt gesimuleerde transacties; de API-sleutel van een productiewebsite verwerkt echte betalingen. Beide gebruiken hetzelfde API-eindpunt.
Testkaartnummers
Gebruik de onderstaande kaartnummers om verschillende betalingsscenario's te simuleren. Gebruik geen echte kaartnummers in testmodus.
| Kaartnummer | CVV | Merk | Resultaat |
|---|---|---|---|
4111111111111111 | willekeurig | Visa | Geslaagd |
5544330000000037 | willekeurig | Mastercard | Geslaagd |
4462030000000000 | willekeurig | Visa | Geslaagd |
4111111111111105 | willekeurig | Visa | Do Not Honor |
4111111111111143 | willekeurig | Visa | Stolen Card |
4111111111111151 | willekeurig | Visa | Insufficient Funds |
Gebruik een willekeurige toekomstige vervaldatum en een willekeurige 3-cijferige CVC.
Testkaartnummers werken alleen in sandboxmodus. Het indienen ervan bij de API-sleutel van een productiewebsite resulteert in een geweigerde transactie.
Foutcodes
Wanneer een transactie mislukt, retourneert de API een van de volgende foutcodes in het reason-veld van de transactie:
| Foutcode | Beschrijving |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS-authenticatie niet op tijd voltooid; betaling geannuleerd |
ERROR_CARD_CVV_NOT_VALID | CVV correct opgemaakt maar niet geldig |
ERROR_CARD_INFORMATION_NOT_VALID | Kaartinformatie correct opgemaakt maar niet geldig |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transactie niet ondersteund voor e-commerce |
ERROR_CARD_NOT_VALID | Kaart-ID is niet geldig |
ERROR_CARD_TYPE_DISABLED | Kaarttype is uitgeschakeld |
ERROR_TRANSACTION_FAILED | Kaarttransactie mislukt |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Afgewezen door processor (bevat Visa/MC numerieke branchecode) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Transactietype niet toegestaan door verkoper |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Niet ondersteund door kaartnetwerk |
INVALID_CARD_CVV | CVV niet herkend |
INVALID_CARD_NUMBER | Kaartnummer niet herkend |
Veelvoorkomende API-validatiefouten
Deze fouten worden geretourneerd als 400 Bad Request wanneer het API-verzoek zelf ongeldig is:
| Fout | Beschrijving |
|---|---|
| Unknown payment method | U heeft een onjuiste betaalmethodenaam opgegeven |
| No permissions for payment method | Uw API-sleutel (project) heeft geen rechten voor de opgegeven betaalmethode |
| Payment method not enabled | De betaalmethode is niet ingeschakeld voor uw API-sleutel (project) |
| Payment method not supported | Uw API-sleutel (project) heeft niet de juiste status om de opgegeven betaalmethode te gebruiken |
Als u "Payment method not enabled" of "No permissions" ontvangt, controleer dan de configuratie van de betaalmethode in het handelaarsportaal onder uw website-instellingen.