Payment Docs
Карточные методы

Тип VX

Как провести платёж через терминал типа VX.

Перед началом работы

Как авторизовать запросы

Как создавать обычные заказы

Эта интеграция доступна не всем мерчантам. Уточните доступность у вашего менеджера.

Чем отличается от обычного заказа?

Для этого способа оплаты вы добавляете дополнительные поля в customer, а также externalUserId. Остальные поля (amount, currency, successUrl, failUrl и т. д.) остаются такими же, как при создании обычного заказа.

Для этого способа оплаты поле externalUserId является обязательным.

Дополнительные поля для обычного заказа

ПолеТипОписание
customerobjectДанные покупателя (email, телефон, адрес и т. д.)

Запросы для каждой страны

Япония 🇯🇵

Поля объекта customer (Обязательно)

ПолеТипОписание
phonestringНомер телефона (реальный), 11 цифр, начинающиеся с 0 без кода страны (например 09012345678)
emailstringEmail покупателя
firstNamestringИмя на Катакане (должен совпадать с владельцем номера)
lastNamestringФамилия на Катакане (должен совпадать с владельцем номера)
ipstringIP плательщика (реальный)

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

{
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "externalId": "23456789",
  "externalUserId": "437568",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "callbackUrl": "https://example.com",
  "currency": "JPY",
  "customer": {
    "lastName": "ヤマダ",
    "firstName": "タロウ",
    "email": "john.doe@example.com",
    "phone": "09123456789",
    "ip": "192.168.0.1"
  }
}

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

{
  "id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "status": "CREATED",
  "statusMessage": "Ok",
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "currency": "JPY",
  "paymentType": null,
  "shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "fingerprint": null,
  "ipAddress": null,
  "gatewayTransactionId": null,
  "merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "externalId": "23456789",
  "externalUserId": "437568",
  "paymentLink": "https://example.com/payment",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "metadata": null,
  "callbackUrl": "https://example.com",
  "payedAt": null,
  "updatedAt": "2023-03-21T12:34:56Z",
  "createdAt": "2023-03-21T12:34:56Z"
}

Корея 🇰🇷

Поля объекта customer (Обязательно)

ПолеТипОписание
phonestringНомер телефона (реальный), 11 цифр, начинающиеся с 0 без кода страны (например 09012345678)
emailstringEmail покупателя
firstNamestringИмя на Катакане (должен совпадать с владельцем номера)
lastNamestringФамилия на Катакане (должен совпадать с владельцем номера)
ipstringIP плательщика (реальный)
birthdaystringДата рождения (только для VA)

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

{
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "externalId": "23456789",
  "externalUserId": "437568",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "callbackUrl": "https://example.com",
  "currency": "KRW",
  "customer": {
    "lastName": "abc",
    "firstName": "efg",
    "email": "john.doe@example.com",
    "phone": "01012459077",
    "ip": "192.168.0.1",
    "birthday": "1992-08-15"
  }
}

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

{
  "id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "status": "CREATED",
  "statusMessage": "Ok",
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "currency": "KRW",
  "paymentType": null,
  "shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "fingerprint": null,
  "ipAddress": null,
  "gatewayTransactionId": null,
  "merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "externalId": "23456789",
  "externalUserId": "437568",
  "paymentLink": "https://example.com/payment",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "metadata": null,
  "callbackUrl": "https://example.com",
  "payedAt": null,
  "updatedAt": "2023-03-21T12:34:56Z",
  "createdAt": "2023-03-21T12:34:56Z"
}

Индия 🇮🇳

Поля объекта customer (Обязательно)

ПолеТипОписание
phonestringНомер телефона (реальный), 10 цифр, начинающиеся с 6, 7, 8, 9
emailstringEmail покупателя
firstNamestringИмя на Катакане (должен совпадать с владельцем номера)
lastNamestringФамилия на Катакане (должен совпадать с владельцем номера)
ipstringIP плательщика (реальный)

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

{
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "externalId": "23456789",
  "externalUserId": "437568",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "callbackUrl": "https://example.com",
  "currency": "INR",
  "customer": {
    "lastName": "abc",
    "firstName": "efg",
    "email": "john.doe@example.com",
    "phone": "918234567890",
    "ip": "192.168.0.1"
  }
}

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

{
  "id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "status": "CREATED",
  "statusMessage": "Ok",
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "currency": "INR",
  "paymentType": null,
  "shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "fingerprint": null,
  "ipAddress": null,
  "gatewayTransactionId": null,
  "merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "externalId": "23456789",
  "externalUserId": "437568",
  "paymentLink": "https://example.com/payment",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "metadata": null,
  "callbackUrl": "https://example.com",
  "payedAt": null,
  "updatedAt": "2023-03-21T12:34:56Z",
  "createdAt": "2023-03-21T12:34:56Z"
}

Филипины 🇵🇭

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

{
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "externalId": "23456789",
  "externalUserId": "437568",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "callbackUrl": "https://example.com",
  "currency": "PHP"
}

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

{
  "id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "status": "CREATED",
  "statusMessage": "Ok",
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "currency": "PHP",
  "paymentType": null,
  "shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "fingerprint": null,
  "ipAddress": null,
  "gatewayTransactionId": null,
  "merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "externalId": "23456789",
  "externalUserId": "437568",
  "paymentLink": "https://example.com/payment",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "metadata": null,
  "callbackUrl": "https://example.com",
  "payedAt": null,
  "updatedAt": "2023-03-21T12:34:56Z",
  "createdAt": "2023-03-21T12:34:56Z"
}

Индонезия 🇮🇩

Поля объекта customer (Обязательно)

ПолеТипОписание
phonestringНомер телефона (реальный), 10-13 цифр, начинающиеся с 08 или 628
emailstringEmail покупателя
firstNamestringИмя на Катакане (должен совпадать с владельцем номера)
lastNamestringФамилия на Катакане (должен совпадать с владельцем номера)

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

{
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "externalId": "23456789",
  "externalUserId": "437568",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "callbackUrl": "https://example.com",
  "currency": "IDR",
  "customer": {
    "lastName": "abc",
    "firstName": "efg",
    "email": "john.doe@example.com",
    "phone": "6281245907765"
  }
}

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

{
  "id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "status": "CREATED",
  "statusMessage": "Ok",
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "currency": "IDR",
  "paymentType": null,
  "shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "fingerprint": null,
  "ipAddress": null,
  "gatewayTransactionId": null,
  "merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "externalId": "23456789",
  "externalUserId": "437568",
  "paymentLink": "https://example.com/payment",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "metadata": null,
  "callbackUrl": "https://example.com",
  "payedAt": null,
  "updatedAt": "2023-03-21T12:34:56Z",
  "createdAt": "2023-03-21T12:34:56Z"
}

Тип NP

Как провести платёж через терминал типа NP.

Тип DL

Как провести платёж через терминал типа DL.

На этой странице

Перед началом работыЧем отличается от обычного заказа?Дополнительные поля для обычного заказаЗапросы для каждой страныЯпония 🇯🇵Поля объекта customer (Обязательно)Пример запросаПример ответаКорея 🇰🇷Поля объекта customer (Обязательно)Пример запросаПример ответаИндия 🇮🇳Поля объекта customer (Обязательно)Пример запросаПример ответаФилипины 🇵🇭Пример запросаПример ответаИндонезия 🇮🇩Поля объекта customer (Обязательно)Пример запросаПример ответа