DocsTestarea integrării
Configurați mediul de test și utilizați credențialele de test
Înainte de a trece în producție, folosiți un site web sandbox Cost+ pentru a verifica că integrarea dvs. funcționează corect. Nu există un URL separat pentru sandbox — folosiți același endpoint API de producție (https://api.costplus.online/v1) cu o cheie API de la un site web sandbox.
Obținerea cheii API de test
- Conectați-vă la portalul comerciantului
- Navigați la Site-uri web
- Creați un site web nou și selectați Sandbox ca tip, sau selectați un site web sandbox existent
- Faceți clic pe Integrare pentru a găsi cheia API
- Folosiți această cheie API în integrarea dvs. — toate tranzacțiile vor fi simulate
Modul sandbox vs. producție este determinat în întregime de tipul site-ului web din portalul comerciantului, nu de URL-ul API. Cheia API a unui site web sandbox procesează tranzacții simulate; cheia API a unui site web de producție procesează plăți reale. Ambele folosesc același endpoint API.
Numere de card de test
Folosiți numerele de card de mai jos pentru a simula diferite scenarii de plată. Nu folosiți numere de card reale în modul de test.
| Număr card | CVV | Brand | Rezultat |
|---|---|---|---|
4111111111111111 | oricare | Visa | Succes |
5544330000000037 | oricare | Mastercard | Succes |
4462030000000000 | oricare | Visa | Succes |
4111111111111105 | oricare | Visa | Do Not Honor |
4111111111111143 | oricare | Visa | Stolen Card |
4111111111111151 | oricare | Visa | Insufficient Funds |
Folosiți orice dată de expirare viitoare și orice CVC de 3 cifre.
Numerele de card de test funcționează doar în modul sandbox. Trimiterea lor către cheia API a unui site web de producție va rezulta într-o tranzacție refuzată.
Coduri de eroare
Când o tranzacție eșuează, API-ul returnează unul dintre următoarele coduri de eroare în câmpul reason al tranzacției:
| Cod de eroare | Descriere |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | Autentificarea 3DS nu a fost finalizată la timp; plata anulată |
ERROR_CARD_CVV_NOT_VALID | CVV formatat corect dar invalid |
ERROR_CARD_INFORMATION_NOT_VALID | Informații card formatate corect dar invalide |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Tranzacție neacceptată pentru eCommerce |
ERROR_CARD_NOT_VALID | ID-ul cardului nu este valid |
ERROR_CARD_TYPE_DISABLED | Tipul de card este dezactivat |
ERROR_TRANSACTION_FAILED | Tranzacția cu cardul a eșuat |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Respinsă de procesor (include codul numeric Visa/MC) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Tipul de tranzacție nu este permis de vânzător |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Neacceptat de rețeaua de carduri |
INVALID_CARD_CVV | CVV nerecunoscut |
INVALID_CARD_NUMBER | Număr de card nerecunoscut |
Erori comune de validare API
Aceste erori sunt returnate ca 400 Bad Request când cererea API în sine este invalidă:
| Eroare | Descriere |
|---|---|
| Unknown payment method | Ați furnizat un nume incorect de metodă de plată |
| No permissions for payment method | Cheia API (proiectul) nu are permisiuni pentru metoda de plată specificată |
| Payment method not enabled | Metoda de plată nu a fost activată pentru cheia API (proiect) |
| Payment method not supported | Cheia API (proiectul) nu are statusul corect pentru a utiliza metoda de plată specificată |
Dacă primiți „Payment method not enabled" sau „No permissions", verificați configurarea metodei de plată în portalul comerciantului la setările site-ului web.