Cost+Docs

Тестване на интеграцията

Настройте тестовата си среда и използвайте тестови идентификационни данни

Преди да пуснете в продукция, използвайте sandbox уебсайт в Cost+, за да проверите дали интеграцията ви работи правилно. Няма отделен sandbox URL — използвате същата продукционна API крайна точка (https://api.costplus.online/v1) с API ключ от sandbox уебсайт.

Получаване на тестов API ключ

  1. Влезте в портала на търговеца
  2. Навигирайте до Уебсайтове
  3. Създайте нов уебсайт и изберете Sandbox като тип, или изберете съществуващ sandbox уебсайт
  4. Кликнете върху Интеграция, за да намерите вашия API ключ
  5. Използвайте този API ключ в интеграцията си — всички транзакции ще бъдат симулирани

Sandbox срещу продукционен режим се определя изцяло от типа на уебсайта в портала на търговеца, а не от URL адреса на API-то. API ключът на sandbox уебсайт обработва симулирани транзакции; API ключът на продукционен уебсайт обработва реални плащания. И двата използват една и съща API крайна точка.

Тестови номера на карти

Използвайте номерата на карти по-долу, за да симулирате различни сценарии на плащане. Не използвайте реални номера на карти в тестов режим.

Номер на картаCVVМаркаРезултат
4111111111111111произволенVisaУспех
5544330000000037произволенMastercardУспех
4462030000000000произволенVisaУспех
4111111111111105произволенVisaDo Not Honor
4111111111111143произволенVisaStolen Card
4111111111111151произволенVisaInsufficient Funds

Използвайте произволна бъдеща дата на валидност и произволен 3-цифрен CVC.

Тестовите номера на карти работят само в sandbox режим. Изпращането им към API ключ на продукционен уебсайт ще доведе до отхвърлена транзакция.

Кодове за грешки

Когато транзакция е неуспешна, API-то връща един от следните кодове за грешка в полето reason на транзакцията:

Код на грешкаОписание
ERROR_CARD_AUTHENTICATION_FAILURE3DS удостоверяването не е завършено навреме; плащането е отменено
ERROR_CARD_CVV_NOT_VALIDCVV е правилно форматиран, но не е валиден
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_CVVCVV не е разпознат
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", проверете конфигурацията на метода на плащане в портала на търговеца в настройките на вашия уебсайт.

On this page