URL
Ниже представлена информация о endpoint и http-методе, используемом для поиска сохраненных карт:
| HTTP Metod | URL |
|---|---|
GET |
/payment/v1/cards |
Параметры запроса
Ожидаемые параметры, которые будут отправлены в запросах на поиск сохраненных карточек, перечислены в таблице и подзаголовках ниже.
| Название параметра | Тип | Обязательный | Объяснение |
|---|---|---|---|
cardId |
long |
Нет | Внутренний идентификатор карты. |
merchantId |
long |
Нет | Фильтр продавца; приоритет имеет авторизованный header. |
subMerchantId |
long |
Нет | Идентификатор субмерчанта. |
buyerId |
long |
Нет | Идентификатор покупателя. |
externalCustomerId |
string |
Нет | Идентификатор клиента в системе продавца. |
partnerId |
long |
Нет | Идентификатор партнера. |
walletId |
long |
Нет | Идентификатор кошелька. |
cardAlias |
string |
Нет | Название карты. |
cardBrand |
string |
Нет | Марка карты. |
cardType |
string |
Нет | Тип карты. CREDIT_CARD, DEBIT_CARD или PREPAID_CARD. |
cardUserKey |
string |
Нет | Пользовательский ключ карты. |
cardToken |
string |
Нет | Token карты? |
cardBankName |
string |
Нет | Название банка. |
cardAssociation |
string |
Нет | Организации карты. VISA, MASTER_CARD, AMEX или TROY |
page |
integer |
Нет | Номер страницы от нуля; минимум 0, по умолчанию 0. |
size |
integer |
Нет | Размер страницы; минимум 1, по умолчанию 10. |
Параметры возврата
| Название параметра | Тип | Объяснение |
|---|---|---|
cardNumber |
string |
Маскированный номер карты. |
binNumber |
string |
Номер Bin |
lastFourDigits |
string |
Последние 4 цифры карты. |
expireYear |
string |
Последний год использования карты. |
expireMonth |
string |
Последний месяц использования карты. |
cardHolderName |
string |
Имя на карте. |
cardUserKey |
string |
Пользовательский ключ карты. |
cardToken |
string |
Token карты? |
cardAlias |
string |
Название карты. |
cardType |
CardType |
Тип карты. CREDIT_CARD, DEBIT_CARD или PREPAID_CARD см. Типы карт |
cardAssociation |
CardAssociation |
Организации карты. VISA, MASTER_CARD, AMEX или TROY см. Организации карт |
cardBrand |
string |
Марка банка. |
cardBankName |
string |
Название банка. |
cardBankId |
number |
ID банка карты. |
Типы карт
Вы можете просмотреть примеры кодов в Odero API client с открытым исходным кодом:
- .NET: https://github.com/TokenPayEng/tokenpay-dotnet-client/blob/master/Samples/PaymentSample.cs
- PHP: https://github.com/TokenPayEng/tokenpay-php-client/blob/master/samples/search_stored_cards.php
- Java: https://github.com/TokenPayEng/tokenpay-java-client/blob/master/src/test/java/tr/com/tokenpay/sample/PaymentSample.java
- Node.js: https://github.com/TokenPayEng/tokenpay-node-client/blob/master/samples/payment/SearchStoredCards.js
Миграция карт
Мигрированные сохраненные карты импортируются через POST /payment/v1/cards. JSON-тело поддерживает cardHolderName, cardNumber, expireYear, expireMonth, cardAlias, onMerchantCardUserKey и onMerchantCardToken. Успешный ответ: 204 No Content.