SDK модуль для внедрения эквайринга Райффайзенбанка.
Установка:
$ npm require @raiffeisen-ecom/payment-sdk-nodeПодключение для cjs-модулей:
const { Client, ClientException } = require('@raiffeisen-ecom/payment-sdk-node');Подключение для esm-модулей:
import { Client, ClientException } from '@raiffeisen-ecom/payment-sdk-node';**Raiffeisenbank e-commerce API: https://pay.raif.ru/doc/ecom.html
Для использования SDK требуется секретный ключ secretKey и идентификатор мерчанта publicId, подробности в документации и на сайте банка.
const secretKey = '***';
const publicId = '***';
const client = new Client(secretKey, publicId);Параметры конструктора и свойства клиента:
secretKey- секретный ключ, обязательный, доступ только на запись;publicId- идентификатор мерчанта, обязательный, доступ на чтение и запись;host- хост api, по умолчаниюhttps://e-commerce.raiffeisen.ru, доступ на чтение и запись;options- дополнительные параметры запроса, доступ только на чтение.
Пользователь совершает следующие действия в процессе платежа:
- Выбирает товары/услуги в корзину магазина и нажимает кнопку “Оплатить”;
- Партнер открывает платежную форму;
- Клиент вводит реквизиты на платежной форме и подтверждает платеж.
Метод postCallbackUrl устанавливает адресс приема событий.
В параметрах нужно указать:
callbackUrl- невый URL.
const callbackUrl = 'http://test.ru/';
client.postCallbackUrl(callbackUrl);Метод getPayUrl возвращает ссылку на платежную форму.
В параметрах нужно указать:
amount- сумма заказа;orderId- идентификатор заказа;query- дополнительные параметры запроса.
const amount = 10;
const orderId = 'testOrder';
const query = {
successUrl: 'http://test.ru/',
};
const link = client.getPayUrl(amount, orderId, query);
console.log(link);Вывод:
https://e-commerce.raiffeisen.ru/pay/?publicId=***&amount=10&orderId=testOrder&successUrl=http%3A%2F%2Ftest.ru%2F
Метод postPayUrl возвращает ссылку платежную форму в виде html-страницы.
В параметрах нужно указать:
amount- сумма заказа;orderId- идентификатор заказа;query- дополнительные параметры запроса, а так же параметры чека.
const amount = 10;
const orderId = 'testOrder';
const query = {
successUrl: 'http://test.ru/',
receipt: {
customer: { ... },
items: { ... }
}
};
client.postPayUrl(amount, orderId, query);Метод getOrderTransaction возвращает информацию о статусе транзакции.
В параметрах нужно указать:
orderId- идентификатор заказа.
const orderId = 'testOrder';
const response = await client.getOrderTransaction(orderId);
console.log(response);Вывод:
{
"code": "SUCCESS",
"transaction": {
"id": 120059,
"orderId": "testOrder",
"status": {
"value": "SUCCESS",
"date": "2019-07-11T17:45:13+03:00"
},
"paymentMethod": "acquiring",
"paymentParams": {
"rrn": 935014591810,
"authCode": 25984
},
"amount": 12500.5,
"comment": "Покупка шоколадного торта",
"extra": {
"additionalInfo": "Sweet Cake"
}
}
}Метод getPayJS вернет JavaScript для отображения платежной формы на странице.
Данный метод подходит для передачи чеков.
В параметрах нужно указать:
amount- сумма заказа;orderId- идентификатор заказа;query- дополнительные параметры запроса, а так же параметры чека.
const amount = 10;
const orderId = 'testOrder';
const query = {
'receipt': {
'items': [
{
'name': 'Тестовый товар',
'price': 10,
'quantity': 1,
'paymentObject': 'COMMODITY',
'paymentMode': 'FULL_PAYMENT',
'amount': 10,
'vatType': 'VAT20'
}
]
}
};
const js = client.getPayJS(amount, orderId, query);
console.log(js);Вывод:
(({
publicId,
formData,
url = 'https://e-commerce.raiffeisen.ru/pay',
method = 'openPopup',
sdk = 'PaymentPageSdk',
src = 'https://pay.raif.ru/pay/sdk/v2/payment.styled.min.js',
}) => new Promise((resolve, reject) => {
const openPopup = () => {
new this[sdk](publicId, {url})[method](formData).then(resolve).catch(reject);
};
if (!this.hasOwnProperty(sdk)) {
const script = this.document.createElement('script');
script.src = src;
script.onload = openPopup;
script.onerror = reject;
this.document.head.appendChild(script);
} else openPopup();
}))({
"publicId": "***",
"url": "https://e-commerce.raiffeisen.ru/pay",
"formData": {
"orderId": "testOrder",
"amount": 10,
"receipt": {
"items": [
{
"name": "Тестовый товар",
"price": 10,
"quantity": 1,
"paymentObject": "COMMODITY",
"paymentMode": "FULL_PAYMENT",
"amount": 10,
"vatType": "VAT20"
}
]
}
}
})Данный JS можно встроить на страницу непосредственно с помощью тега SCRIPT или использовать как Promise в собственных сценариях.
Метод postOrderRefund создает возврат по заказу.
В параметрах нужно указать:
orderId- идентификатор заказа;refundId- идентификатор заказа;amount- сумма возврата.
const orderId = 'testOrder';
const refundId = 'testRefund';
const amount = 150;
const response = await client.postOrderRefund(orderId, refundId, amount);
console.log(response);Вывод:
{
"code": "SUCCESS",
"amount": 150,
"refundStatus": "IN_PROGRESS"
}Метод getOrderRefund возвращает статус возврата.
В параметрах нужно указать:
orderId- идентификатор заказа;refundId- идентификатор заказа.
const orderId = 'testOrder';
const refundId = 'testRefund';
const response = await client.getOrderRefund(orderId, refundId);
console.log(response);Вывод:
{
"code": "SUCCESS",
"amount": 150,
"refundStatus": "COMPLETED"
}Метод getOrder возвращает данные о заказе.
В параметрах нужно указать:
orderId- идентификатор заказа.
const orderId = 'testOrder';
const response = await client.getOrder(orderId);
console.log(response);Вывод:
{
"amount": 12500.5,
"comment": "Покупка шоколадного торт",
"extra": {
"additionalInfo": "sweet cake"
},
"status": {
"value": "NEW",
"date": "2019-08-24T14:15:22+03:00"
},
"expirationDate": "2019-08-24T14:15:22+03:00"
}Метод deleteOrder удаляет заказ, если он не был оплачен.
В параметрах нужно указать:
orderId- идентификатор заказа.
const orderId = 'testOrder';
client.deleteOrder(orderId);Метод getOrderReceipts возвращает список чеков.
В параметрах нужно указать:
orderId- идентификатор заказа.receiptType- необязательное, тип чека:- sell – чек прихода;
- refund – чек возврата.
const orderId = 'testOrder';
const response = await client.getOrderReceipts(orderId);
console.log(response);Вывод:
[
{
"receiptNumber": "3000827351831",
"receiptType": "REFUND",
"status": "DONE",
"orderNumber": "testOrder",
"total": 1200,
"customer": {
"email": "customer@test.ru",
"name": "Иванов Иван Иванович"
},
"items": [
{
"name": "Шоколадный торт",
"price": 1200,
"quantity": 1,
"amount": 1200,
"paymentObject": "COMMODITY",
"paymentMode": "FULL_PREPAYMENT",
"measurementUnit": "шт",
"nomenclatureCode": "00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00",
"vatType": "VAT20",
"agentType": "ANOTHER",
"supplierInfo": {
"phone": "+79991234567",
"name": "ООО «Ромашка»",
"inn": "1234567890"
}
}
]
}
]Метод getOrderRefundReceipt возвращает чек возврата.
В параметрах нужно указать:
orderId- идентификатор заказа;refundId- идентификатор возврата.
const orderId = 'testOrder';
const refundId = 'testRefund';
const response = await client.getOrderRefundReceipt(orderId, refundId);
console.log(response);Вывод:
{
"receiptNumber": "3000827351831",
"receiptType": "REFUND",
"status": "DONE",
"orderNumber": "testOrder",
"total": 1200,
"customer": {
"email": "customer@test.ru",
"name": "Иванов Иван Иванович"
},
"items": [
{
"name": "Шоколадный торт",
"price": 1200,
"quantity": 1,
"amount": 1200,
"paymentObject": "COMMODITY",
"paymentMode": "FULL_PREPAYMENT",
"measurementUnit": "шт",
"nomenclatureCode": "00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00",
"vatType": "VAT20",
"agentType": "ANOTHER",
"supplierInfo": {
"phone": "+79991234567",
"name": "ООО «Ромашка»",
"inn": "1234567890"
}
}
]
}Метод checkEventSignature проверяет подпись уведомления о платеже.
В параметрах нужно указать:
signature- содержимое заголовкаx-api-signature-sha256;eventBody- разобранный JSON из тела запроса.
const signature = '***';
const eventBody = {
event: 'payment',
transaction: {
id: 120059,
orderId: 'testOrder',
status: {
value: 'SUCCESS',
date: '2019-07-11T17:45:13+03:00'
},
paymentMethod: 'acquiring',
paymentParams: {
rrn: 935014591810,
authCode: 25984
},
amount: 12500.5,
comment: 'Покупка шоколадного торта',
extra: {
additionalInfo: 'Sweet Cake'
}
}
};
client.checkEventSignature(signature, eventBody); // true or false- node v10 или выше