Testiranje integracije
Postavite testno okruženje i koristite testne vjerodajnice
Prije pokretanja u produkciju, koristite Cost+ sandbox web stranicu za provjeru ispravnosti vaše integracije. Ne postoji zasebni sandbox URL — koristite istu produkcijsku API krajnju točku (https://api.costplus.online/v1) s API ključem sandbox web stranice.
Dobivanje testnog API ključa
- Prijavite se u portal trgovca
- Idite na Websites
- Stvorite novu web stranicu i odaberite Sandbox kao tip, ili odaberite postojeću sandbox web stranicu
- Kliknite na Integration kako biste pronašli svoj API ključ
- Koristite ovaj API ključ u svojoj integraciji — sve transakcije bit će simulirane
Sandbox nasuprot produkcijskom načinu u potpunosti je određen tipom web stranice u portalu trgovca, a ne URL-om API-ja. API ključ sandbox web stranice obrađuje simulirane transakcije; API ključ produkcijske web stranice obrađuje stvarna plaćanja. Oboje koriste istu API krajnju točku.
Testni brojevi kartica
Koristite donje brojeve kartica za simulaciju različitih scenarija plaćanja. Ne koristite stvarne brojeve kartica u testnom načinu.
| Broj kartice | CVV | Brend | Rezultat |
|---|---|---|---|
4111111111111111 | bilo koji | Visa | Uspjeh |
5544330000000037 | bilo koji | Mastercard | Uspjeh |
4462030000000000 | bilo koji | Visa | Uspjeh |
4111111111111105 | bilo koji | Visa | Do Not Honor |
4111111111111143 | bilo koji | Visa | Stolen Card |
4111111111111151 | bilo koji | Visa | Insufficient Funds |
Koristite bilo koji budući datum isteka i bilo koji 3-znamenkasti CVC.
Testni brojevi kartica funkcioniraju samo u sandbox načinu. Slanje na API ključ produkcijske web stranice rezultirat će odbijenom transakcijom.
Kodovi grešaka
Kada transakcija ne uspije, API vraća jedan od sljedećih kodova grešaka u polju reason transakcije:
| Kod greške | Opis |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS autentifikacija nije dovršena na vrijeme; plaćanje poništeno |
ERROR_CARD_CVV_NOT_VALID | CVV ispravno formatiran, ali nije valjan |
ERROR_CARD_INFORMATION_NOT_VALID | Podaci kartice ispravno formatirani, ali nisu valjani |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transakcija nije podržana za eCommerce |
ERROR_CARD_NOT_VALID | ID kartice nije valjan |
ERROR_CARD_TYPE_DISABLED | Tip kartice je onemogućen |
ERROR_TRANSACTION_FAILED | Transakcija karticom nije uspjela |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Odbijeno od strane procesora (uključuje Visa/MC industrijski numerički kod) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Tip transakcije nije dopušten od strane prodavatelja |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Nije podržano od strane kartične mreže |
INVALID_CARD_CVV | CVV nije prepoznat |
INVALID_CARD_NUMBER | Broj kartice nije prepoznat |
Uobičajene API greške validacije
Ove greške vraćaju se kao 400 Bad Request kada je sam API zahtjev neispravan:
| Greška | Opis |
|---|---|
| Unknown payment method | Naveli ste netočan naziv načina plaćanja |
| No permissions for payment method | Vaš API ključ (projekt) nema dozvole za navedeni način plaćanja |
| Payment method not enabled | Način plaćanja nije omogućen za vaš API ključ (projekt) |
| Payment method not supported | Vaš API ključ (projekt) nema odgovarajući status za korištenje navedenog načina plaćanja |
Ako dobijete "Payment method not enabled" ili "No permissions", provjerite konfiguraciju načina plaćanja u portalu trgovca pod postavkama vaše web stranice.