Перейти к основному содержимому

cards.create

Параметры запроса

ИмяТипОписание
idIntegerИдентификатор запроса.
cardObjectПараметры карты.
numberStringНомер карты.
expireStringСрок окончания действия карты.
accountObjectОбъект Account. Параметр не обязательный.
saveBooleanВид токена. Необязательный параметр. Параметр включается или отключается в зависимости от бизнес-логики приложения . Если флаг true токен можно использовать для дальнейших платежей; если флаг false токеном можно использовать только один раз. Одноразовый токен после оплаты удаляется.
customerStringЛюбой идентификатор пользователя (номер телефона, uid, email)

Формат запроса

{
card: {
number String,
expire: String
},
account: Object,
save: Boolean
}

Пример запроса

POST /api HTTP/1.1
Host: checkout.test.paycom.uz
X-Auth: 100fe486b33784292111b7dc
Cache-Control: no-cache

{
"id": 123,
"method": "cards.create",
"params": {
"card": { "number": "8600069195406311", "expire": "0399"},
"save": true
}
}

Параметры ответа

ИмяТипОписание
idIntegerИдентификатор ответа — соответствует идентификатору запроса.
numberStringНеполный номер карты. Строка может храниться на сервере мерчанта.
expireStringСрок окончания действия карты.
tokenStringТокен карты.
recurrentBooleanФлаг. Флаг определяет доступность карты для последующих платежей.
verifyBooleanФлаг. Если флаг true карта проверена способом OTP (one time password).

Формат ответа

{
card: {
number: String,
expire: String,
token: String,
recurrent: Boolean,
verify: Boolean
}
}

Пример ответа:

{
"jsonrpc": "2.0",
"id": 123,
"result": {
"card": {
"number": "860006******6311",
"expire": "03/99",
"token": "NTg0YTg0ZDYyYWJiNWNhYTMxMDc5OTE0X1VnYU02ME92IUttWHVHRThJODRJNWE0Xl9EYUBPQCZjNSlPRlpLIWNWRz1PNFp6VkIpZU0kQjJkayoyVUVtUuKElmt4JTJYWj9VQGNAQyVqT1pOQ3VXZ2NyajBEMSYkYj0kVj9NXikrJE5HNiN3K25pKHRQOEVwOGpOcUYxQ2dtemk9dDUwKDNATjd2XythbibihJYoJispJUtuREhlaClraGlJWTlLMihrLStlRjd6MFI3VCgjVDlpYjQ1ZThaMiojPVNTZylYJlFWSjlEZGFuSjZDNDJLdlhXP3YmV1B2dkRDa3g5X2l4N28oU0pOVEpSeXZKYnkjK0h3ViZfdmlhUHMp",
"recurrent": true,
"verify": false
}
}
}