Configuration
loginId/password Konnektive хранятся в localStorage. Не коммить файл в публичный git. У Konnektive ОБЯЗАТЕЛЕН IP whitelisting — этот сервер должен быть в whitelist (см. админка Konnektive → API Users).
PAAY 3DS credentials
JWT генерируется локально в браузере через HS256 (apiKey →
iss, secret → HMAC ключ). API /jwt у PAAY не существует — это client-signed token.
Заметки по API
• Все вызовы — POST, body
•
• Поле
• Даты в фильтрах — формат
• Лимит результатов на страницу — обычно до 200, страницы через
application/x-www-form-urlencoded, либо параметры в query-string•
loginId + password подставляются автоматически в каждый запрос• Поле
responseType=json подставляется автоматически (иначе вернётся XML)• Даты в фильтрах — формат
MM/DD/YYYY или MM/DD/YYYY HH:mm:ss• Лимит результатов на страницу — обычно до 200, страницы через
page=N
Orders
Query Orders
POST /order/query/Поиск заказов. Главный отчётный эндпоинт для просмотра, что приходит в CRM.
// response
Import Order
POST /order/import/Создать заказ с прямым списанием. Принимает кардданные (PCI scope) или ранее сохранённого customerId / cardId.
// response
Preauth Order
POST /order/preauth/Холд средств без списания. Дальше Confirm Order.
// response
Update Order
POST /order/update/Изменить детали заказа: адрес, статус, флаги.
// response
Refund Order
POST /order/refund/Возврат по orderId. Полный или частичный (refundAmount).
// response
Cancel Order
POST /order/cancel/// response
Confirm Order
POST /order/confirm/Конфирм preauth-заказа — превращает в обычный SALE.
// response
Rerun Declined Sale
POST /order/rerun/// response
Order QA
POST /order/qa/// response
Import Upsale
POST /upsale/import/Дополнительный заказ к существующему customerId (one-click upsell).
// response
Customers
Query Customers
POST /customer/query/// response
Customer History
POST /customer/history/// response
Update Customer
POST /customer/update/// response
Update Customer Card
POST /customer/cardupdate/// response
Add Customer Note
POST /customer/addnote/// response
Add to Blacklist
POST /customer/blacklist/// response
Query Blacklist
POST /customer/blacklist/query/// response
Query Customer Contracts
POST /customer/contracts/// response
Delete Customer
POST /customer/delete/// response
Import Lead
POST /leads/import/Импорт лида без оплаты.
// response
Transactions
Query Transactions
POST /transactions/query/Главный отчёт по транзакциям.
txnType: SALE / REFUND / VOID / CHARGEBACK / DECLINE / AUTH.// response
Refund Transactions
POST /transactions/refund/// response
Update Transaction
POST /transactions/update// response
Composite Data Query
POST /cbdata/query/Сложные отчётные запросы (cross-table).
// response
Transaction Range Select
POST /cbdata/list/// response
Purchases / Subscriptions
Query Purchases
POST /purchase/query/Подписки / рекуррентные продукты по клиенту.
// response
Update Purchase
POST /purchase/update/// response
Cancel Purchase
POST /purchase/cancel/// response
Pause Purchase
POST /purchase/pause/// response
Refund Purchase
POST /purchase/refund/// response
Products
Query Product
POST /product/query/// response
Create Product
POST /product/create/// response
Update Product
POST /product/update/// response
Campaigns
Query Campaign
POST /campaign/query/// response
Create Campaign
POST /campaign/create/// response
Update Campaign
POST /campaign/update/// response
Gateways / MIDs
Query Gateway
POST /merchant/query/// response
Create Gateway
POST /merchant/create/// response
Update Gateway
POST /merchant/update/// response
Query Recycle Billing
POST /merchant/recycle/query/// response
Query Cascade
POST /merchant/cascade/query/// response
Query Bin Mappings
POST /merchant/binmap/query/// response
Query Bin Profiles
POST /merchant/binprofile/query/// response
Query MID Profile
POST /merchant/profile/query/// response
Coupons
Query Coupon
POST /coupon/query/// response
Create Coupon
POST /coupon/create/// response
Update Coupon
POST /coupon/update/// response
Members / Clubs
Query Club Members
POST /members/query/// response
Update Club Member
POST /members/update/// response
Cancel Membership
POST /members/cancel/// response
Reactivate Membership
POST /members/reactivate/// response
Club Member Login
POST /members/login/// response
Affiliates
Affiliate Query
POST /affiliate/query/// response
Affiliate Create
POST /affiliate/create/// response
Affiliate Update
POST /affiliate/update/// response
Fulfillment
Query Fulfillment
POST /fulfillment/query/// response
Update Fulfillment
POST /fulfillment/update/// response
Reports
MID Summary
POST /reports/mid-summary/// response
Transaction Summary
POST /transactions/summary/// response
Order Summary
POST /order/summary/// response
Retention
POST /reports/retention/// response
BIN Approvals
POST /reports/bin-approvals/// response
Projected Billing
POST /reports/projected-billing/// response
PAAY 3DS (cross-API)
Combined order view: Konnektive + PAAY 3DS
multi-callПо orderId тянет:
/order/query/ → заказ, /transactions/query/ → все транзакции, и для каждого ордера, у которого в ответе есть threeDStransactionId / xid / paayTxnId, дополнительно дёргает PAAY /authenticate/{id} и склеивает результат.// сводный JSON
Get PAAY auth status
GET /v{ver}/authenticate/{transactionId}Финальные 3DS-параметры по PAAY transactionId:
cavv, xid, eci, authValue, messageVersion.// response
Authenticate browser (3DS)
POST /v{ver}/authenticate/browserСтарт 3DS для checkout-флоу. Возвращает frictionless success или challenge URL.
// response
Authenticate 3RI (server-side)
POST /v{ver}/authenticate/3riДля recurring/MIT без браузера. Возвращает auth-result сразу, без challenge.
// response
Raw request
Произвольный запрос
Любой путь Konnektive API. loginId/password добавятся автоматически.
// response