Тип OB

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

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

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

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

Поле	Тип	Описание
`customer`	object	Данные покупателя (имя, страна, email)

Поля объекта customer

Поле	Тип	Описание
`firstName`	string	Имя (обязательно)
`lastName`	string	Фамилия (обязательно)
`country`	string	Код страны для платежа (обязательно)
`email`	string	Email покупателя (опционально)

Поддерживаемые валюты и страны

Страна	Валюта	Код страны
Страны ЕС	`EUR`	ISO 3166-1 alpha-2 (например, `DE`)

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

{
  "purpose": "Payment for order #1234",
  "amount": "1000.5",
  "externalId": "external_id",
  "externalUserId": "external_user_id",
  "successUrl": "https://example.com",
  "failUrl": "https://example.com",
  "callbackUrl": "https://example.com",
  "currency": "EUR",
  "isFeeOnUser": false,
  "customer": {
    "lastName": "Doe",
    "firstName": "John",
    "country": "DE",
    "email": "john.doe@example.com"
  }
}

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

{
  "id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
  "status": "CREATED",
  "statusMessage": "Ok",
  "purpose": "Payment for order #1234",
  "amount": "1000.5",
  "currency": "EUR",
  "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": "external_id",
  "externalUserId": "external_user_id",
  "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"
}

Тип OB

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

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

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