.. meta:: :description: Настройка шаблонов чеков и сообщений в SBC: настройка email- и SMS-уведомлений, отправляемых клиентам после каждой успешной транзакции. .. _receipt_message: Шаблоны квитанции и сообщения ########################################################## .. role:: ex .. role:: code Введение ======================================== | Шаблоны квитанции и сообщения должны быть отправлены в службу поддержки SBC для установки. | SBC поддерживает доставку чеков и сообщений клиенту после каждой успешной транзакции. | Доступ к чекам осуществляется по уникальному URL, описанному ниже. Сообщения можно отправлять по SMS или email через сервер сообщений Присоединяющейся стороны. Receipt Template ==================================== | Квитанции можно отправлять только в формате HTML. | Идентификатор квитанции можно найти в ответе статуса. .. list-table:: :widths: 50, 50 :header-rows: 1 :class: longtable * - Интеграционная среда - Производственная среда * - :ex:`https://sandbox.sbctech.ru/paynet/view-receipt/ENDPOINT-ID/RECEIPT-ID` - :ex:`https://gate.sbctech.ru/paynet/view-receipt/ENDPOINT-ID/RECEIPT-ID` Макросы шаблона квитанции ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :widths: 48, 52 :header-rows: 1 :class: longtable * - Макрос имени поля - Описание * - :code:`$!{PAYMENT_FORM_HEADER}` - Название на платёжной форме в конечной точке * - :code:`$!{DATE}` - Описание: Order date. * - :code:`$!{DESCRIPTION}` - Описание заказа. * - :code:`$!{AMOUNT}` - Сумма. * - :code:`$!{CURRENCY}` - Валюта, в которой списывается транзакция (трёхбуквенный код валюты). * - :code:`$!{PAYNET_ORDER_ID}` - Идентификатор заказа SBC. * - :code:`$!{MERCHANT_ORDER_ID}` - Идентификатор заказа, назначенный этому заказу Присоединяющейся стороной. * - :code:`$!{RRN}` - Регистрационный номер банка-получателя. * - :code:`$!{AUTH_CODE}` - Authorization Code. * - :code:`$!{AUTH_RESPONSE_CODE}` - Двух- либо шестизначный буквенно-цифровой код, предоставляемый эмитентом, который указывает ответ авторизации (одобрение или отказ). * - :code:`$!{STATUS}` - Order статус. * - :code:`$!{SKIN_VERSION}` - Описание: CSS skin version. * - :code:`$!{BIN}` - Банковский BIN кредитной карты клиента. * - :code:`$!{LAST_FOUR_DIGITS}` - Последние четыре цифры карты. * - :code:`$!{CARD_TYPE}` - Описание: Card type. * - :code:`$!{CARDHOLDER_NAME}` - Карта holder название. * - :code:`$!{DESTINATION_BIN}` - BIN банка номера кредитной карты получателя. * - :code:`$!{DESTINATION_LAST_FOUR_DIGITS}` - Последние четыре цифры карты получателя. * - :code:`$!{DESTINATION_CARD_TYPE}` - Тип карты получателя. * - :code:`$!{PAYNET_PROCESSING_DATE}` - Дата обработки SBC. * - :code:`$!{ACQUIRER_PROCESSING_DATE}` - Дата обработки банком-эквайером. * - :code:`$!{READER_PROCESSING_DATE}` - Дата обработки терминала считывателя. * - :code:`$!{TERMINAL_ID}` - Terminal ID. * - :code:`$!{EMV_ISSUER_RESPONSE}` - Код ответа на запрос авторизации, отправленный эмитентом. * - :code:`$!{EMV_TERMINAL_AID_9F06}` - Идентификатор приложения терминала. Идентифицирует приложение, как описано в ISO/IEC 7816-5. * - :code:`$!{EMV_TVR_95}` - Результаты проверки терминала. Статус различных функций с точки зрения терминала. * - :code:`$!{EVM_CID_9F27}` - Cryptogram Information Data. Указывает тип криптограммы и действия, которые должен выполнить терминал. * - :code:`$!{EMV_APP_LABEL_50}` - Метка приложения. Мнемоника, связанная с AID согласно ISO/IEC 7816-5. * - :code:`$!{EMV_CVR_9F34}` - Результаты метода проверки держателя карты (CVM). Указывает результаты последней выполненной CVM. * - :code:`$!{EMV_APP_CRYPTOGRAM_9f26}` - Криптограмма приложения. Криптограмма, возвращаемая ICC в ответ на команду GENERATE AC. * - :code:`$!{EMV_PAN_SEQUENCE_5f34}` - Application Primary Account Number (PAN) Sequence Number. Идентифицирует и различает карты с одинаковым PAN. * - :code:`$!{PIN_OR_SIGNATURE}` - Запрашивать PIN или только иметь подпись. * - :code:`$!{READER_ENTRY_MODE}` - Конфигурация аутентификации клиента в терминале. * - :code:`$!{HAS_SIGNATURE}` - Наличие подписи (:ex:`TRUE` или :ex:`FALSE`). * - :code:`$!{RECEIPT_ID}` - Receipt ID. * - :code:`$!{RECEIPT_URL}` - URI текущей квитанции. * - :code:`$!{FUNCTIONS}` - Библиотека функций для работы со строками. Пример шаблона квитанции ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. highlight:: html ::

