1.1.2 • Published 2 years ago

robokassa-node v1.1.2

Weekly downloads
-
License
ISC
Repository
github
Last release
2 years ago

Robokassa Node

Пакет для работы с сервисом эквайринга Robokassa

Установка

npm install robokassa-node --save

Использование

Всю документацию по работе с API Робокассы можно найти здесь: https://docs.robokassa.ru

import { Robokassa } from 'robokassa-node';
import type { RobokassaConfig } from 'robokassa-node';

const config: RobokassaConfig = {
    merchantId: YOUR_MERCHANT_ID,
    passwordOne: YOUR_PASSWORD_1,
    passwordTwo: YOUR_PASSWORD_2,
    hashAlgo: 'MD5',
}

const robokassa = new Robokassa(config);

Поддерживаются методы:

  • async generatePaymentLink(order: Order): Promise - возвращает ссылку, ведущую на страницу оплаты

   const order: Order = {
    outSum: 1000,
    additionalParams: {
        orderId: 'order_1',
    },
    description: `Описание заказа`,
    email: 'your@email.com',
    items: [
        {
            name: `Товар "Товар 1"`,
            quantity: 1,
            sum: "1000.00",
            tax: PaymentTax.NONE,
            payment_method: PaymentMethod.FULL_PREPAYMENT,
            payment_object: PaymentObject.COMMODITY,
        },
    ],
};

const paymentLink = await robokassa.generatePaymentLink(order);
  • async checkPayment(params: CheckPaymentParams): Promise - проверяет, успешно ли прошла оплата, в зависимости от переданных Робокассой параметров.

CheckPaymentParams
ПараметрТипОписаниеОбязательный
sumstringСумма заказа, которая приходит от РобокассыДа
invIdnumberномер заказа в Робокассе, приходит в ответеДа
signaturestringПодпись, приходит из РобоказзыДа
orderOrderСущность заказаДа
   const order: Order = {
    outSum: 1000,
    additionalParams: {
        orderId: 'order_1',
    },
    description: `Описание заказа`,
    email: 'your@email.com',
    items: [
        {
            name: `Товар "Товар 1"`,
            quantity: 1,
            sum: "1000.00",
            tax: PaymentTax.NONE,
            payment_method: PaymentMethod.FULL_PREPAYMENT,
            payment_object: PaymentObject.COMMODITY,
        },
    ],
};

const invId = 1;
const signature = 'SIGNATRUE_FROM_ROBOKASSA_RESPONSE';

const params = {
    signature,
    invId,
    sum: "1000.000000",
    order
}

const isSuccessfull = await robokassa.checkPayment(params);
  • async checkPaymentSuccessURL(signature: string, invId: number, order: Order): Promise - проверяет, успешно ли прошла оплата при редиректе Робокассой на указанный в настройках URL успешной оплаты.
   const order: Order = {
        outSum: 1000,
        additionalParams: {
            orderId: 'order_1',
        },
        description: `Описание заказа`,
        email: 'your@email.com',
        items: [
            {
                name: `Товар "Товар 1"`,
                quantity: 1,
                sum: "1000.00",
                tax: PaymentTax.NONE,
                payment_method: PaymentMethod.FULL_PREPAYMENT,
                payment_object: PaymentObject.COMMODITY,
            },
        ],
   };

   const invId = 1;
   const signature = 'SIGNATRUE_FROM_ROBOKASSA_RESPONSE';

   const isSuccessfull = await robokassa.checkPaymentSuccessURL(signature, invId, order);

Параметры и интерфейс

RobokassaConfig

ПараметрТипОписаниеОбязательный
merchantIdstringВаш идентификатор магазинаДа
passwordOnestringПароль#1Да
passwordTwostringПароль#2Да
hashAlgoMD5, SHA1, SHA256, SHA384, SHA512Алгоритм шифрования для создания подписиДа
isTestbooleanТестовый режим оплаты (по умолчанию - false)Нет
cultureru, enНет
encodingutf-8, win-1251КодировкаНет
additionalParamPrefixshp , Shp, SHP_Префикс для пользовательских параметров, переданных в ссылку для оплатыНет
debugbooleanРежим отладкиНет

Order

ПараметрТипОписаниеОбязательный
outSumnumberСумма заказаДа
descriptionstringОписание заказаДа
invIdnumberИдентификатор заказа в РобокассеНет
emailstringEmail покупателяДа
expirationDateDateДата, до которой возможна оплата заказаНет
additionalParamsRecord<string, any>Дополнительные пользовательские параметрыНет
itemsReceiptItem[]Массив товаров для фискализацииНет
snoSNOСистема налогообложениыНет

Отказ от ответственности

Этот пакет не является официальным пакетом для работы с сервисом РОБОКАССА. Используйте на свой страх и риск.

1.1.1

2 years ago

1.1.0

2 years ago

1.0.9

2 years ago

1.0.8

2 years ago

1.0.7

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.4

2 years ago

1.1.2

2 years ago

1.0.11

2 years ago

1.0.10

2 years ago

1.0.15

2 years ago

1.0.14

2 years ago

1.0.13

2 years ago

1.0.12

2 years ago

1.0.3

3 years ago

1.0.2

3 years ago

1.0.1

3 years ago

1.0.0

3 years ago