DocsIntegráció tesztelése
Tesztkörnyezet beállítása és teszthitelesítő adatok használata
Az élesítés előtt használjon Cost+ sandbox weboldalt az integráció helyes működésének ellenőrzéséhez. Nincs külön sandbox URL — ugyanazt az éles API-végpontot (https://api.costplus.online/v1) használja egy sandbox weboldal API-kulcsával.
Teszt API-kulcs beszerzése
- Jelentkezzen be a kereskedői portálba
- Navigáljon a Weboldalak menüpontra
- Hozzon létre egy új weboldalt, és válassza a Sandbox típust, vagy válasszon ki egy meglévő sandbox weboldalt
- Kattintson az Integráció fülre az API-kulcs megtalálásához
- Használja ezt az API-kulcsot az integrációjában — minden tranzakció szimulált lesz
A sandbox és az éles mód teljes egészében a weboldal típusa határozza meg a kereskedői portálban, nem az API URL. Egy sandbox weboldal API-kulcsa szimulált tranzakciókat dolgoz fel; egy éles weboldal API-kulcsa valódi fizetéseket dolgoz fel. Mindkettő ugyanazt az API-végpontot használja.
Tesztkártya számok
Az alábbi kártyaszámokat használja különböző fizetési forgatókönyvek szimulálásához. Ne használjon valódi kártyaszámokat teszt módban.
| Kártyaszám | CVV | Márka | Eredmény |
|---|---|---|---|
4111111111111111 | bármely | Visa | Sikeres |
5544330000000037 | bármely | Mastercard | Sikeres |
4462030000000000 | bármely | Visa | Sikeres |
4111111111111105 | bármely | Visa | Elutasítva |
4111111111111143 | bármely | Visa | Lopott kártya |
4111111111111151 | bármely | Visa | Elégtelen fedezet |
Használjon bármely jövőbeli lejárati dátumot és bármely 3 számjegyű CVC-t.
A tesztkártya számok csak sandbox módban működnek. Éles weboldal API-kulcsával való beküldésük elutasított tranzakciót eredményez.
Hibakódok
Amikor egy tranzakció sikertelen, az API az alábbi hibakódok egyikét adja vissza a tranzakció reason mezőjében:
| Hibakód | Leírás |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | A 3DS hitelesítés nem fejeződött be időben; a fizetés törölve |
ERROR_CARD_CVV_NOT_VALID | A CVV formátuma helyes, de érvénytelen |
ERROR_CARD_INFORMATION_NOT_VALID | A kártyaadatok formátuma helyes, de érvénytelenek |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | A tranzakció nem támogatott e-kereskedelemhez |
ERROR_CARD_NOT_VALID | A kártyaazonosító érvénytelen |
ERROR_CARD_TYPE_DISABLED | A kártyatípus le van tiltva |
ERROR_TRANSACTION_FAILED | A kártyás tranzakció sikertelen |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | A feldolgozó elutasította (tartalmazza a Visa/MC iparági numerikus kódot) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Az eladó nem engedélyezi ezt a tranzakciótípust |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | A kártyahálózat nem támogatja |
INVALID_CARD_CVV | A CVV nem felismerhető |
INVALID_CARD_NUMBER | A kártyaszám nem felismerhető |
Gyakori API-érvényesítési hibák
Ezek a hibák 400 Bad Request válaszként érkeznek, amikor maga az API-kérés érvénytelen:
| Hiba | Leírás |
|---|---|
| Unknown payment method | Helytelen fizetési mód nevet adott meg |
| No permissions for payment method | Az API-kulcsa (projekt) nem rendelkezik jogosultsággal a megadott fizetési módhoz |
| Payment method not enabled | A fizetési mód nincs engedélyezve az API-kulcsához (projekt) |
| Payment method not supported | Az API-kulcsa (projekt) nem rendelkezik a megfelelő állapottal a megadott fizetési mód használatához |
Ha "Payment method not enabled" vagy "No permissions" hibát kap, ellenőrizze a fizetési mód konfigurációját a kereskedői portálban a weboldal beállításai alatt.