DocsIntegracijos testavimas
Nustatykite savo testavimo aplinką ir naudokite testinius kredencialus
Prieš pradedant dirbti gyvai, naudokite Cost+ testavimo (sandbox) svetainę, kad patikrintumėte, ar jūsų integracija veikia teisingai. Atskiro testavimo URL nėra — naudojate tą patį produkcijos API galinį tašką (https://api.costplus.online/v1) su API raktu iš testavimo svetainės.
Testinio API rakto gavimas
- Prisijunkite prie prekybininko portalo
- Eikite į Websites
- Sukurkite naują svetainę ir pasirinkite Sandbox kaip tipą, arba pasirinkite esamą testavimo svetainę
- Paspauskite Integration, kad rastumėte savo API raktą
- Naudokite šį API raktą savo integracijoje — visos operacijos bus simuliuojamos
Testavimo ir produkcijos režimas nustatomas išimtinai pagal svetainės tipą prekybininko portale, o ne pagal API URL. Testavimo svetainės API raktas apdoroja simuliuotas operacijas; produkcijos svetainės API raktas apdoroja tikrus mokėjimus. Abu naudoja tą patį API galinį tašką.
Testinių kortelių numeriai
Naudokite žemiau esančius kortelių numerius, kad simuliuotumėte skirtingus mokėjimo scenarijus. Nenaudokite tikrų kortelių numerių testavimo režimu.
| Kortelės numeris | CVV | Prekės ženklas | Rezultatas |
|---|---|---|---|
4111111111111111 | bet koks | Visa | Sėkmingas |
5544330000000037 | bet koks | Mastercard | Sėkmingas |
4462030000000000 | bet koks | Visa | Sėkmingas |
4111111111111105 | bet koks | Visa | Do Not Honor |
4111111111111143 | bet koks | Visa | Stolen Card |
4111111111111151 | bet koks | Visa | Insufficient Funds |
Naudokite bet kurią ateities galiojimo datą ir bet kokį 3 skaitmenų CVC.
Testinių kortelių numeriai veikia tik testavimo režimu. Pateikus juos produkcijos svetainės API raktui, operacija bus atmesta.
Klaidų kodai
Kai operacija nepavyksta, API grąžina vieną iš šių klaidų kodų operacijos reason lauke:
| Klaidos kodas | Aprašymas |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS autentifikacija nebaigta laiku; mokėjimas atšauktas |
ERROR_CARD_CVV_NOT_VALID | CVV teisingai suformatuotas, bet negaliojantis |
ERROR_CARD_INFORMATION_NOT_VALID | Kortelės informacija teisingai suformatuota, bet negaliojanti |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Operacija nepalaikoma el. prekybai |
ERROR_CARD_NOT_VALID | Kortelės ID negaliojantis |
ERROR_CARD_TYPE_DISABLED | Kortelės tipas išjungtas |
ERROR_TRANSACTION_FAILED | Kortelės operacija nepavyko |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Atmesta procesoriaus (įskaitant Visa/MC pramonės skaitinį kodą) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Operacijos tipas neleidžiamas pardavėjo |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Nepalaikoma kortelių tinklo |
INVALID_CARD_CVV | CVV neatpažintas |
INVALID_CARD_NUMBER | Kortelės numeris neatpažintas |
Dažnos API validacijos klaidos
Šios klaidos grąžinamos kaip 400 Bad Request, kai pati API užklausa yra netinkama:
| Klaida | Aprašymas |
|---|---|
| Unknown payment method | Pateikėte neteisingą mokėjimo būdo pavadinimą |
| No permissions for payment method | Jūsų API raktas (projektas) neturi leidimų nurodytam mokėjimo būdui |
| Payment method not enabled | Mokėjimo būdas neįjungtas jūsų API raktui (projektui) |
| Payment method not supported | Jūsų API raktas (projektas) neturi tinkamos būsenos, kad galėtų naudoti nurodytą mokėjimo būdą |
Jei gaunate „Payment method not enabled" arba „No permissions", patikrinkite mokėjimo būdo konfigūraciją prekybininko portale jūsų svetainės nustatymuose.