Належність картки конкретному ІПН

POST /ecom/jws/cardholder/verify_card_inn_v1

Ендпоінт використовується для перевірки належності картки до конкретного ІПН

Вхідні параметри:

Параметр	Опис	Формат даних	Обовʼязковість	Приклад
merchantId	Id мерчанту згенерований в Єкомі	uuid(36)	Так	137d9304-0368-11ed-b939-0242ac120002
encryptedCardNumber	номер карти зашифрований в JWE за допомогою публічного платіжного ключа	string	Так	{{encryptedPanT}}
inn	іпн відправника	string (10)	Так	123456789
requestId	Id запиту мерчанта	uuid	Так	337d9304-0368-11ed-b939-0242ac120003
requestType	тип запиту	string	Так	CREDIT, PAYMENT, BETTING.
userApproval	згода клієнта на передачу даних третій стороні	boolean	Так	true

Вихідні параметри:

Параметр	Опис	Формат даних	Приклад
result	Статус перевірки	boolean	true|false
msgText	Опис результату або причини помилки	string

Приклад запиту

{
  "merchantId": "467c8a10-c705-11ed-afa1-0242ac120002",
  "encryptedCardNumber": "{{encryptedPanT}}",
  "inn": "3126509874",
  "requestId": "337d9304-0368-11ed-b939-0242ac120003",
  "requestType": "BETTING",
  "userApproval": true
}

Приклад відповіді

{
  "result": true,
  "msgText": ""
}

#	Ситуація	result	msgText	httpStatus
1	BIN та ІПН збігся	true	Success	200
2	BIN та ІПН не збігся	false	INN mismatch	200
3	BIN Альянсу, картку не знайдено	false	Card not found	200
4	BIN Альянсу, клієнта не знайдено	false	Client not found	200
5	BIN Альянсу, помилка читання картки	false	Card read error	200
6	AFHUB вимкнено(для локального запуску)	false	Verification is disabled	503
7	немає в d_afhub_bin / неоднозначний BIN	false	Card not found	404
11	AFHUB відповів 405 (потрібен encrypted mode)	false	Encrypted mode required	405
12	AFHUB відповів 401 (помилка підпису/автентифікації)	false	AFHUB authentication failed	401
13	AFHUB application-помилка {code,message} (напр. code=9)	false	текст message від AFHUB	статус від AFHUB
14	AFHUB недоступний після 3 спроб (500/503/timeout)	false	AFHUB verification unavailable	503
15	Неочікувана внутрішня помилка AFHUB-флоу	false	AFHUB verification unavailable	500