DocsTesta din integration
Konfigurera din testmiljö och använd testuppgifter
Innan du går live, använd en Cost+ sandbox-webbplats för att verifiera att din integration fungerar korrekt. Det finns ingen separat sandbox-URL — du använder samma produktions-API-endpoint (https://api.costplus.online/v1) med en API-nyckel från en sandbox-webbplats.
Hämta din test-API-nyckel
- Logga in på handlarportalen
- Navigera till Webbplatser
- Skapa en ny webbplats och välj Sandbox som typ, eller välj en befintlig sandbox-webbplats
- Klicka på Integration för att hitta din API-nyckel
- Använd denna API-nyckel i din integration — alla transaktioner kommer att simuleras
Sandbox kontra produktionsläge bestäms helt av webbplatstypen i handlarportalen, inte av API-URL:en. En sandbox-webbplats API-nyckel hanterar simulerade transaktioner; en produktions-webbplats API-nyckel hanterar riktiga betalningar. Båda använder samma API-endpoint.
Testkortnummer
Använd kortnumren nedan för att simulera olika betalningsscenarier. Använd inte riktiga kortnummer i testläge.
| Kortnummer | CVV | Märke | Resultat |
|---|---|---|---|
4111111111111111 | valfritt | Visa | Lyckad |
5544330000000037 | valfritt | Mastercard | Lyckad |
4462030000000000 | valfritt | Visa | Lyckad |
4111111111111105 | valfritt | Visa | Do Not Honor |
4111111111111143 | valfritt | Visa | Stolen Card |
4111111111111151 | valfritt | Visa | Insufficient Funds |
Använd valfritt framtida utgångsdatum och valfri 3-siffrig CVC.
Testkortnummer fungerar bara i sandbox-läge. Om de skickas till en produktions-webbplats API-nyckel resulterar det i en nekad transaktion.
Felkoder
När en transaktion misslyckas returnerar API:et en av följande felkoder i transaktionens reason-fält:
| Felkod | Beskrivning |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS-autentisering slutfördes inte i tid; betalningen avbröts |
ERROR_CARD_CVV_NOT_VALID | CVV korrekt formaterad men ogiltig |
ERROR_CARD_INFORMATION_NOT_VALID | Kortinformation korrekt formaterad men ogiltig |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transaktionen stöds inte för e-handel |
ERROR_CARD_NOT_VALID | Kort-ID är ogiltigt |
ERROR_CARD_TYPE_DISABLED | Korttypen är inaktiverad |
ERROR_TRANSACTION_FAILED | Korttransaktionen misslyckades |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Nekad av processor (inkluderar Visa/MC branschnumerisk kod) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Transaktionstypen tillåts inte av säljaren |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Stöds inte av kortnätverket |
INVALID_CARD_CVV | CVV inte igenkänd |
INVALID_CARD_NUMBER | Kortnummer inte igenkänt |
Vanliga API-valideringsfel
Dessa fel returneras som 400 Bad Request när själva API-förfrågan är ogiltig:
| Fel | Beskrivning |
|---|---|
| Unknown payment method | Du angav ett felaktigt betalningsmetodnamn |
| No permissions for payment method | Din API-nyckel (projekt) har inte behörighet för den angivna betalningsmetoden |
| Payment method not enabled | Betalningsmetoden har inte aktiverats för din API-nyckel (projekt) |
| Payment method not supported | Din API-nyckel (projekt) har inte korrekt status för att använda den angivna betalningsmetoden |
Om du får "Payment method not enabled" eller "No permissions", kontrollera betalningsmetodkonfigurationen i handlarportalen under dina webbplatsinställningar.