5.3. Шаблоны квитанции и сообщения

Введение

Шаблоны квитанции и сообщения должны быть отправлены в службу поддержки SBC для установки.
SBC поддерживает доставку чеков и сообщений клиенту после каждой успешной транзакции.
Доступ к чекам осуществляется по уникальному URL, описанному ниже. Сообщения можно отправлять по SMS или email через сервер сообщений Присоединяющейся стороны.

Receipt Template

Квитанции можно отправлять только в формате HTML.
Идентификатор квитанции можно найти в ответе статуса.

Интеграционная среда

Производственная среда

https://sandbox.sbctech.ru/paynet/view-receipt/ENDPOINT-ID/RECEIPT-ID

https://gate.sbctech.ru/paynet/view-receipt/ENDPOINT-ID/RECEIPT-ID

Макросы шаблона квитанции

Макрос имени поля

Описание

$!{PAYMENT_FORM_HEADER}

Название на платёжной форме в конечной точке

$!{DATE}

Описание: Order date.

$!{DESCRIPTION}

Описание заказа.

$!{AMOUNT}

Сумма.

$!{CURRENCY}

Валюта, в которой списывается транзакция (трёхбуквенный код валюты).

$!{PAYNET_ORDER_ID}

Идентификатор заказа SBC.

$!{MERCHANT_ORDER_ID}

Идентификатор заказа, назначенный этому заказу Присоединяющейся стороной.

$!{RRN}

Регистрационный номер банка-получателя.

$!{AUTH_CODE}

Authorization Code.

$!{AUTH_RESPONSE_CODE}

Двух- либо шестизначный буквенно-цифровой код, предоставляемый эмитентом, который указывает ответ авторизации (одобрение или отказ).

$!{STATUS}

Order статус.

$!{SKIN_VERSION}

Описание: CSS skin version.

$!{BIN}

Банковский BIN кредитной карты клиента.

$!{LAST_FOUR_DIGITS}

Последние четыре цифры карты.

$!{CARD_TYPE}

Описание: Card type.

$!{CARDHOLDER_NAME}

Карта holder название.

$!{DESTINATION_BIN}

BIN банка номера кредитной карты получателя.

$!{DESTINATION_LAST_FOUR_DIGITS}

Последние четыре цифры карты получателя.

$!{DESTINATION_CARD_TYPE}

Тип карты получателя.

$!{PAYNET_PROCESSING_DATE}

Дата обработки SBC.

$!{ACQUIRER_PROCESSING_DATE}

Дата обработки банком-эквайером.

$!{READER_PROCESSING_DATE}

Дата обработки терминала считывателя.

$!{TERMINAL_ID}

Terminal ID.

$!{EMV_ISSUER_RESPONSE}

Код ответа на запрос авторизации, отправленный эмитентом.

$!{EMV_TERMINAL_AID_9F06}

Идентификатор приложения терминала. Идентифицирует приложение, как описано в ISO/IEC 7816-5.

$!{EMV_TVR_95}

Результаты проверки терминала. Статус различных функций с точки зрения терминала.

$!{EVM_CID_9F27}

Cryptogram Information Data. Указывает тип криптограммы и действия, которые должен выполнить терминал.

$!{EMV_APP_LABEL_50}

Метка приложения. Мнемоника, связанная с AID согласно ISO/IEC 7816-5.

$!{EMV_CVR_9F34}

Результаты метода проверки держателя карты (CVM). Указывает результаты последней выполненной CVM.

$!{EMV_APP_CRYPTOGRAM_9f26}

Криптограмма приложения. Криптограмма, возвращаемая ICC в ответ на команду GENERATE AC.

$!{EMV_PAN_SEQUENCE_5f34}

Application Primary Account Number (PAN) Sequence Number. Идентифицирует и различает карты с одинаковым PAN.

$!{PIN_OR_SIGNATURE}

Запрашивать PIN или только иметь подпись.

$!{READER_ENTRY_MODE}

Конфигурация аутентификации клиента в терминале.

$!{HAS_SIGNATURE}

Наличие подписи (TRUE или FALSE).

$!{RECEIPT_ID}

Receipt ID.

$!{RECEIPT_URL}

URI текущей квитанции.

$!{FUNCTIONS}

Библиотека функций для работы со строками.

Пример шаблона квитанции

