Перейти к содержанию

Проведение платежа

Метод запроса: POST

https://b2b.rubikonpay.ru/api/v1/payments/card2account/invoice

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

Параметр Обязательно Описание
api_key Да Ключ объекта. Выдается менеджером.
transaction Да Идентификатор транзакции мерчанта. Формат UUID.
signature Да Подпись. Формирование подписи: sha256({api_key}{transaction}{amount}{crypto_key} .
{crypto_key} - секретный ключ, который выдается менеджером. Подпись формируется конкатенацией параметров без фигурных скобок.
amount Да Сумма в копейках. Минимальная сумма от 100 до 400 000 рублей.
description Да Описание платежа.
return_url Да URL для возврата пользователя после оплаты.
payload Да Информация о пользователе.
payload.client_id Да Идентификатор пользователя в системе мерчанта.
payload.client_ip Да IP адрес пользователя.
payload.* Нет Любые параметры мерчанта. Будут приходить в колбэке

Тело запроса:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
    "api_key": "e467511f-e0c64ae5-b9ec-ebbe0b4dbbee",
    "transaction": "810652a5-b90b-4311916b-21de3a19f434",
    "amount": 3000,
    "description": "Пополнение счет 123456789",
    "signature": "10b57ab8e492bbd00f1cebdbe87ba81afb0c260c0e4d803bcab21abb24663757",
    "return_url": "https://example.com/result",
    "payload": {
        "client_id": "2243234543",
        "client_ip": "92.222.181.151",
        "some_field": "bla bla"
    }
}

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
    "transaction": "810652a5-b90b-4311916b-21de3a19f434",
    "redirect_url": "https://cardgate.paycore.io/hpp/cgi_05gePutedTrwsg4z",
    "payment": {
        "id": 98676,
        "state": "processing",
        "error_code": null,
        "error_description": null,
        "credentials": {
            "card_pan": "4111111111111111"
        },
        "created_at": "20210826T201009.218205Z"
    },
    "deeplink": {
        "TINKOFF_FOREIGN": "redirect url",
        "SBER_FOREIGN": "redirect url",
        "VTB_FOREIGN": "redirect url"
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
{
    "transaction": "810652a5-b90b-4311916b-21de3a19f434",
    "redirect_url": "https://cardgate.paycore.io/hpp/cgi_05gePutedTrwsg4z",
    "payment": {
        "id": 98676,
        "state": "processing",
        "error_code": null,
        "error_description": null,
        "credentials": {
            "phone": "79151283153",
            "holder": "Сутягин Вячеслав Георгиевич"
        },
        "created_at": "20210826T201009.218205Z"
    },
    "deeplink": {
        "TINKOFF_FOREIGN": "redirect url",
        "SBER_FOREIGN": "redirect url",
        "VTB_FOREIGN": "redirect url"
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
{
    "api_key": [
        "Это поле обязательно."
    ],
    "transaction": [
        "Это поле обязательно."
    ],
    "amount": [
        "Это поле обязательно."
    ],
    "signature": [
        "Это поле обязательно."
    ],
    "return_url": [
        "Это поле обязательно."
    ]
}

1
2
3
{
    "message": "Отказ антифрода."
}

1
2
3
{
    "message": "Hеизвестная ошибка."
}

Параметры успешного ответа:

Параметр Описание
transaction Идентификатор транзакции мерчанта. Формат UUID.
redirect_url URL для перенаправления пользователя на платежную страницу.
payment.id ID платежа в системе.
payment.state Статус платежа. Список статусов платежа:
processing — в обработке
declined — отклонен
deposited — оплачен
Если статус платежа был получен processing, то необходимо вызывать метод получения статуса платежа п.2. или с помощью колбэков п.4. Если платеж спустя 24 часа висит "в обработке", то необходимо обратиться к менеджеру.
payment.error_code Код ошибки.
payment.error_description Описание ошибки.
payment.credentials Реквизиты получателя. Перевод на карту или СБП.
payment.credentials.card_pan Номер карты получателя.
payment.credentials.phone Номер телефона получателя.
payment.credentials.holder ФИО получателя.
payment.created_at Дата создания платежа.
deeplink Объект с deeplink урлами.