DocsTest din integration
Opsæt dit testmiljø og brug testlegitimationsoplysninger
Inden du går live, skal du bruge et Cost+ sandbox-website til at verificere, at din integration fungerer korrekt. Der er ingen separat sandbox-URL — du bruger det samme produktions-API-endpoint (https://api.costplus.online/v1) med en API-nøgle fra et sandbox-website.
Hent din test-API-nøgle
- Log ind på forhandlerportalen
- Naviger til Websites
- Opret et nyt website og vælg Sandbox som type, eller vælg et eksisterende sandbox-website
- Klik på Integration for at finde din API-nøgle
- Brug denne API-nøgle i din integration — alle transaktioner vil blive simuleret
Sandbox vs. produktionstilstand bestemmes udelukkende af website-typen i forhandlerportalen, ikke af API-URL'en. Et sandbox-websites API-nøgle behandler simulerede transaktioner; et produktions-websites API-nøgle behandler rigtige betalinger. Begge bruger det samme API-endpoint.
Testkortnumre
Brug kortnumrene nedenfor til at simulere forskellige betalingsscenarier. Brug ikke rigtige kortnumre i testtilstand.
| Kortnummer | CVV | Mærke | Resultat |
|---|---|---|---|
4111111111111111 | vilkårlig | Visa | Succes |
5544330000000037 | vilkårlig | Mastercard | Succes |
4462030000000000 | vilkårlig | Visa | Succes |
4111111111111105 | vilkårlig | Visa | Do Not Honor |
4111111111111143 | vilkårlig | Visa | Stolen Card |
4111111111111151 | vilkårlig | Visa | Insufficient Funds |
Brug en vilkårlig fremtidig udløbsdato og en vilkårlig 3-cifret CVC.
Testkortnumre fungerer kun i sandbox-tilstand. Indsendelse af dem til et produktions-websites API-nøgle vil resultere i en afvist transaktion.
Fejlkoder
Når en transaktion fejler, returnerer API'et en af følgende fejlkoder i transaktionens reason-felt:
| Fejlkode | Beskrivelse |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS-autentificering ikke gennemført i tide; betaling annulleret |
ERROR_CARD_CVV_NOT_VALID | CVV korrekt formateret, men ikke gyldigt |
ERROR_CARD_INFORMATION_NOT_VALID | Kortoplysninger korrekt formateret, men ikke gyldige |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transaktion ikke understøttet til e-handel |
ERROR_CARD_NOT_VALID | Kort-ID er ikke gyldigt |
ERROR_CARD_TYPE_DISABLED | Korttype er deaktiveret |
ERROR_TRANSACTION_FAILED | Korttransaktion fejlede |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Afvist af processor (inkluderer Visa/MC industriel numerisk kode) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Transaktionstype ikke tilladt af sælger |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Ikke understøttet af kortnetværk |
INVALID_CARD_CVV | CVV ikke genkendt |
INVALID_CARD_NUMBER | Kortnummer ikke genkendt |
Almindelige API-valideringsfejl
Disse fejl returneres som 400 Bad Request, når selve API-anmodningen er ugyldig:
| Fejl | Beskrivelse |
|---|---|
| Unknown payment method | Du har angivet et forkert betalingsmetodenavn |
| No permissions for payment method | Din API-nøgle (projekt) har ikke tilladelser til den angivne betalingsmetode |
| Payment method not enabled | Betalingsmetoden er ikke aktiveret for din API-nøgle (projekt) |
| Payment method not supported | Din API-nøgle (projekt) har ikke den korrekte status til at bruge den angivne betalingsmetode |
Hvis du modtager "Payment method not enabled" eller "No permissions", skal du tjekke betalingsmetodekonfigurationen i forhandlerportalen under dine website-indstillinger.