<!DOCTYPE html>
<html>
    <body style="font-family:'tahoma';color:#1A407D;">
        <div style="font-family:'tahoma';max-width:640px;margin:auto;margin-top:20px;text-align: center;background-color:#F5F6F6;padding:20px;border-top:6px solid #1A407D;border-radius:42px;border-right:1px solid #E7E7E7;border-left:1px solid #E7E7E7;border-bottom:1px solid #E7E7E7;direction:ltr;">
        <h1 style="font-weight:900;color:#7D1A40;">
            $!AMOUNT $!CURRENCY Paid
        </h1>
        <p style="font-family:'tahoma';color:#1A407D;font-weight:700;font-size:17px;line-height:20px;">
            Hi $!CARDHOLDER_NAME,
            <br>
            Thank you for your payment through SBC!
            <br>
            Here are your transaction details:
        </p>
        <p style="font-family:'tahoma';color:#1A407D;text-align: left;margin-top:70px;margin-bottom:70px;">
            $!CARDHOLDER_NAME
            <br>
            Transaction # : $!PAYNET_ORDER_ID
            <br>
            Paid with $!CARD_TYPE ending with $!LAST_FOUR_DIGITS
            <br>
            $!DATE
        </p>
        <p style="font-family:'tahoma';color:#1A407D;text-align: left;">
            The transaction will appear on your credit card statement as nymeria.
        </p>
        <div style="height: 2px;background-color:#E7E7E7;margin-top:32px;margin-bottom:32px;"></div>
            <br>
            <a style="font-family:'tahoma';color:#1A407D;" href="https://site.company_server/"><span>gate.sbctech.ru</span></a>
            <span style="font-family:'tahoma';color:#1A407D;margin-right:16px;margin-left:16px;">Support@gate.sbctech.ru</span>
        </div>
    </body>
</html>

Описание: Message template

Сообщения можно отправлять клиенту в виде обычного текста, SMS или HTML.
Сервер сообщений должен быть указан на уровне проекта или конечной точки.

Макросы шаблона сообщения

Макрос имени поля

Описание

$!{CARDHOLDER_VALUE}

Карта printed название.

$!{CARDHOLDER_EMAIL}

Электронная почта держателя карты, переданная во входящем API-запросе.

$!{CARDHOLDER_PHONE}

Номер телефона держателя карты, переданный во входящем API-запросе.

$!{CUSTOMER_FULL_NAME}

Полное имя клиента, отправленное Присоединяющейся стороной через входные параметры.

$!{CUSTOMER_FIRST_NAME}

Имя клиента, отправленное Присоединяющейся стороной через входные параметры.

$!{CUSTOMER_LAST_NAME}

Фамилия клиента, отправленная Присоединяющейся стороной через входные параметры.

$!{CUSTOMER_COUNTRY_NAME}

Название страны клиента, переданное во входящем API-запросе.

$!{CUSTOMER_COUNTRY_CODE}

Страна выставления счёта клиента, переданная во входящем API-запросе. Например: IL, RU и т. д.

$!{CUSTOMER_STATE_NAME}

Название региона клиента, переданное присоединяющейся стороной через входные параметры, если таковые есть в стране клиента.

$!{CUSTOMER_STATE_CODE}

Код региона клиента, переданный присоединяющейся стороной через входные параметры, если таковые есть в стране клиента.

$!{CUSTOMER_CITY}

Название города клиента, переданное во входящем API-запросе.

$!{CUSTOMER_ZIP_CODE}

Описание: Customer’s ZIP code.

$!{CUSTOMER_ADDRESS1}

Адрес клиента, переданный во входящем API-запросе.

$!{CUSTOMER_ADDRESS2}

Адрес клиента, переданный во входящем API-запросе, если требовался дополнительный адрес.

$!{AMOUNT}

Сумма.

$!{GATEDESCRIPTOR}

Дескриптор шлюза, указанный в платёжном шлюзе.

$!{ORDERDESCRIPTION}

Описание заказа.

$!{CURRENCY}

Валюта, в которой списывается транзакция (трёхбуквенный код валюты).

$!{CARD_NUMBER}

Описание: 6 + 4 masked card number

$!{BIN}

Банковский BIN кредитной карты клиента.

$!{LAST_FOUR_DIGITS}

Последние четыре цифры карты.

$!{CARD_TYPE}

Описание: Card type.

$!{PAYNET_ORDER_ID}

Идентификатор заказа SBC.

$!{MERCHANT_ORDER_ID}

Идентификатор заказа, назначенный этому заказу Присоединяющейся стороной.

$!{CREATED_DATE}

Дата создания транзакции в SBC.

$!{CREATED_YEAR}

Год создания транзакции в SBC

$!{CREATED_MONTH}

Месяц создания транзакции в SBC

$!{CREATED_DAY}

День создания транзакции в SBC

$!{MERCHANT}

End point display название.

$!{MERCHANT_NAME}

Отображаемое имя Присоединяющейся стороны.

$!{MERCHANT_EMAIL}

Электронная почта Присоединяющейся стороны.

$!{ENDPOINT_ID}

Описание: End point ID.