$!AMOUNT $!CURRENCY Paid

Hi $!CARDHOLDER_NAME,
Thank you for your payment through SBC!
Here are your transaction details:

$!CARDHOLDER_NAME
Transaction # : $!PAYNET_ORDER_ID
Paid with $!CARD_TYPE ending with $!LAST_FOUR_DIGITS
$!DATE

The transaction will appear on your credit card statement as nymeria.


gate.sbctech.ru Support@gate.sbctech.ru
Описание: Message template ================================ | Сообщения можно отправлять клиенту в виде обычного текста, SMS или HTML. | Сервер сообщений должен быть указан на уровне проекта или конечной точки. .. _template_macros: Макросы шаблона сообщения ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :widths: 55, 45 :header-rows: 1 :class: longtable * - Макрос имени поля - Описание * - :code:`$!{CARDHOLDER_VALUE}` - Карта printed название. * - :code:`$!{CARDHOLDER_EMAIL}` - Электронная почта держателя карты, переданная во входящем API-запросе. * - :code:`$!{CARDHOLDER_PHONE}` - Номер телефона держателя карты, переданный во входящем API-запросе. * - :code:`$!{CUSTOMER_FULL_NAME}` - Полное имя клиента, отправленное Присоединяющейся стороной через входные параметры. * - :code:`$!{CUSTOMER_FIRST_NAME}` - Имя клиента, отправленное Присоединяющейся стороной через входные параметры. * - :code:`$!{CUSTOMER_LAST_NAME}` - Фамилия клиента, отправленная Присоединяющейся стороной через входные параметры. * - :code:`$!{CUSTOMER_COUNTRY_NAME}` - Название страны клиента, переданное во входящем API-запросе. * - :code:`$!{CUSTOMER_COUNTRY_CODE}` - Страна выставления счёта клиента, переданная во входящем API-запросе. Например: :ex:`IL`, :ex:`RU` и т. д. * - :code:`$!{CUSTOMER_STATE_NAME}` - Название региона клиента, переданное присоединяющейся стороной через входные параметры, если таковые есть в стране клиента. * - :code:`$!{CUSTOMER_STATE_CODE}` - Код региона клиента, переданный присоединяющейся стороной через входные параметры, если таковые есть в стране клиента. * - :code:`$!{CUSTOMER_CITY}` - Название города клиента, переданное во входящем API-запросе. * - :code:`$!{CUSTOMER_ZIP_CODE}` - Описание: Customer's ZIP code. * - :code:`$!{CUSTOMER_ADDRESS1}` - Адрес клиента, переданный во входящем API-запросе. * - :code:`$!{CUSTOMER_ADDRESS2}` - Адрес клиента, переданный во входящем API-запросе, если требовался дополнительный адрес. * - :code:`$!{AMOUNT}` - Сумма. * - :code:`$!{GATEDESCRIPTOR}` - Дескриптор шлюза, указанный в платёжном шлюзе. * - :code:`$!{ORDERDESCRIPTION}` - Описание заказа. * - :code:`$!{CURRENCY}` - Валюта, в которой списывается транзакция (трёхбуквенный код валюты). * - :code:`$!{CARD_NUMBER}` - Описание: 6 + 4 masked card number * - :code:`$!{BIN}` - Банковский BIN кредитной карты клиента. * - :code:`$!{LAST_FOUR_DIGITS}` - Последние четыре цифры карты. * - :code:`$!{CARD_TYPE}` - Описание: Card type. * - :code:`$!{PAYNET_ORDER_ID}` - Идентификатор заказа SBC. * - :code:`$!{MERCHANT_ORDER_ID}` - Идентификатор заказа, назначенный этому заказу Присоединяющейся стороной. * - :code:`$!{CREATED_DATE}` - Дата создания транзакции в SBC. * - :code:`$!{CREATED_YEAR}` - Год создания транзакции в SBC * - :code:`$!{CREATED_MONTH}` - Месяц создания транзакции в SBC * - :code:`$!{CREATED_DAY}` - День создания транзакции в SBC * - :code:`$!{MERCHANT}` - End point display название. * - :code:`$!{MERCHANT_NAME}` - Отображаемое имя Присоединяющейся стороны. * - :code:`$!{MERCHANT_EMAIL}` - Электронная почта Присоединяющейся стороны. * - :code:`$!{ENDPOINT_ID}` - Описание: End point ID. * - :code:`$!{PAYMENT_FORM_NAME}` - Название на платёжной форме в конечной точке. * - :code:`$!{RRN}` - Регистрационный номер банка-получателя. * - :code:`$!{APPROVAL_CODE}` - Код проверки, необходимый для авторизации платежа * - :code:`$!{AUTH_RESPONSE_CODE}` - Двух- либо шестизначный буквенно-цифровой код, предоставляемый эмитентом, который указывает ответ авторизации (одобрение или отказ). * - :code:`$!{STATUS}` - Описание: Status of the order. * - :code:`$!{PAYNET_PROCESSING_DATE}` - Дата обработки SBC (год, месяц, день и время в часовом поясе МСК). * - :code:`$!{ACQUIRER_PROCESSING_DATE}` - Дата обработки банком-эквайером (год, месяц, день и время в часовом поясе МСК). * - :code:`$!{READER_PROCESSING_DATE}` - Дата обработки терминала считывателя (год, месяц, день и время в часовом поясе МСК). * - :code:`$!{TERMINAL_ID}` - Terminal ID. * - :code:`$!{EMV_ISSUER_RESPONSE}` - Код ответа на запрос авторизации, отправленный эмитентом. * - :code:`$!{EMV_TVR_95}` - Результаты проверки терминала. Статус различных функций с точки зрения терминала. * - :code:`$!{EVM_CID_9F27}` - Cryptogram Information Data. Указывает тип криптограммы и действия, которые должен выполнить терминал. * - :code:`$!{EMV_APP_LABEL_50}` - Метка приложения. Мнемоника, связанная с AID согласно ISO/IEC 7816-5. * - :code:`$!{EMV_CVR_9F34}` - Результаты метода проверки держателя карты (CVM). Указывает результаты последней выполненной CVM. * - :code:`$!{EMV_APP_CRYPTOGRAM_9f26}` - Криптограмма приложения. Криптограмма, возвращаемая ICC в ответ на команду GENERATE AC. * - :code:`$!{EMV_PAN_SEQUENCE_5f34}` - Application Primary Account Number (PAN) Sequence Number. Идентифицирует и различает карты с одинаковым PAN. * - :code:`$!{PIN_OR_SIGNATURE}` - Запрашивать PIN или только иметь подпись. * - :code:`$!{READER_ENTRY_MODE}` - Конфигурация аутентификации клиента в терминале. * - :code:`$!{HAS_SIGNATURE}` - Наличие подписи (:ex:`TRUE` или :ex:`FALSE`). * - :code:`$!{RECEIPT_ID}` - Receipt ID. * - :code:`$!{RECEIPT_URI}` - URN текущей квитанции (:ex:`/view-receipt/ENDPOINT-ID/RECEIPT-ID`). * - :code:`$!{PURPOSE}` - Любая дополнительная информация, отправленная Присоединяющейся стороной. * - :code:`$!{MERCHANT_DATA}` - Любая дополнительная информация по данной транзакции, которая может быть полезна во внешних системах Присоединяющейся стороны. * - :code:`$!{ENDPOINT_SEQUENCE_VALUE}` - Используется при наличии последовательности конечных точек, увеличивающейся на единицу в числовом формате. Примеры шаблона сообщения ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | Пример шаблона обычного текста и SMS: .. code-block:: none $!{AMOUNT} $!{CURRENCY} Paid Hi $!{CARDHOLDER_VALUE}, Thank you for your payment through SBC! Here are your transaction details: $!{CARDHOLDER_VALUE} Transaction # : $!{PAYNET_ORDER_ID} Paid with $!{CARD_TYPE} ending with $!{LAST_FOUR_DIGITS} $!{CREATED_DATE} The transaction will appear on your credit card statement as nymeria. | Пример HTML-шаблона: .. highlight:: html ::

$!AMOUNT $!CURRENCY Paid

Hi $!CARDHOLDER_VALUE,
Thank you for your payment through SBC!
Here are your transaction details:

$!CARDHOLDER_VALUE
Transaction # : $!PAYNET_ORDER_ID
Paid with $!CARD_TYPE ending with $!LAST_FOUR_DIGITS
$!CREATED_DATE

The transaction will appear on your credit card statement as nymeria.


gate.sbctech.ru Support@gate.sbctech.ru