DocsTest integrasjonen din
Sett opp testmiljøet ditt og bruk testlegitimasjon
Før du går i produksjon, bruk et Cost+ sandbox-nettsted for å verifisere at integrasjonen din fungerer korrekt. Det finnes ingen separat sandbox-URL — du bruker samme produksjons-API-endepunkt (https://api.costplus.online/v1) med en API-nøkkel fra et sandbox-nettsted.
Få din test-API-nøkkel
- Logg inn på forhandlerportalen
- Naviger til Nettsteder
- Opprett et nytt nettsted og velg Sandbox som type, eller velg et eksisterende sandbox-nettsted
- Klikk på Integrasjon for å finne API-nøkkelen din
- Bruk denne API-nøkkelen i integrasjonen din — alle transaksjoner vil bli simulert
Sandbox kontra produksjonsmodus bestemmes utelukkende av nettstedtypen i forhandlerportalen, ikke av API-URL-en. En sandbox-nettsted API-nøkkel behandler simulerte transaksjoner; en produksjonsnettsted API-nøkkel behandler ekte betalinger. Begge bruker samme API-endepunkt.
Testkortnumre
Bruk kortnumrene nedenfor for å simulere ulike betalingsscenarioer. Ikke bruk ekte kortnumre i testmodus.
| Kortnummer | CVV | Merke | Resultat |
|---|---|---|---|
4111111111111111 | valgfritt | Visa | Vellykket |
5544330000000037 | valgfritt | Mastercard | Vellykket |
4462030000000000 | valgfritt | Visa | Vellykket |
4111111111111105 | valgfritt | Visa | Avvist |
4111111111111143 | valgfritt | Visa | Stjålet kort |
4111111111111151 | valgfritt | Visa | Utilstrekkelige midler |
Bruk en hvilken som helst fremtidig utløpsdato og en hvilken som helst 3-sifret CVC.
Testkortnumre fungerer kun i sandbox-modus. Å sende dem til en produksjonsnettsted API-nøkkel vil resultere i en avvist transaksjon.
Feilkoder
Når en transaksjon mislykkes, returnerer API-et en av følgende feilkoder i transaksjonens reason-felt:
| Feilkode | Beskrivelse |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS-autentisering ikke fullført i tide; betaling avbrutt |
ERROR_CARD_CVV_NOT_VALID | CVV korrekt formatert men ikke gyldig |
ERROR_CARD_INFORMATION_NOT_VALID | Kortinformasjon korrekt formatert men ikke gyldig |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transaksjon ikke støttet for e-handel |
ERROR_CARD_NOT_VALID | Kort-ID er ikke gyldig |
ERROR_CARD_TYPE_DISABLED | Korttypen er deaktivert |
ERROR_TRANSACTION_FAILED | Korttransaksjon mislyktes |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Avvist av prosessor (inkluderer Visa/MC numerisk bransjekode) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Transaksjonstype ikke tillatt av selger |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Ikke støttet av kortnettverket |
INVALID_CARD_CVV | CVV ikke gjenkjent |
INVALID_CARD_NUMBER | Kortnummer ikke gjenkjent |
Vanlige API-valideringsfeil
Disse feilene returneres som 400 Bad Request når selve API-forespørselen er ugyldig:
| Feil | Beskrivelse |
|---|---|
| Unknown payment method | Du oppga et feil navn på betalingsmetode |
| No permissions for payment method | API-nøkkelen din (prosjektet) har ikke tillatelse til den angitte betalingsmetoden |
| Payment method not enabled | Betalingsmetoden er ikke aktivert for API-nøkkelen din (prosjektet) |
| Payment method not supported | API-nøkkelen din (prosjektet) har ikke riktig status for å bruke den angitte betalingsmetoden |
Hvis du mottar «Payment method not enabled» eller «No permissions», sjekk konfigurasjonen av betalingsmetodene i forhandlerportalen under nettstedinnstillingene dine.