Тестване на интеграцията
Настройте тестовата си среда и използвайте тестови идентификационни данни
Преди да пуснете в продукция, използвайте sandbox уебсайт в Cost+, за да проверите дали интеграцията ви работи правилно. Няма отделен sandbox URL — използвате същата продукционна API крайна точка (https://api.costplus.online/v1) с API ключ от sandbox уебсайт.
Получаване на тестов API ключ
- Влезте в портала на търговеца
- Навигирайте до Уебсайтове
- Създайте нов уебсайт и изберете Sandbox като тип, или изберете съществуващ sandbox уебсайт
- Кликнете върху Интеграция, за да намерите вашия API ключ
- Използвайте този API ключ в интеграцията си — всички транзакции ще бъдат симулирани
Sandbox срещу продукционен режим се определя изцяло от типа на уебсайта в портала на търговеца, а не от URL адреса на API-то. API ключът на sandbox уебсайт обработва симулирани транзакции; API ключът на продукционен уебсайт обработва реални плащания. И двата използват една и съща API крайна точка.
Тестови номера на карти
Използвайте номерата на карти по-долу, за да симулирате различни сценарии на плащане. Не използвайте реални номера на карти в тестов режим.
| Номер на карта | CVV | Марка | Резултат |
|---|---|---|---|
4111111111111111 | произволен | Visa | Успех |
5544330000000037 | произволен | Mastercard | Успех |
4462030000000000 | произволен | Visa | Успех |
4111111111111105 | произволен | Visa | Do Not Honor |
4111111111111143 | произволен | Visa | Stolen Card |
4111111111111151 | произволен | Visa | Insufficient Funds |
Използвайте произволна бъдеща дата на валидност и произволен 3-цифрен CVC.
Тестовите номера на карти работят само в sandbox режим. Изпращането им към API ключ на продукционен уебсайт ще доведе до отхвърлена транзакция.
Кодове за грешки
Когато транзакция е неуспешна, API-то връща един от следните кодове за грешка в полето reason на транзакцията:
| Код на грешка | Описание |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS удостоверяването не е завършено навреме; плащането е отменено |
ERROR_CARD_CVV_NOT_VALID | CVV е правилно форматиран, но не е валиден |
ERROR_CARD_INFORMATION_NOT_VALID | Данните на картата са правилно форматирани, но не са валидни |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Транзакцията не се поддържа за електронна търговия |
ERROR_CARD_NOT_VALID | Идентификаторът на картата не е валиден |
ERROR_CARD_TYPE_DISABLED | Типът карта е деактивиран |
ERROR_TRANSACTION_FAILED | Транзакцията с карта е неуспешна |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Отхвърлена от процесора (включва числов код на Visa/MC индустрията) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Типът транзакция не е разрешен от продавача |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Не се поддържа от картовата мрежа |
INVALID_CARD_CVV | CVV не е разпознат |
INVALID_CARD_NUMBER | Номерът на картата не е разпознат |
Често срещани грешки при валидация на API
Тези грешки се връщат като 400 Bad Request, когато самата API заявка е невалидна:
| Грешка | Описание |
|---|---|
| Unknown payment method | Посочили сте неправилно име на метод на плащане |
| No permissions for payment method | Вашият API ключ (проект) няма разрешения за посочения метод на плащане |
| Payment method not enabled | Методът на плащане не е активиран за вашия API ключ (проект) |
| Payment method not supported | Вашият API ключ (проект) няма правилния статус за използване на посочения метод на плащане |
Ако получите "Payment method not enabled" или "No permissions", проверете конфигурацията на метода на плащане в портала на търговеца в настройките на вашия уебсайт.