$!{PAYMENT_FORM_NAME}

Название на платёжной форме в конечной точке.

$!{RRN}

Регистрационный номер банка-получателя.

$!{APPROVAL_CODE}

Код проверки, необходимый для авторизации платежа

$!{AUTH_RESPONSE_CODE}

Двух- либо шестизначный буквенно-цифровой код, предоставляемый эмитентом, который указывает ответ авторизации (одобрение или отказ).

$!{STATUS}

Описание: Status of the order.

$!{PAYNET_PROCESSING_DATE}

Дата обработки SBC (год, месяц, день и время в часовом поясе МСК).

$!{ACQUIRER_PROCESSING_DATE}

Дата обработки банком-эквайером (год, месяц, день и время в часовом поясе МСК).

$!{READER_PROCESSING_DATE}

Дата обработки терминала считывателя (год, месяц, день и время в часовом поясе МСК).

$!{TERMINAL_ID}

Terminal ID.

$!{EMV_ISSUER_RESPONSE}

Код ответа на запрос авторизации, отправленный эмитентом.

$!{EMV_TVR_95}

Результаты проверки терминала. Статус различных функций с точки зрения терминала.

$!{EVM_CID_9F27}

Cryptogram Information Data. Указывает тип криптограммы и действия, которые должен выполнить терминал.

$!{EMV_APP_LABEL_50}

Метка приложения. Мнемоника, связанная с AID согласно ISO/IEC 7816-5.

$!{EMV_CVR_9F34}

Результаты метода проверки держателя карты (CVM). Указывает результаты последней выполненной CVM.

$!{EMV_APP_CRYPTOGRAM_9f26}

Криптограмма приложения. Криптограмма, возвращаемая ICC в ответ на команду GENERATE AC.

$!{EMV_PAN_SEQUENCE_5f34}

Application Primary Account Number (PAN) Sequence Number. Идентифицирует и различает карты с одинаковым PAN.

$!{PIN_OR_SIGNATURE}

Запрашивать PIN или только иметь подпись.

$!{READER_ENTRY_MODE}

Конфигурация аутентификации клиента в терминале.

$!{HAS_SIGNATURE}

Наличие подписи (TRUE или FALSE).

$!{RECEIPT_ID}

Receipt ID.

$!{RECEIPT_URI}

URN текущей квитанции (/view-receipt/ENDPOINT-ID/RECEIPT-ID).

$!{PURPOSE}

Любая дополнительная информация, отправленная Присоединяющейся стороной.

$!{MERCHANT_DATA}

Любая дополнительная информация по данной транзакции, которая может быть полезна во внешних системах Присоединяющейся стороны.

$!{ENDPOINT_SEQUENCE_VALUE}

Используется при наличии последовательности конечных точек, увеличивающейся на единицу в числовом формате.

Примеры шаблона сообщения

Пример шаблона обычного текста и SMS:
$!{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-шаблона:
<!DOCTYPE html>
<html>
    <body style="font-family:'tahoma';color:#1A407D;">
        <div style="font-family:'tahoma';max-width:640px;margin:auto;margin-top:20px;text-align: center;background-color:#F5F6F6;padding:20px;border-top:6px solid #1A407D;border-radius:42px;border-right:1px solid #E7E7E7;border-left:1px solid #E7E7E7;border-bottom:1px solid #E7E7E7;direction:ltr;">
        <h1 style="font-weight:900;color:#7D1A40;">
            $!AMOUNT $!CURRENCY Paid
        </h1>
        <p style="font-family:'tahoma';color:#1A407D;font-weight:700;font-size:17px;line-height:20px;">
            Hi $!CARDHOLDER_VALUE,
            <br>
            Thank you for your payment through SBC!
            <br>
            Here are your transaction details:
        </p>
        <p style="font-family:'tahoma';color:#1A407D;text-align: left;margin-top:70px;margin-bottom:70px;">
            $!CARDHOLDER_VALUE
            <br>
            Transaction # : $!PAYNET_ORDER_ID
            <br>
            Paid with $!CARD_TYPE ending with $!LAST_FOUR_DIGITS
            <br>
            $!CREATED_DATE
        </p>
        <p style="font-family:'tahoma';color:#1A407D;text-align: left;">
            The transaction will appear on your credit card statement as nymeria.
        </p>
        <div style="height: 2px;background-color:#E7E7E7;margin-top:32px;margin-bottom:32px;"></div>
            <br>
            <a style="font-family:'tahoma';color:#1A407D;" href="https://site.company_server/"><span>gate.sbctech.ru</span></a>
            <span style="font-family:'tahoma';color:#1A407D;margin-right:16px;margin-left:16px;">Support@gate.sbctech.ru</span>
        </div>
    </body>
</html>