Создать платёж (API v2)

POST

https://api.smerch.io/api/v2/integration/transactions

Создание платежа на /api/v2. Может требовать Idempotency-Key — см. схему.

Если выбранный метод помечен «Особые требования», передайте стабильный ID плательщика из вашей системы в metadata.userId.

Те же правила валют, что в v1: на рублёвом СБП-рельсе USD-intent size'ится в RUB по mid; markup — на settlement.

Сценарий такой же, как в v1: перенаправьте плательщика или используйте данные оплаты из ответа, затем дождитесь webhook.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

API Key

Add parameter in header

X-Signature

Example:

X-Signature: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Платёж создан

Headers

Bodyapplication/json

🟠401Problem

🟠409Problem

🟠422Problem

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.smerch.io/api/v2/integration/transactions' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "amount": 1,
    "currency": "RUB",
    "payment_method": "string",
    "external_id": "string",
    "description": "string",
    "metadata": {
        "userId": "string",
        "userName": "string",
        "clientIp": "string",
        "property1": "string",
        "property2": "string"
    },
    "callback_url": "http://example.com",
    "success_url": "http://example.com",
    "fail_url": "http://example.com"
}'

Response Example

201 - Example 1

{
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "type": "string",
    "amount": 0,
    "gross_amount": 0,
    "net_amount": 0,
    "fee_amount": 0,
    "fee_payer": "string",
    "merchant_fee_share_bps": 0,
    "merchant_fee_merchant_amount": 0,
    "merchant_fee_customer_amount": 0,
    "currency": "string",
    "payment_method": "string",
    "status": "pending",
    "status_detail": "awaiting_payment",
    "status_category": "pending",
    "external_id": "string",
    "description": "string",
    "metadata": {
        "property1": "string",
        "property2": "string"
    },
    "payment_url": "http://example.com",
    "requisites": {
        "property1": "string",
        "property2": "string"
    },
    "expires_at": "2019-08-24T14:15:22.123Z",
    "paid_at": "2019-08-24T14:15:22.123Z",
    "settle_available_at": "2019-08-24T14:15:22.123Z",
    "created_at": "2019-08-24T14:15:22.123Z",
    "updated_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-10-20 12:31:06

Список платежей (API v2)

CreatePayoutRequest