pos_receiptCardPhysicsПоддержка Locale

Mock Jutsu HOW-TO | RU

В современной разработке финтех-решений качественные мок-данные играют критическую роль, особенно когда речь идет о симуляции реальных банковских операций и формировании отчетной документации. Библиотека mock-jutsu предлагает специализированный и мощный инструмент для решения этой задачи — функцию pos_receipt, входящую в категорию CardPhysics. Эта функция предназначена для генерации форматированного текстового представления чека POS-терминала, который полностью имитирует реальный бумажный носитель. Используя pos_receipt, разработчики и тестировщики могут мгновенно получать структурированные блоки текста, что значительно упрощает процесс отладки систем обработки платежей и интеграции с периферийным оборудованием.

Техническая реализация функции pos_receipt ориентирована на соблюдение индустриальных стандартов печати. Сгенерированный текст имеет фиксированную ширину в 40 символов, что соответствует параметрам большинства стандартных рулонов термобумаги, используемых в торговых точках. Структура чека включает в себя заголовок вымышленного эквайера MOCKJ MERCHANT SERVICES, маскированный номер банковской карты (PAN), где согласно правилам безопасности открытыми остаются только последние четыре цифры, уникальный код авторизации и обязательную пометку о тестовом режиме операции. Такой подход позволяет не только визуально оценить корректность верстки документа, но и гарантирует, что эти тестовые данные никогда не будут ошибочно приняты за реальные финансовые транзакции при анализе логов или аудите систем.

Алгоритм, заложенный в mock-jutsu, позволяет автоматизировать создание сложных строковых объектов, избавляя программиста от необходимости вручную прописывать шаблоны и следить за отступами. Сценарии применения pos_receipt весьма обширны: от проверки корректности работы парсеров текстовых данных до обучения и тестирования систем оптического распознавания символов (OCR). Кроме того, функция незаменима при проектировании интерфейсов мобильных банковских приложений, где требуется реалистичное отображение истории операций. Благодаря строгому маскированию конфиденциальных полей, использование данной функции помогает командам соблюдать требования стандарта PCI DSS, исключая утечку реальных данных держателей карт в процессе разработки.

Гибкость интеграции является еще одним важным преимуществом pos_receipt. Разработчики могут вызывать функцию напрямую в Python-скриптах с помощью команды jutsu.generate('pos_receipt'), использовать CLI-интерфейс для быстрой генерации примеров в терминале или внедрять генерацию данных в сложные сценарии нагрузки через JMeter. Это делает mock-jutsu универсальным решением для обеспечения консистентности данных на всех этапах жизненного цикла программного обеспечения. Внедрение таких инструментов позволяет существенно сократить время на подготовку тестовых сред и повысить общую надежность финтех-продуктов, предоставляя разработчикам безопасную и предсказуемую среду для экспериментов с платежными документами.

Использование CLI
mockjutsu generate pos_receipt --locale TRmockjutsu generate pos_receipt --locale DEmockjutsu bulk pos_receipt --count 10 --locale TRmockjutsu export pos_receipt --count 10 --format json --locale TRmockjutsu export pos_receipt --count 10 --format csv --locale TRmockjutsu export pos_receipt --count 10 --format sql --locale TR# --mask: regulation-compliant output (PCI DSS / GDPR / KVKK)mockjutsu generate pos_receipt --locale TR --maskmockjutsu bulk pos_receipt --count 5 --locale TR --mask
Python API
from mockjutsu import jutsujutsu.generate('pos_receipt', locale='TR')jutsu.bulk('pos_receipt', count=10, locale='TR')jutsu.template(['pos_receipt'], count=5, locale='TR')# with --locale parameterjutsu.generate('pos_receipt', locale='TR', locale='TR')# mask=True: regulation-compliant outputjutsu.generate('pos_receipt', locale='TR', mask=True)jutsu.bulk('pos_receipt', count=5, locale='TR', mask=True)
JMeter
${__mockjutsu_cardphysics(pos_receipt,TR)}# JMeter Function: __mockjutsu_cardphysics# Parameter 1: pos_receipt# Parameter 2: locale (TR/UK/US/DE/FR/RU)${__mockjutsu_cardphysics(pos_receipt,DE)}# Add 'mask' keyword to get a regulation-compliant masked value${__mockjutsu_cardphysics(pos_receipt,TR,mask)}
REST API
GET /generate/pos_receipt?locale=TR# → {"type":"pos_receipt","result":"...","status":"ok"}GET /bulk/pos_receipt?count=10&locale=TRPOST /template {"types":["pos_receipt"],"count":1,"locale":"TR"}# mask=true: regulation-compliant outputGET /generate/pos_receipt?locale=TR&mask=trueGET /bulk/pos_receipt?count=5&locale=TR&mask=true

Параметры

Параметр Значения Описание
--locale TR|UK|US|DE|FR|RU Region / locale for locale-aware output
--locale TR|UK|US|DE|FR|RU Region / locale for locale-aware output
--mask true | false Return a regulation-compliant masked value (PCI DSS, GDPR, KVKK…)

Другие языки